Ir para o conteúdo

Code New Project Agents

O time Code New Project Agents é a contraparte greenfield do time de Descoberta. Enquanto o Discovery responde o que o legado existente faz?, o time de Projeto Novo responde o que vamos construir do zero e quais specs comprovam isso?.

O pipeline parte de uma ideia em uma linha e chega a um conjunto completo de specs SDD, prontas para entrar no ciclo dos Code Forward Agents.

Pré-marcado no instalador.

Quando usar

Você tem uma ideia, mas ainda não tem código. Pode ser uma frase ("quero que o usuário exporte faturas em PDF"), pode ser um parágrafo. Você quer pensar o produto antes de abrir a IDE: validar o problema, desenhar as personas, escrever um PRD e quebrar o PRD em specs SDD que um agente de IA consiga implementar.

Ative com:

/reversa-new

O /reversa-new tem dois modos de execução:

  • Guiado (padrão): o orquestrador coleta o brief, conduz os quatro agentes funcionais em ordem fixa, salva checkpoint entre cada um e pede CONTINUAR antes de avançar. Termina nas specs SDD, com handoff para /reversa-forward.
  • Expresso: ative com /reversa-new expresso "<sua ideia>" ou escolha no menu inicial. Todas as perguntas são concentradas em uma entrevista única no início; depois do INICIAR, o pipeline roda sem paradas e, ao concluir as specs, emenda automaticamente no ciclo forward (requirements → plan → to-do → coding) até o código implementado. Dúvidas que surgirem no caminho são registradas com selo 🟡 para revisão posterior, sem interromper o fluxo.

Se a sessão for interrompida, em qualquer modo, basta digitar /reversa-new de novo: ele lê state.json#newproject_progress e retoma exatamente de onde parou, respeitando o modo salvo.

Pipeline

/reversa-new              (orquestrador)
       │
       ▼
/reversa-ideator          → _reversa_sdd/ideation.md
       │
       ▼ CONTINUAR
/reversa-researcher       → _reversa_sdd/personas.md
       │
       ▼ CONTINUAR
/reversa-drafter          → _reversa_sdd/prd.md
       │
       ▼ CONTINUAR
/reversa-spec-sdd         → _reversa_sdd/sdd/<componente>.md
       │
       ├── guiado: handoff, sugere /reversa-forward
       │
       ▼ expresso: continua sem parar
/reversa-requirements → /reversa-plan → /reversa-to-do → /reversa-coding
       │
       ▼
código implementado em _reversa_forward/<NNN>-<feature>/

No modo expresso as pausas CONTINUAR do diagrama não existem: a única confirmação é o INICIAR da entrevista inicial.

O agente Spec SDD é uma versão vendored da skill global sdd-spec, adaptada para viver dentro do Reversa: lê prd.md, escreve em _reversa_sdd/sdd/, marca cada artefato com selo 🟡 (planejado) e, ao concluir, faz handoff para o pipeline Forward.

Onde os artefatos ficam

O time escreve apenas dentro de _reversa_sdd/ (a mesma pasta usada pelo Discovery). Specs greenfield convivem com specs de legado sem conflito porque os nomes dos arquivos são distintos.

<seu-projeto>/
└── _reversa_sdd/
    ├── newproject-brief.md      (orquestrador)
    ├── ideation.md              (Ideator)
    ├── personas.md              (Researcher)
    ├── prd.md                   (Drafter)
    └── sdd/
        └── <componente>.md      (Spec SDD)

O estado do orquestrador fica em .reversa/state.json sob a chave newproject_progress, com mode (guiado ou expresso), stage, started_at, last_checkpoint_at, completed_stages e o brief truncado. No modo expresso, stage também percorre os estágios forward-requirements, forward-plan, forward-todo e forward-coding, e a feature gerada vive em _reversa_forward/.

Re-execução

Quando o pipeline já está em andamento e você digita /reversa-new de novo, o orquestrador detecta o stage salvo e oferece quatro opções:

  1. Continuar de onde parou (recomendado)
  2. Recriar tudo do zero (sobrescreve artefatos, exige confirmação explícita)
  3. Re-executar a partir de um agente específico (submenu com os quatro agentes)
  4. Cancelar

O orquestrador nunca decide sozinho: toda sobrescrita exige sim explícito.

Próximos passos