Instalação

Pré-requisitos

• Node.js + npm.
• Acesso ao registry Azure de publicação: https://db1global.pkgs.visualstudio.com/_packaging/makuco/npm/registry/.
• Conexão à VPN da DB1 — package.makuco.com.br é um domínio interno. Sem a VPN ativa, o download do pacote retorna HTTP 403.

Instalar a CLI

Há duas formas de obter a CLI. Escolha a que preferir.

Opção A — direto pela URL do pacote (sem instalar)

Você pode rodar a CLI apontando o npx para o pacote .tgz publicado, sem instalar nada globalmente. Use latest para a versão mais recente:

npx -y http://package.makuco.com.br/makuco/latest.tgz init

Ou fixe uma versão específica trocando latest pelo número da versão:

npx -y http://package.makuco.com.br/makuco/1.0.22.tgz init

Opção B — baixar o .tgz e rodar localmente

Baixe o pacote pelo feed do Makuco no Azure Artifacts:

db1global.visualstudio.com/_artifacts/feed/makuco

Depois rode o arquivo baixado com npx (ajuste o nome para a versão que você baixou):

npx -y makuco-1.0.23.tgz init

Rodar a inicialização

Nas Opções A e B o comando init já é executado junto.

Para sobrescrever artefatos já existentes:

makuco init --force

Prompts do makuco init

O comando é interativo e pergunta:

1. Ferramenta de IA (multiseleção, até 2):
   • Claude Code → instala em .claude/
   • VSCode + Copilot → instala em .github/
2. Unidade (opcional) — none (padrão) ou a unidade específica do seu time.
3. Pasta raiz — padrão . (diretório atual).

Configurar o Makuco MCP

Para habilitar o Makuco MCP (que usa o SonarQube), veja o passo a passo em Configurações.

Verificação

Confira que o init criou:

• .makuco/ (com README.md, templates/, docs/).
• .claude/agents/, .claude/skills/, .claude/prompts/ (Claude Code).
• .github/agents/, .github/skills/ (VSCode, se selecionado).

Detalhamento completo do que é criado em Configurações.