Conceitos & Glossário
Os termos do Makuco num só lugar.
Referência rápida do vocabulário do Makuco. Para o detalhe de cada agente, veja o Fluxo.
Glossário
| Termo | O que é |
|---|---|
| Feature | Uma capacidade do produto, identificada como feature_NNN_<slug>. É o ponto de partida do fluxo. |
| Módulo | Agrupador de features, identificado como module_NNN_<slug>. |
| PBI | Product Backlog Item — uma parte atômica e independentemente valiosa de uma feature. Cada PBI percorre o fluxo por conta própria. |
| Artefato | Qualquer arquivo produzido por um agente (discovery, spec, plan, review, learnings…). Fica versionado em .makuco/docs/. |
| Go/No-Go | Recomendação da Descoberta sobre seguir (ou não) com a ideia. |
| Spec | A spec.md — especificação auto-suficiente e sem código de um PBI, base para todo o resto. |
| Task | Unidade atômica de implementação (task-NN.md). Uma task por sessão de código. |
[P] | Marca de paralelismo no plano: tasks com [P] podem ser implementadas em paralelo. |
| Quality gate | Etapa de validação (lint + testes + build) que o makuco-codegen roda no passo VERIFY. |
| RED → GREEN → VERIFY → COMMIT | Ciclo de implementação: testes → código que passa → quality gate → commit atômico. |
status.yml | Arquivo que acompanha o progresso de uma feature e seus PBIs, etapa por etapa. |
STATE.md | Registro das mudanças feitas via Quick Mode. |
| Base de conhecimento | Os arquivos em .makuco/docs/codebase/ (+ MAKUCO.md) que os agentes leem antes de trabalhar. Gerada pelo start-makuco. |
| Quick Mode | Trilha expressa para mudanças pequenas, que ignora o fluxo completo. |