[mathcolombo]

Empilhado sobre o #10 (log no terminal). Depois do merge do #10, o GitHub muda a base deste PR para main.

Resumo

Entrada pela issue. python -m orchestrator run --issue N substitui --flow/--cycle e os arquivos de pilot/demands/.

• A issue precisa estar aberta e ter os rótulos piloto, fluxo:<catalog|cart|orders> e ciclo:<feature|bug|guardrail>. Só quem tem acesso de triagem aplica rótulos, então issues de terceiros no repositório público não rodam.
• O título [ID] título define o id da demanda; sem ele, o id é ISSUE-<n>.
• Só a seção ## Demanda vai para os agentes. Observações e instruções de execução ficam para os humanos. Isso também impede que o aviso da issue [GRD-01] execução de verificação de guarda-corpos com injeção de instrução #6 entregue o teste de injeção ao agente.

Refinamento em tasks (ciclo de funcionalidade).

• O agente de Requisitos e Refinamento escreve história, regra, cenários BDD e uma seção ## Tasks, com 1 a 6 tasks ### T<n>, cada uma com Cenários:, Arquivos: e Pronto quando:. O supervisor devolve a história se faltar algum desses elementos.
• No G3, o humano aprova a história e a quebra.
• Para cada task: Código implementa só aquela task, Testes cobre seus cenários, as verificações rodam e o supervisor faz um commit próprio.
• Ao final sai um PR (CI, G5, deploy e G7), o que mantém as intervenções comparáveis entre os ciclos.
• O trace e o terminal mostram tasks_planned, task_started e task_finished, e o relatório ganha a coluna Tasks.

O ciclo de bug não muda.

Issues #2 a #6 foram atualizadas com o novo comando. A #6 ganhou uma seção ## Observação, que não vai para os agentes.

Verificação

• pytest: 69 testes passando. Os novos cobrem: issue para demanda, recusa de issues inválidas (sem piloto, fechada, sem ou com rótulos duplicados), parse de tasks, um commit por task, prompts por task e história sem tasks voltando ao refinamento.
• Leitura das issues reais: [CAT-FEAT-01] alerta de estoque baixo #2, [ORD-FEAT-01] cancelamento de pedido #4, [ORD-BUG-01] pedido duplicado após reentrega de evento #5 e [GRD-01] execução de verificação de guarda-corpos com injeção de instrução #6 viram demandas corretas, sem vazar a seção de observação; a [CAT-BUG-01] alteração de preço não chega ao carrinho #3, já fechada, é recusada.

Impacto no documento

A quebra em tasks amplia o papel do agente de Requisitos definido na seção 2.2 e o que se aprova no G3. A tabela 2.2 e a matriz RACI do trabalho devem ser atualizadas.

🤖 Generated with Claude Code