makuco init · Makuco

makuco init [-f | --force]

Inicializa o Makuco no projeto: instala skills, agentes, prompts, hooks e MCPs, escolhe a unidade que configura o projeto e monta a pasta repos/. É interativo.

Flag	O que faz
`-f, --force`	Sobrescreve artefatos já existentes, sem perguntar.

O que ele pergunta

Ferramenta de IA (multiseleção, até 2):
- Claude Code → instala em .claude/
- VSCode + Copilot → instala em .github/
Pasta raiz — padrão . (diretório atual).
Usa Azure DevOps? — não por padrão. Respondendo sim, pergunta o projeto e, se o VSCode estiver selecionado, o PAT. Veja Azure DevOps.
Declarar uma fonte de contexto do projeto? — não por padrão. Respondendo sim, pergunta o nome, o tipo (servidor MCP, pasta no disco ou endereço web), a localização, para que ela serve e como perguntar a ela. Veja Fontes de contexto do projeto.
Habilitar gates de qualidade nos agentes? — não por padrão. Respondendo sim, grava .makuco/integrations/quality-gate.yml com o SonarQube e a verificação de complexidade ligados. Respondendo não, nada é gravado e esses dois gates ficam com o pipeline do time. Veja Gates de qualidade.
Unidade — a lista vem do Makuco Hub. A escolha fica registrada no projeto e não é perguntada de novo.
Clonar repositórios para repos/? — não por padrão. Respondendo sim, pergunta o método de autenticação (SSH ou HTTPS) e a URL de cada repositório, e permite clonar mais de um.

A escolha da unidade

Mudou na 3.1.0

Até a 3.0.0 a lista de unidades vinha embutida no binário e o conteúdo era obtido clonando o repositório da unidade com chave SSH. Esse caminho foi removido. A partir da 3.1.0 a lista é publicada pelo Hub — unidade nova aparece sem exigir versão nova da CLI — e o conteúdo é baixado do Hub e registrado com versão e identidade. A chave SSH deixa de ser pré-requisito do setup.

O comportamento depende do que já existe no projeto:

Situação	O que acontece
Unidade já registrada e ainda publicada	Mantém a escolha e só atualiza o conteúdo.
Unidade registrada que saiu do Hub	Avisa e pergunta de novo.
Nenhuma unidade registrada	Pergunta qual é.
Hub sem nenhuma unidade publicada	Avisa e pula — o resto da inicialização segue.
Terminal não interativo e nada registrado	Pula a escolha — o resto da inicialização segue.
Hub inalcançável	Avisa e pula a configuração de unidade — o resto da inicialização segue.

Projeto vindo do caminho antigo

Se o conteúdo da unidade já está no disco mas nenhum artefato foi inventariado (projeto criado por uma versão anterior da CLI), o init faz uma pergunta só para a unidade inteira: adotar o conteúdo publicado no Hub, ou manter o que está no disco. Sem essa pergunta, a primeira execução pós-upgrade perguntaria arquivo por arquivo sobre o que a própria CLI instalou.

Em terminal não interativo a resposta é keep — nada é substituído.

O que ele cria

.makuco/ (com README.md, templates/, docs/).
.makuco/integrations/observability.yml — sempre, inteiro comentado: não configura nada até a primeira investigação de bug precisar de um papel. Um arquivo que já existe nunca é sobrescrito. Veja Observabilidade.
.makuco/integrations/quality-gate.yml — só se você habilitou os gates de qualidade.
.makuco/integrations/context-sources.yml — só se você aceitou declarar uma fonte de contexto.
.claude/skills/, .claude/agents/, .claude/prompts/ (Claude Code).
.github/skills/, .github/agents/ (VSCode, se selecionado).
MAKUCO.md e repos/ na raiz — sempre, mesmo quando nenhum repositório é clonado.
.makuco/state.json com a unidade registrada e o inventário dos artefatos entregues.

init é uma reinstalação completa

O makuco init sobrescreve as skills instaladas e repergunta as configurações — ele não é só um reindex. Quando ele perguntar se deseja sobrescrever o MAKUCO.md existente, responda não: sobrescrever descarta as descrições de repositório já preenchidas. E não use --force para reindexar — --force sobrescreve o MAKUCO.md sem perguntar, apagando o índice e as políticas do time.

Para atualizar ativos preservando o que você mudou, use o makuco update e o makuco unit sync.

Detalhamento completo do que é criado em Configurações, e a estrutura multi-repo em Instalação → Workspace multi-repo.