Project Discovery - melhorias-modularizar-src-main-rs-por-dominio-commands-clients-commands-workflow-co-3557c07ccfa4

Tipo cli/app

Classificação operacional do projeto.

Lifecycle brownfield

Sinal de greenfield/brownfield para calibrar risco.

Stack 2

Tecnologias ou contextos detectados.

Riscos 1

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

Código
2
Testes
1
Docs
2
Migrations
0
Infra
1
Config
2
SDD
3

## Comandos Derivados

Install
0
Lint
1
Typecheck
1
Testes
1
Build
1
Pendentes
4
Ausentes
0

## Paths Observados

Categoria | Paths
--- | ---
Código fonte | `src` `plugins`
Testes | `tests`
Docs | `docs` `README.md`
Migrations | não encontrado no inventário
Infra/deploy | `.github/workflows`
Configurações | `sdd.config.yaml` `Cargo.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 . --json` `codegraph query "<symbol>" --path . --json` `codegraph context "<task>" --path . --format markdown` `git 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 status` `lexa files` `lexa 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