complete

1. Detectar projeto

PROJECT_PATH=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
source ~/.claude/bin/get-project.sh
PROJECT_NAME=$(get-project-name)
WF_DIR="$HOME/.claude/workflow/$PROJECT_NAME"

Guarda de encerramento (determinística)

python3 ~/.claude/bin/wf_gate.py complete-check --workflow-dir "$WF_DIR" --repo "$PROJECT_PATH"

Saída 0: siga (human_override: true quer dizer que o ciclo fecha por exceção humana, não como verificado; diga isso no resumo e no PR). Saída 1: mostre reason_code e pare antes de qualquer outro passo. O arquivamento do passo 10 roda a mesma guarda e recusa sem ela; não existe caminho alternativo.

• REVISION_CHANGED → o código mudou depois do verify: rode /verify de novo.
• NO_VERIFY, VERIFY_RESULT_UNREADABLE, VERIFY_INCONSISTENT ou qualquer razão do verify (G2_FAIL, QA_SKIPPED, CRITERIA_UNTESTED…) → AskUserQuestion (parada incondicional, mesmo com auto on) com:
  • Rodar /verify de novo (Recommended).
  • Encerrar sem verificação: só com o motivo e os riscos escritos pelo usuário em Other. Rode python3 ~/.claude/bin/wf_gate.py accept-unverified --workflow-dir "$WF_DIR" --repo "$PROJECT_PATH" --reason "<motivo>" --risk "<risco>" [--risk ...]: abre um diálogo no Mac que só o usuário confirma. Cancelado ou expirado = recusa; não tente outra via. Confirmado → rode o complete-check de novo e siga.
  • Manter bloqueado: encerre o turno; o ciclo fica como está, sem perder artefatos.

Nunca escreva exec.override nem exec.verify à mão, e nunca trate uma resposta sua ou de subagente como autorização humana.

Relatório: início da etapa

python3 ~/.claude/bin/wf-report.py stage-start complete --workflow-dir "$WF_DIR" ${CLAUDE_FLOW_SESSION_ID:+--session "$CLAUDE_FLOW_SESSION_ID"} || true

2. Resumo do ciclo

A partir de current.json e $WF_DIR/runs/*/result.json:

## Ciclo: <feature>
- Tasks: N (S/M/L) · tentativas totais: X · escaladas: Y
- Tier final por task: T1 haiku, T2 haiku→sonnet, ...
- Verify: rodadas Z · <verdict> · <reason_code> · critérios PASS/FAIL/PARTIAL/UNTESTABLE · revisão <revision_id[:12]> · human_override <true|false>
- Custo aproximado: tokens de saída por papel (dev/g0/g1/g2) somados do trace

3. ADRs

Junte decisões candidatas:

• adr_candidates de $WF_DIR/tot-plan.json (se o plano foi via ToT);
• decisions de cada task nos result.json.

Invoque /adr propose com essa lista. Sem candidatas, pule. Se docs/adr for submódulo, o propose grava as candidatas em $WF_DIR/adr-candidates.md (o /pr-open as anexa ao PR no passo de abertura) em vez de criar ADRs.

Registre os ADRs propostos e as lessons gravadas. Registre como decisão do orquestrador (best-effort): escreva o texto com Write em $WF_DIR/.decision.md e rode (acrescente --mistake se for um erro seu):

python3 ~/.claude/bin/wf-report.py decision complete --workflow-dir "$WF_DIR" --by orchestrator --text-file "$WF_DIR/.decision.md" || true

4. Lessons

Leia os trace.jsonl dos runs do ciclo. Um finding vira lesson quando o mesmo rule_ref reprovou em 2+ tentativas (mesma task ou tasks diferentes) — foi o que custou escalada.

Para cada um, proponha 1 linha em ~/.claude/projects/$PROJECT_NAME/lessons.md:

- [<categoria>] <regra no imperativo> — origem: <rule_ref>, <ciclo>

Se a lesson já é uma rule ou ADR existente, não duplique: sugira reforçar a rule. Peça OK antes de gravar (auto on: grave).

5. Routing

python3 ~/.claude/bin/routing-stats.py --project "$PROJECT_NAME" --write

Mostre a tabela e as sugestões de tier0 que mudaram.

6. Roteiro de QA

Junte os critérios UNTESTABLE do último verify ($WF_DIR/runs/*/result.json) e os itens "QA manual" da spec. Escreva um array JSON de strings com Write em $WF_DIR/.qa.json (array vazio se não houver) e rode:

python3 ~/.claude/bin/wf-report.py qa --workflow-dir "$WF_DIR" --file "$WF_DIR/.qa.json" || true

7. Teste com dados reais

Com a evidência de runtime do G2 do último verify, escreva um resumo em markdown com Write em $WF_DIR/.real-data.md e rode:

python3 ~/.claude/bin/wf-report.py real-data --workflow-dir "$WF_DIR" --file "$WF_DIR/.real-data.md" || true

Sem evidência de runtime: python3 ~/.claude/bin/wf-report.py real-data --workflow-dir "$WF_DIR" --not-run || true.

8. Gate pr

Apresente em 3-5 linhas o que o PR conterá (feature, tasks, ADRs propostos). Com human_override, o corpo do PR diz que o ciclo não foi verificado, com o motivo e os riscos aceitos.

Gate pr (decisão determinística; nunca leia gates.json):

python3 ~/.claude/bin/wf-report.py gate pr

• skip: trate como Aprovar.
• ask: faça um AskUserQuestion ("Abrir o PR deste ciclo?") com as opções:
  • Aprovar (Recommended): invoque /pr-open --from-complete (ele lê o card do tracker do current.json). A última linha do resultado é a URL do PR; grave-a:

    python3 ~/.claude/bin/wf-report.py pr --workflow-dir "$WF_DIR" --url "<URL>" || true

    Se o /pr-open parar (ex.: mudanças não commitadas), avise e repita este gate depois de o usuário resolver.
  • Ajustar: o usuário escreve o ajuste em Other; aplique o texto e repita este mesmo gate.
  • Rejeitar: siga sem PR; não grave pr no relatório.
• A resposta do usuário vira decisão: escreva-a com Write em $WF_DIR/.decision.md e rode python3 ~/.claude/bin/wf-report.py decision complete --workflow-dir "$WF_DIR" --by user --text-file "$WF_DIR/.decision.md" || true.

9. Fechar relatório

Relatório: fim da etapa. Escreva com Write um resumo de 3 a 10 linhas em $WF_DIR/.stage-summary.md (nunca interpole texto em shell) e rode:

python3 ~/.claude/bin/wf-report.py stage-end complete --workflow-dir "$WF_DIR" --summary-file "$WF_DIR/.stage-summary.md" || true

10. Arquivar

O archive copia o report.json, por isso vem depois do stage-end. Ele reroda o complete-check; se o repo mudou desde o passo 1 (ex.: commit do /pr-open com autofix), ele recusa: rode /verify de novo.

bash ~/.claude/bin/archive-cycle.sh completed "$PROJECT_NAME"

(O archive copia runs/ para o histórico — o dashboard e o routing continuam lendo de lá.)

11. Próximo passo

"Ciclo concluído." Com PR aberto, acompanhe com /pr-status; sem PR, /pr-open abre depois (avulso, sem gravar relatório). Não commite aqui.