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 os agentes, as skills e os arquivos base que conduzem esse fluxo, da
ideia inicial até o código revisado e documentado.
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:
- Agentes que acompanham cada etapa de uma feature, da descoberta à documentação.
- Skills que padronizam como cada artefato é escrito e revisado.
- Templates prontos de especificação, tarefas e planos.
- A pasta
.makuco/, onde ficam organizados os artefatos do seu trabalho.
Funciona com
| Ferramenta | Onde instala |
|---|---|
| Claude Code | .claude/ |
| VSCode + Copilot | .github/ |
Também é possível instalar uma configuração específica de unidade.
Por onde começar
- Instalação — instalar e rodar o
makuco initno seu projeto. - Fluxo — entenda as etapas, os agentes e o Quick Mode.
- Configurações — o que é criado e como configurar o Makuco MCP.
- Boas Práticas — sessões, prompts e escolha de modelo para gastar menos tokens.
- Conceitos & Glossário — vocabulário do Makuco e qual agente usar em cada situação.
- Troubleshooting & FAQ — erros comuns na instalação e no uso, e como resolver.
- Changelog — histórico de versões.