---
title: Arquitetura
description: Mapa das camadas do repositório sdd-layer.
context: Visão de módulos, contratos e boundaries.
---

# Arquitetura

O repositório combina um CLI Rust, arquivos declarativos, superfícies de agents, plugin Codex, bot Node e documentação.

## Camadas

| Camada | Caminhos | Responsabilidade |
|---|---|---|
| CLI | `src/main.rs` | Parsing de comandos, instalação, artifact store e orquestração |
| Domínio | `src/domain/` | Discovery, evaluation, providers, risk, workflow e motor |
| Runtime | `src/runtime/` | MCP, trace, redaction, platform, slack e otimização |
| TUI | `src/tui/` | Cockpit terminal e execução de stages |
| Contratos | `schemas/`, `templates/`, `presets/`, `adapters/` | Configuração declarativa |
| Clients | `.claude/`, `.codex/`, `.cursor/`, `.devin/`, `.opencode/`, `.trae/`, `clients/` | Superfícies por ferramenta |
| Plugins | `plugins/orchestration/`, `plugins/design/` | Empacotamento repo-local |
| Bot | `bot/` | Slack/Jira/Bitbucket/LLM |
| Docs | `docs/`, `docs-site/` | Artefatos, manuais e site Fumadocs |

## Fluxo de dados

```text
Entrada do usuário
  -> client/agent/editor
  -> comando sdd
  -> domain/runtime
  -> artifact store + logs append-only
  -> eval/quality/report
  -> checkpoint humano
```

## Boundary principal

O CLI decide estado e validação. Clients e agents podem melhorar a experiência, mas não devem duplicar regras críticas que já existem no binário.
