nanoclaw · AI Dev Team — Índice de Prompts

Todos os prompts usados pelo orchestrator (src/dev-team-orchestrator.ts), em ordem lógica de execução.

Variáveis em {{duplas chaves}} são substituídas em runtime pelo TypeScript.

---

⚙️ Setup (uma vez por instalação)

#	Prompt	Descrição
01	setup-forks-senior	Cria o fork do upstream no GitHub do agente senior (Carlos). Confirma a URL do fork.
02	setup-forks-junior	Cria o fork do upstream no GitHub do agente junior (Ana). Confirma a URL do fork.

---

📋 Sprint Planning (IDLE → PLANNING → DEBATE → TASKING)

#	Prompt	Descrição
03	start-new-sprint	Orchestrator cria a issue de planejamento do sprint no Linear (Sprint #N Planning) e retorna o identificador (ISSUE_ID=FAB-N).
04	start-debate-senior	Carlos abre o debate propondo 2–3 features para o sprint, postando no Linear como comentário da issue de planejamento.
05	continue-debate-senior	Carlos responde em rounds ímpares do debate (rounds 3, 5…). Pode encerrar com CONSENSUS_REACHED.
06	continue-debate-junior	Ana responde em rounds pares do debate (rounds 2, 4…). Não pode declarar consenso — só o senior ou PM podem.
07	consensus-check	Orchestrator lê os comentários da issue e decide se o time chegou a consenso (CONSENSUS=true/false). Executado após cada round de debate.

---

🧑‍💻 Tasking & Dev (TASKING → DEV)

#	Prompt	Descrição
08	start-dev-tasking	Orchestrator lê o debate, cria 2–4 issues de tarefa no Linear (status Todo), e retorna linhas TASK|FAB-N|senior|branch-name.
09	check-dev-progress-implement	Dev agent (senior ou junior) marca a issue como In Progress, implementa a feature, abre PR no upstream e retorna PR_CREATED=N. O orchestrator valida o PR no upstream antes de aceitar.

---

🔍 Review (REVIEW → AUTHOR_FIXES → REVIEW)

#	Prompt	Descrição
10	process-review	Cross-review: o agente oposto lê o diff e posta review no GitHub. Aprovação ou request-changes determinado por probabilidade crescente por round (20% / 70% / 100%).
11	author-fix-task	Autor do PR lê o feedback, push correções na mesma branch e confirma com FIXES_PUSHED=true. Devolve ao estado REVIEW para nova rodada.

---

🔀 Merge (MERGE → COMPLETE)

#	Prompt	Descrição
12	process-merge-conflict-rebase	Quando um PR tem conflitos, o autor faz rebase e force-push. O merge em si é feito pelo host via execSync gh pr merge — não pelo agente.
13	process-merge-linear-update	Após merge bem-sucedido (host-side), orchestrator marca as issues mergeadas como Done no Linear e posta comentário de resumo na issue de planejamento. Fire-and-forget.

---

🏁 Finalização do Sprint (COMPLETE → IDLE)

#	Prompt	Descrição
14	finish-sprint	Orchestrator marca todas as tasks como Done, posta o resumo final na issue de planejamento e marca ela também como Done. Sprint arquivado em data/dev-team/sprint-history/.

---

Fluxo completo

IDLE
 └─ start-new-sprint (03) ──────────────────────────────── PLANNING
     └─ start-debate-senior (04) ────────────────────────── DEBATE
         └─ [loop] continue-debate (05/06) + consensus-check (07)
             └─ CONSENSUS=true ────────────────────────── TASKING
                 └─ start-dev-tasking (08) ────────────── DEV
                     └─ [loop] check-dev-progress-implement (09)
                         └─ PR_CREATED=N ──────────────── REVIEW
                             └─ [loop] process-review (10)
                                 ├─ changes_requested → author-fix-task (11) → REVIEW
                                 └─ approved (todos) ──── MERGE
                                     ├─ conflitos → process-merge-conflict-rebase (12)
                                     ├─ merge (host execSync) → process-merge-linear-update (13)
                                     └─ todos merged ──── COMPLETE
                                         └─ finish-sprint (14) ──── IDLE