Makuco é um framework de skills orquestradoras que conduzem cada etapa do desenvolvimento, da análise à documentação, garantindo qualidade, rastreabilidade e velocidade em cada feature.

O que é
Makuco divide qualquer feature em PBIs atômicas e conduz cada uma por um ciclo completo: desde a validação da ideia até a implementação revisada e documentada.
Cada skill produz artefatos bem definidos — PRD, specs, tasks, code reviews, docs — que se acumulam e formam o histórico do projeto.
Analisar
PRD + PBIs por INVEST
Desenvolver
RED → GREEN → VERIFY
Code Review
7 passes + veredito
Documentar
Docs + aprendizados
O fluxo completo
Cada skill entrega artefatos para a próxima. O ciclo é linear por PBI, e features diferentes podem correr em paralelo.
Etapas
Você invoca cada skill direto no chat. Ela conduz o próprio fluxo, mantém o próprio estado de sessão e sabe para onde entregar.
Explora o problema, aplica o gate de produto, escreve o PRD e decompõe a feature em PBIs validadas por INVEST.
Gera spec.md + task.md e implementa task por task no ciclo RED → GREEN → VERIFY → COMMIT, com gate antes de cada commit.
Sete passes de revisão, cada achado bloqueante verificado contra o código, e um veredito. Nunca altera código.
Acionado pelo review quando ele aprova: atualiza só a documentação afetada e consolida os aprendizados.
Por que Makuco
Quem revisa não conserta
O code review nunca altera código. Ele documenta os achados e devolve as tasks ao desenvolvimento.
PBIs independentes
Features grandes são decompostas em partes validadas por INVEST, que podem correr em paralelo.
Humano nos checkpoints
Gate de produto, aprovação da spec, confirmação antes de criar ou fechar um card. O controle fica com você.
Sessões retomáveis
Cada skill grava o próprio estado. Uma interrupção volta de onde parou, sem perder contexto.
Quick Mode
Para mudanças pequenas que não justificam o fluxo completo.
Documentação viva
A cada ciclo, docs e learnings são atualizados automaticamente.
Veja a documentação completa e comece com o makuco-analisar na sua próxima feature.