# Memória Operacional - Criar um CLI poderoso e eficaz similar ao opencode, com uma interface de TUI e loaders dinamicos e iterações no terminal, conseguimos? quando não for dentro do editor/agent

## Estado final
- Memória operacional gerada de forma determinística a partir dos artefatos locais existentes.
- O índice de intelligence deve ser reconstruído após alterações nos artefatos canônicos.

## Funcionalidades implementadas
- Risk Classification: Risk Classification - Criar um CLI poderoso e eficaz similar ao opencode, com uma interface de TUI e loaders dinamicos e iterações no terminal, conseguimos? quando não for dentro do editor/agent (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
- Idea: Ideia — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- PRD: PRD — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- Tech Spec: Tech Spec — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/03-techspec.md`)
- Tasks: Tasks — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/04-tasks.md`)
- Refinement: Refinement — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/05-refinement.md`)
- Execution: Execution — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/06-execution.md`)
- ADR: ADR — TUI determinística do `sdd` (SDD CLI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/06-adr.md`)
- Review: Review — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/07-review.md`)

## Arquitetura atual
- O `sdd` hoje opera exclusivamente como harness determinístico invocado por agentes externos (Claude Code, Codex, opencode, Cursor). Toda a inteligência do fluxo reside no agente externo. Quem usa o terminal diretamente não tem como interagi
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Artefatos em `docs/<slug>/` não têm forma interativa de serem visualizados ou aprovados no terminal. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Diferenciais frente a opencode/Charm:** não é chat genérico — é fluxo estruturado e opinionado; cada "tela" é uma etapa SDD rastreável; integra com o artifact store local (`docs/<slug>/`) e o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Artefatos aprovados são gravados em `docs/<slug>/` e refletidos no `traceability-map.yaml` automaticamente, idênticos em contrato aos gerados pelo harness. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Aprovação (checkpoint): salva em `docs/<slug>/01-idea.md` e atualiza o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Subagents de IA não existem fora do agente externo: Alto: O fluxo depende de subagents em `.claude/agents/` que só rodam no Claude Code. A TUI precisaria replicar esses prompts no binário ou orquestrar chamadas diretas ao provider — mudança
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Modelo de execução da IA na TUI** — chamar provider direto (HTTP + prompt embarcado) ou delegar a um processo `claude`/`opencode` local? Define toda a arquitetura. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- O SDD CLI (TUI) é um modo interativo do binário `sdd` que transforma o terminal em um cockpit determinístico para conduzir o fluxo Spec-Driven completo, de ponta a ponta, sem depender de nenhum agente ou editor externo. A TUI orquestra etap
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)

## Decisões
- **Modelo de execução da IA na TUI** — chamar provider direto (HTTP + prompt embarcado) ou delegar a um processo `claude`/`opencode` local? Define toda a arquitetura. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Prompts dos subagents** — duplicados no binário? Como sincronizar com `.claude/agents/*.md`? (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Provider no MVP** — só o de `sdd.config.yaml` ou seletor mínimo? (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **TUI substitui ou complementa o harness?** (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Critério de qualidade do artefato gerado sem agente.** (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Autenticação com o provider** — variável de ambiente ou fluxo interativo? (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Edição de artefatos** — `$EDITOR` externo ou só aprovar/regenerar? (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- --- (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **NO-1:** A TUI **não embarca IA**, não chama providers por HTTP e não replica prompts dos subagents. Geração de conteúdo é delegada ao scaffolding `sdd` ou a agente externo. Decisão travada. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- R-02: Deps novas (ratatui/crossterm/tokio): Médio: Tech Spec decide se tokio é necessário (subcomandos são processos síncronos); medir binário com `cargo bloat` (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- Decisões travadas reafirmadas: (1) zero IA/HTTP — geração via subprocessos `sdd` + `$EDITOR`; (2) MVP cobre o fluxo guiado completo; (3) entrada exclusiva `sdd tui` (o `sdd` sem subcomando continua exibindo a ajuda do clap, sem alteração);
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/03-techspec.md`)
- Decisão threads vs tokio: **não usar tokio**. O único bloqueio real é a espera de processos filhos; worker `std::thread` + `mpsc` resolve com custo mínimo de binário e zero runtime assíncrono (RNF-04). O spinner é animado pelo tick do `poll
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/03-techspec.md`)

## Falhas recorrentes
- Nível: medium (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
- external_dependency (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
- Definir no checkpoint conforme o nível de risco. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
- O `sdd` hoje opera exclusivamente como harness determinístico invocado por agentes externos (Claude Code, Codex, opencode, Cursor). Toda a inteligência do fluxo reside no agente externo. Quem usa o terminal diretamente não tem como interagi
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Problemas concretos:** (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Nenhum feedback visual durante etapas longas (sem loader, sem progresso, sem streaming). (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Impossível navegar entre etapas com contexto (o usuário precisa lembrar manualmente em que etapa está e o que já foi aprovado). (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Checkpoints humanos são invisíveis na CLI atual — o fluxo para ou avança sem sinalização clara. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Artefatos em `docs/<slug>/` não têm forma interativa de serem visualizados ou aprovados no terminal. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- O `sdd` não tem modo de operação sem agente externo: não chama providers de IA por conta própria nem exibe output em streaming. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- --- (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Criar uma experiência **standalone e interativa no terminal**: uma TUI (Terminal User Interface) com loaders dinâmicos, navegação por etapas e iteração ao vivo, que permita conduzir o fluxo SDD diretamente pelo terminal, sem depender de Cla
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)

## Comandos confiáveis
- SDD CLI (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
- # Ideia — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- O `sdd` hoje opera exclusivamente como harness determinístico invocado por agentes externos (Claude Code, Codex, opencode, Cursor). Toda a inteligência do fluxo reside no agente externo. Quem usa o terminal diretamente não tem como interagi
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Criar uma experiência **standalone e interativa no terminal**: uma TUI (Terminal User Interface) com loaders dinâmicos, navegação por etapas e iteração ao vivo, que permita conduzir o fluxo SDD diretamente pelo terminal, sem depender de Cla
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Proposta de valor:** para o engenheiro no terminal, o SDD CLI (TUI) é a primeira forma de conduzir o fluxo Spec-Driven completo (Ideia → Memória) sem agente/editor externo, com feedback visual ao vivo, navegação guiada e checkpoints como
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Diferenciais frente a opencode/Charm:** não é chat genérico — é fluxo estruturado e opinionado; cada "tela" é uma etapa SDD rastreável; integra com o artifact store local (`docs/<slug>/`) e o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Persona secundária — Dev em projetos pessoais/OSS:** não tem licença de Claude Code ou não quer depender de agente pago; quer explorar o fluxo SDD interativamente. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- `sdd tui` (ou `sdd` sem subcomando) dentro de um projeto com `.sdd/` instalado. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Comando `sdd tui`: Ponto de entrada; carrega a TUI no terminal (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- # PRD — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- O SDD CLI (TUI) é um modo interativo do binário `sdd` que transforma o terminal em um cockpit determinístico para conduzir o fluxo Spec-Driven completo, de ponta a ponta, sem depender de nenhum agente ou editor externo. A TUI orquestra etap
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- O produto é voltado ao engenheiro que trabalha diretamente no terminal — seja por preferência, por ambiente sem GUI, por não ter licença de Claude Code, ou por querer conduzir revisões e aprovações do fluxo SDD sem sair do shell. A geração
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)

## Padrões úteis
- **Diferenciais frente a opencode/Charm:** não é chat genérico — é fluxo estruturado e opinionado; cada "tela" é uma etapa SDD rastreável; integra com o artifact store local (`docs/<slug>/`) e o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Artefatos aprovados são gravados em `docs/<slug>/` e refletidos no `traceability-map.yaml` automaticamente, idênticos em contrato aos gerados pelo harness. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Aprovação (checkpoint): salva em `docs/<slug>/01-idea.md` e atualiza o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Salvamento automático: Grava o artefato e atualiza o `traceability-map.yaml` (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- **Demanda:** devs que usam `sdd` querem experiência standalone sem Claude Code (não validado). (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- Estado no traceability-map: `idea: pending` (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
- O SDD CLI (TUI) é um modo interativo do binário `sdd` que transforma o terminal em um cockpit determinístico para conduzir o fluxo Spec-Driven completo, de ponta a ponta, sem depender de nenhum agente ou editor externo. A TUI orquestra etap
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- **OBJ-6:** Persistir artefatos aprovados em `docs/<slug>/` e atualizar `traceability-map.yaml` com contrato idêntico ao harness. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- **RF-02 — Tela de orquestrações.** Lista orquestrações de `docs/` com nome, slug, estado e etapa corrente. **RN-02:** estado lido do `traceability-map.yaml`; ausente → `unknown`. Ações: selecionar, criar nova, sair. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- **RF-04 — Navegação por etapas com estado.** Painel de progresso com todas as etapas e estado (pending/in_progress/approved/skipped). Navegação livre para etapas anteriores/aprovadas; etapas futuras não aprovadas bloqueadas. **RN-04:** esta
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- **RF-09 — Persistência de artefato aprovado.** Grava em `docs/<slug>/` (ex.: `02-prd.md`) e atualiza `state: approved` + `approved_at` (ISO-8601) no `traceability-map.yaml`. **RN-09:** schema e contrato idênticos ao harness. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
- Dado que existem diretórios em docs/ com traceability-map.yaml (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)

## Testes e comandos
- Comandos confiáveis para começar a validação:
  - SDD CLI (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md`)
  - # Ideia — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - O `sdd` hoje opera exclusivamente como harness determinístico invocado por agentes externos (Claude Code, Codex, opencode, Cursor). Toda a inteligência do fluxo reside no agente externo. Quem usa o terminal diretamente não tem como interagi
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - Criar uma experiência **standalone e interativa no terminal**: uma TUI (Terminal User Interface) com loaders dinâmicos, navegação por etapas e iteração ao vivo, que permita conduzir o fluxo SDD diretamente pelo terminal, sem depender de Cla
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - **Proposta de valor:** para o engenheiro no terminal, o SDD CLI (TUI) é a primeira forma de conduzir o fluxo Spec-Driven completo (Ideia → Memória) sem agente/editor externo, com feedback visual ao vivo, navegação guiada e checkpoints como
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - **Diferenciais frente a opencode/Charm:** não é chat genérico — é fluxo estruturado e opinionado; cada "tela" é uma etapa SDD rastreável; integra com o artifact store local (`docs/<slug>/`) e o `traceability-map.yaml`. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - **Persona secundária — Dev em projetos pessoais/OSS:** não tem licença de Claude Code ou não quer depender de agente pago; quer explorar o fluxo SDD interativamente. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - `sdd tui` (ou `sdd` sem subcomando) dentro de um projeto com `.sdd/` instalado. (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - Comando `sdd tui`: Ponto de entrada; carrega a TUI no terminal (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md`)
  - # PRD — SDD CLI (TUI) (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
  - O SDD CLI (TUI) é um modo interativo do binário `sdd` que transforma o terminal em um cockpit determinístico para conduzir o fluxo Spec-Driven completo, de ponta a ponta, sem depender de nenhum agente ou editor externo. A TUI orquestra etap
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)
  - O produto é voltado ao engenheiro que trabalha diretamente no terminal — seja por preferência, por ambiente sem GUI, por não ter licença de Claude Code, ou por querer conduzir revisões e aprovações do fluxo SDD sem sair do shell. A geração
...(truncado)
 (fonte: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md`)

## Pendências
- Revisar esta memória em checkpoint humano quando houver decisões de produto ou arquitetura que não aparecem nos artefatos atuais.

## Próximos passos
- Rodar `sdd intelligence learn --all` após qualquer alteração relevante neste diretório de artefatos.

## Contexto para o próximo agente
- Orquestração: `Criar um CLI poderoso e eficaz similar ao opencode, com uma interface de TUI e loaders dinamicos e iterações no terminal, conseguimos? quando não for dentro do editor/agent`
- Slug: `criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli`
- Gerado em: `2026-07-04T19:17:42Z`

## Rastreabilidade
- Origem local: `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/traceability-map.yaml`
- Artefatos lidos:
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/00-risk-classification.md` (risk)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/01-idea.md` (idea)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/02-prd.md` (prd)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/03-techspec.md` (techspec)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/04-tasks.md` (tasks)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/05-refinement.md` (refinement)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/06-execution.md` (execution)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/06-adr.md` (adr)
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/07-review.md` (review)
- Artefatos esperados para fechamento da memória:
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/06-adr.md`
  - `docs/criar-um-cli-poderoso-e-eficaz-similar-ao-opencode-com-uma-interface-de-tui-e-loaders-dinamicos-e-iteracoes-no-terminal-conseguimos-quando-nao-for-dentro-do-editor-agent-sdd-cli/07-review.md`
