Configurações

O que o Makuco cria

Ao rodar makuco init, o Makuco adiciona ao seu projeto:

A pasta .makuco/, onde ficam organizados os artefatos do fluxo (descobertas, specs, planos, tarefas, revisões e aprendizados) e os templates prontos.
Os agentes, skills e prompts dentro da pasta da ferramenta escolhida — .claude/ (Claude Code) ou .github/ (VSCode + Copilot).
O arquivo MAKUCO.md na raiz: um guia do projeto (stack, padrões e convenções) que os agentes leem para entender o contexto antes de trabalhar.

Você não precisa editar esses arquivos à mão. Eles são usados pelos agentes durante o fluxo.

Gerar a base de conhecimento (start-makuco)

O makuco init cria o MAKUCO.md em branco. Para preenchê-lo com a realidade do seu projeto, rode o comando start-makuco logo na sequência. Ele dispara a skill makuco-project-research, que analisa o código e gera a base de conhecimento que todos os agentes leem antes de trabalhar.

Claude Code — selecione o prompt start-makuco na sessão.
VSCode + Copilot — selecione o prompt start-makuco no chat.

O que ele produz:

A pasta .makuco/docs/codebase/ com os arquivos de mapeamento do projeto — architecture.md, stack.md, structure.md, conventions.md, integrations.md, concerns.md e testing.md.
O MAKUCO.md preenchido com as informações essenciais do projeto (stack, padrões e convenções).

Rode o start-makuco ao entrar num projeto novo ou sempre que a base estiver desatualizada ou incompleta, quanto melhor esse contexto, menos explicação você repete a cada sessão.

Configurar o Makuco MCP

O Makuco MCP integra o fluxo com o SonarQube. Para habilitá-lo, informe o endereço do Sonar e um token de acesso.

1. Criar o token no SonarQube

No SonarQube, abra My Account → Security e gere um token do tipo User Token. Copie o valor gerado. Ele só aparece uma vez.

2. Informar as credenciais

Use SONAR_URL (endereço do seu SonarQube) e SONAR_TOKEN (o token criado acima).

Claude Code — no arquivo .claude/settings.local.json, dentro do bloco env:

{
  "env": {
    "SONAR_URL": "https://sonar.suaunidade.com.br",
    "SONAR_TOKEN": "seu-user-token"
  }
}

VSCode + Copilot — crie um arquivo .env na raiz do projeto (a mesma pasta do mcp.json) com:
```
SONAR_URL=https://sonar.suaunidade.com.br
SONAR_TOKEN=seu-user-token
```

3. Conferir o projeto no Sonar

Garanta que existe um arquivo sonar-project.properties na raiz do projeto, apontando para a chave do projeto no SonarQube.