# Manutenção e debate de demonstrações

Data: 2026-07-19

## Estado

- 8 lições construídas; exemplo contínuo único; somente PT-BR.
- 20 tipos do catálogo cobertos nas escolhas debatidas; apresentação universal em cada lição.
- Sem registro de aprendizado: cobertura não prova aprendizado.

## Debate por lição

### Lição 1 — Pesquise antes de criar o goal

- Trabalho didático: explicar e estruturar.
- Candidatos: 15 research-concept-explainer; 4 code-understanding; 14 research-feature-explainer.
- Escolha: research-concept-explainer + code-understanding + research-feature-explainer — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 13 flowchart-diagram ficou em segundo: mostra a sequência, mas explica menos o porquê da pesquisa.

### Lição 2 — Escreva o contrato do trabalho

- Trabalho didático: explicar e estruturar.
- Candidatos: 20 editor-prompt-tuner; 5 design-system; 16 implementation-plan.
- Escolha: editor-prompt-tuner + design-system + implementation-plan — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 17 pr-writeup ficou em segundo: narra bem a mudança, mas não ajuda a afinar o contrato antes dela.

### Lição 3 — Roteie Sol, Terra e Luna pelo trabalho

- Trabalho didático: comparar e rotear.
- Candidatos: 1 exploration-code-approaches; 2 exploration-visual-designs; 6 component-variants.
- Escolha: exploration-code-approaches + exploration-visual-designs + component-variants — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 5 design-system ficou em segundo: ensina convenções, mas a matriz de variantes comunica melhor o roteamento.

### Lição 4 — Controle effort, Fast e Ultra

- Trabalho didático: comparar e rotear.
- Candidatos: 11 status-report; 19 editor-feature-flags; 12 incident-report.
- Escolha: status-report + editor-feature-flags + incident-report — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 20 editor-prompt-tuner ficou em segundo: ajusta knobs bem, mas o relatório de status revela melhor o custo operacional.

### Lição 5 — Delegue unidades bounded

- Trabalho didático: coordenar e revisar.
- Candidatos: 13 flowchart-diagram; 7 prototype-animation; 8 prototype-interaction.
- Escolha: flowchart-diagram + prototype-animation + prototype-interaction — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 16 implementation-plan ficou em segundo: organiza fases, mas não deixa a ramificação e o teto tão visíveis.

### Lição 6 — Separe autor, revisor e tiers

- Trabalho didático: coordenar e revisar.
- Candidatos: 3 code-review-pr; 17 pr-writeup; 18 editor-triage-board.
- Escolha: code-review-pr + pr-writeup + editor-triage-board — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 11 status-report ficou em segundo: resume o estado, mas não mostra o raciocínio da revisão de uma mudança.

### Lição 7 — Atravesse o Proof Gate real

- Trabalho didático: provar e diagnosticar.
- Candidatos: 10 svg-illustrations; 9 slide-deck; 4 code-understanding.
- Escolha: svg-illustrations + slide-deck + code-understanding — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 11 status-report ficou em segundo: é ótimo para resumo, mas a ilustração mostra melhor as fronteiras sucessivas.

### Lição 8 — Feche o playbook e diagnostique K3

- Trabalho didático: provar e diagnosticar.
- Candidatos: 9 slide-deck; 11 status-report; 12 incident-report.
- Escolha: slide-deck + status-report + incident-report — cada um cobre uma etapa distinta (explicar, experimentar, checar).
- Alternativa: 14 research-feature-explainer ficou em segundo: detalha a rota, mas o incident-report ensina melhor o bloqueio.

## Próxima manutenção

Reexecutar o validador após qualquer edição e retestar K3 somente quando o envelope de tool calls do runtime mudar.