Quick Mode

O Quick Mode é a trilha expressa do Makuco para mudanças pequenas e de causa conhecida. Ele ignora o fluxo makuco-analisar → makuco-desenvolver → makuco-code-review e é conduzido pelo agente makuco-quick — o único agente que você invoca direto.

Quando usar

Escolha a trilha pelo tamanho e risco da mudança:

Todas as condições do Quick Mode devem valer:

• ≤ 3 arquivos afetados;
• bug fix, ajuste de config ou bump de dependência;
• causa raiz conhecida;
• sem novas dependências ou decisões de arquitetura.

Se qualquer condição falhar, use o fluxo completo.

Como o agente trabalha

1. Reformula a tarefa em uma frase e checa os guardrails (≤3 arquivos, ≤1h, sem novas deps/arquitetura, causa conhecida).
2. Apresenta um bloco de pré-implementação (Arquivos / Abordagem / Verificação) e aguarda sua aprovação.
3. Faz a mudança cirúrgica — sem refactor, sem novas abstrações, casando com o estilo existente.
4. Verifica (gate quick + testes dos arquivos tocados) e propõe um commit atômico.
5. Persiste em .makuco/quick/NNN-<slug>/ e registra a tarefa no .makuco/STATE.md.

O que produz

.makuco/quick/{NNN}-{slug}/
├── TASK.md       # Quick Task, Files, Approach, Verify
└── SUMMARY.md    # arquivos, commit (hash + msg), resultado do gate

Além de um commit atômico e de uma linha registrada em .makuco/STATE.md:

| 001 | Corrige validação do header de auth | 2026-08-10 | abc1234 | Completed |

Exemplo

# TASK.md
Quick Task: Corrige validação do header de auth
Files: src/auth/headers.ts, src/tests/auth.spec.ts
Approach: validar origem do header e cobrir com teste
Verify: npm run test:auth
 
# SUMMARY.md
✅ Quick task 001 complete
Commit: abc1234 "fix(auth): validate header origin"
Verify: gate ok

Quick mode dentro do makuco-desenvolver

Existe também um atalho interno: se, ao chegar no passo de implementação, a PBI inteira couber no mesmo critério (descritível em uma frase, ≤3 arquivos somando todas as tasks), o makuco-desenvolver substitui o loop por task pelo processo de quick mode — mesma barra de qualidade, menos cerimônia. É uma decisão tomada uma vez, antes da primeira task, não por task.

Modelos sugeridos