Sobre
O que é o Makuco e como ele prepara seu projeto para desenvolver com IA.
O Makuco é uma ferramenta de linha de comando (makuco) que prepara um projeto para um fluxo de
desenvolvimento assistido por IA. Com um único comando (makuco init), ele cria no seu
repositório as skills, os agentes e os arquivos base que conduzem esse fluxo, da ideia
inicial até o código revisado e documentado.
Desde a 3.2.0, makuco sozinho também abre uma CLI interativa: ela lê os artefatos do
projeto, decide o próximo passo, invoca a skill certa e mostra o agente trabalhando — sem você sair
do terminal. Veja CLI Interativa.
O que muda na v3
Na v2 você escolhia um agente por etapa — eram dez. Na v3 o trabalho de ponta a ponta é conduzido por três skills orquestradoras autônomas, que você invoca direto no chat:
| Skill | Do quê | Para quê |
|---|---|---|
| makuco-analisar | Uma oportunidade ou um problema | PRD + PBIs validadas por INVEST |
| makuco-desenvolver | Uma PBI pronta | Código verde, em commits atômicos |
| makuco-code-review | Uma mudança pronta | review.md + veredito |
Cada uma conduz o próprio fluxo em passos, mantém o próprio arquivo de sessão e sabe para onde entregar — você não escolhe agente a cada passo, e uma interrupção volta de onde parou.
Para que serve
Em vez de configurar tudo à mão em cada projeto, você roda o Makuco uma vez e recebe a mesma base pronta:
- As três skills orquestradoras que conduzem uma feature da ideia ao código documentado.
- As skills de apoio — especialistas de backend/frontend/UX, passes de review, formatação de cada artefato, práticas de código e testes, geração de diagramas.
- Os 3 agentes de apoio ao fluxo.
- Templates prontos de especificação, tarefas e status.
- A pasta
.makuco/, onde ficam organizados os artefatos do seu trabalho.
E, com o projeto inicializado, a CLI interativa que dirige tudo isso a partir do terminal.
Funciona com
| Ferramenta | Onde instala |
|---|---|
| Claude Code | .claude/ |
| VSCode + Copilot | .github/ |
Também é possível instalar uma configuração específica de unidade.
Roda sem integração nenhuma
O Makuco opera 100% local-only por padrão. A integração com Azure DevOps é
opcional: sem ela, as PBIs vivem só no disco, com id local (pbi-NNN + slug), e nada no fluxo deixa
de funcionar.
Por onde começar
- Instalação — instalar a CLI, rodar o
makuco inite atualizar com omakuco update. - CLI Interativa — abrir o
makucono terminal e deixar o loop dirigir o fluxo. - Configurações — o que é criado, a base de conhecimento e o Makuco MCP.
- Azure DevOps — a integração opcional com o tracker.
- Fluxo — as três skills, os agentes de apoio e o Quick Mode.
- Servidores MCP — as ferramentas do Makuco MCP e do Makuco Docs MCP.
- Boas Práticas — sessões, prompts e escolha de modelo para gastar menos tokens.
- Conceitos & Glossário — o vocabulário do Makuco num só lugar.
- Troubleshooting & FAQ — erros comuns na instalação e no uso, e como resolver.
- Changelog — histórico de versões.