Classificação operacional do projeto.
Sinal de greenfield/brownfield para calibrar risco.
Tecnologias ou contextos detectados.
Riscos recorrentes que pedem evidência ou checkpoint.
Rastreabilidade
Estado: draft. Provider: codex. Modelo: gpt-5.5. Effort: xhigh. Offline: true.
Tokens: input ~196 · output ~3919 · total ~4115. Tokens source: estimated.
Tempo de geração: 2026-07-04T07:13:54.525Z -> 2026-07-04T07:13:54.597Z (~72 ms). Tempo source: local.
Entrada: Melhorias
- Modularizar src/main.rs por domínio: commands/clients, commands/workflow, commands/providers, commands/package, commands/ci, commands/artifacts.
- Separar o TUI em camadas mais finas: estado, adapters de provider, rendering, execução, persistência e telemetria.
- Adicionar timeouts/retries/rate-limit handling para Jira/GitHub e testes com mock server.
- Evoluir precisão com golden tests de artefatos SDD, corpus de PRD/Tech Spec/Tasks, property tests para slug/rastreabilidade e avaliação semântica determinística.
- Tornar checks opcionais visíveis em CI: cargo audit, cargo deny, gitleaks, npm audit e SBOM, nem que inicialmente em modo advisory.
- Criar um sdd maintenance report por área: core Rust, docs, clients, bot, providers, intelligence, workflows, release.
Stack Utilizada
infra
rust
Root: /Users/allan.oliveira/Documents/code/personal/sdd-layer
Arquitetura Inferida
Confiança: alta: manifests, entrypoints e componentes foram encontrados
- Entrypoints reais detectados: `src/main.rs` (rust-bin).
- Aplicação Rust com binário em `src/main.rs`; contratos e comandos derivam de `Cargo.toml`.
- Contratos de dados presentes; mudanças em persistência precisam de plano de migração, compatibilidade e rollback.
- Artefatos SDD detectados em docs, .sdd/intelligence, .sdd/memory; usar traceability map como fonte local de contexto aprovado.
Entrypoints
| Path | Tipo | Papel | Evidência |
|---|---|---|---|
src/main.rs | rust-bin | Binário principal Rust | path `src/main.rs` existe |
Camadas e boundaries
| Path | Tipo | Papel | Evidência |
|---|---|---|---|
src/domain | domain | Domínio isolado | path `src/domain` existe |
src/runtime | runtime | Runtime/plataforma | path `src/runtime` existe |
src/tui | presentation | Apresentação TUI | path `src/tui` existe |
src/main.rs | composition-root | CLI/composição principal | path `src/main.rs` existe |
schemas | contracts | Contratos versionados | path `schemas` existe |
templates | artifact-templates | Templates de artefatos | path `templates` existe |
bot/src | integration | Integração externa/bot | path `bot/src` existe |
tests | verification | Testes automatizados | path `tests` existe |
Rotas e comandos
| Path | Tipo | Papel | Evidência |
|---|---|---|---|
src/main.rs | cli-router | Despacho de comandos CLI | path `src/main.rs` existe |
.claude/commands | agent-commands | Comandos Claude | path `.claude/commands` existe |
.opencode/commands | agent-commands | Comandos OpenCode | path `.opencode/commands` existe |
.trae/commands | agent-commands | Comandos Trae | path `.trae/commands` existe |
manifest | clap | Roteamento de CLI via Clap | dependência `clap` detectada |
Manifests e Dependências
| Manifest | Tipo | Nome | Gerenciador | Sinais | Scripts |
|---|---|---|---|---|---|
Cargo.toml | rust | sdd-layer | cargo | binário Rust, TUI Ratatui, CLI Clap, serialização Serde |
Fluxo SDD Recomendado
Cobertura do Inventário
Comandos Derivados
Paths Observados
| Categoria | Paths |
|---|---|
| Código fonte | srcplugins |
| Testes | tests |
| Docs | docsREADME.md |
| Migrations | não encontrado no inventário |
| Infra/deploy | .github/workflows |
| Configurações | sdd.config.yamlCargo.toml |
| Artefatos SDD | docs.sdd/intelligence.sdd/memory |
Comandos
| Grupo | Comandos |
|---|---|
| Instalação | ausente |
| Lint | cargo clippy --all-targets --all-features -- -D warnings |
| Typecheck | cargo check |
| Testes | cargo test |
| Build | cargo build --release |
| Não verificados | cargo clippy --all-targets --all-features -- -D warnings (derivado, não executado)cargo check (derivado, não executado)cargo test (derivado, não executado)cargo build --release (derivado, não executado) |
| Ausentes | ausente |
Qualidade
Frameworks
- cargo test
- go test
Testes
- tests
Comandos
- cargo clippy --all-targets --all-features -- -D warnings
- cargo check
- cargo test
- cargo build --release
Gaps
- coverage não encontrado; tratar como não verificado
Operação
CI
- .github/workflows
Deploy
não encontrado no inventário
Env vars
não encontrado no inventário
Observabilidade
não encontrado no inventário
Dados e Contratos
Migrations
não encontrado no inventário
Schemas
- schemas
API
não encontrado no inventário
ORM
não encontrado no inventário
Integrações
Serviços
- OpenAI
- Anthropic
- GitHub
Auth
- API keys
- Tokens
Webhooks
não encontrado no inventário
Storage
- SQLite
Code Intelligence
| Ferramenta | Status | Comandos sugeridos | Fallback |
|---|---|---|---|
codegraph | available=true · indexed=true · marker=.codegraph/ | codegraph sync .codegraph status .codegraph files --path . --jsoncodegraph query "<symbol>" --path . --jsoncodegraph context "<task>" --path . --format markdowngit diff --name-only | codegraph affected --path . --stdin --quiet | Use `rg --files`, `rg`, leitura focada e testes afetados derivados dos manifests. |
lexa | available=false · indexed=false · marker=.lexa/graph.lexa | lexa statuslexa fileslexa brief "<task>"lexa audit | Use `rg --files`, `rg`, outlines manuais por arquivo e Context Pack SDD. |
Riscos e Checkpoints
- infra/deploy: exigir checkpoint antes de mudanças operacionais
Capability Map
| Capability | Fonte | Stages | Skill local | Risco |
|---|---|---|---|---|
| Code intelligence opcional | SDD + CodeGraph + Lexa https://github.com/colbymchenry/codegraph, https://github.com/anvia-hq/lexa | project-discovery, techspec, execution, review | .agents/skills/code-intelligence/SKILL.md | Índice pode estar ausente ou obsoleto; verificar status antes de confiar. |
| Execução disciplinada | Superpowers + Matt Pocock Skills https://github.com/obra/superpowers/tree/main/skills, https://github.com/mattpocock/skills | execution, review | .agents/skills/execution-discipline/SKILL.md | Pode virar ritual sem evidência; exigir teste/loop/verificação específicos. |
| Linguagem de domínio e ADRs leves | Matt Pocock Skills https://github.com/mattpocock/skills | idea, prd, techspec, execution, memory | .agents/skills/domain-language/SKILL.md | Não transformar glossário em spec nem criar ADR para decisão trivial. |
| Deepening arquitetural | Matt Pocock Skills https://github.com/mattpocock/skills | project-discovery, techspec, refinement, review | .agents/skills/architecture-deepening/SKILL.md | Não refatorar automaticamente; propor candidatos e exigir checkpoint. |
Rastreabilidade
Estado: draft · Provider: codex · Modelo: gpt-5.5 · Effort: xhigh · Offline: true
Entrada: Melhorias - Modularizar src/main.rs por domínio: commands/clients, commands/workflow, commands/providers, commands/package, commands/ci, commands/artifacts. - Separar o TUI em camadas mais finas: estado, adapters de provider, rendering, execução, persistência e telemetria. - Adicionar timeouts/retries/rate-limit handling para Jira/GitHub e testes com mock server. - Evoluir precisão com golden tests de artefatos SDD, corpus de PRD/Tech Spec/Tasks, property tests para slug/rastreabilidade e avaliação semântica determinística. - Tornar checks opcionais visíveis em CI: cargo audit, cargo deny, gitleaks, npm audit e SBOM, nem que inicialmente em modo advisory. - Criar um sdd maintenance report por área: core Rust, docs, clients, bot, providers, intelligence, workflows, release.
Artefato Markdown pareado: 00-project-discovery.md