Você abre a Verboo Code num repositório novo e o agente não sabe que o teste roda com make test, que o pacote é pnpm ou que existe uma regra no .cursorrules que o time inteiro segue. O /init resolve isso em um comando: ele lê o projeto e escreve um CLAUDE.md com os comandos e a arquitetura, que a CLI carrega em toda sessão dali em diante.
O que o /init faz na Verboo Code?
Ele analisa o repositório e cria o arquivo de instruções do projeto, o CLAUDE.md na pasta onde você abriu a sessão. Enquanto trabalha, a CLI mostra analyzing your codebase.
npm install -g @verboo/code
cd ~/projetos/meu-app
verbooCom a sessão aberta, digite:
/initAbra na raiz do repositório, onde ficam o package.json, o pyproject.toml ou o go.mod. O arquivo é escrito na pasta da sessão, e a CLI procura os arquivos de instrução subindo a partir da pasta em que você está.
O que o /init lê e o que ele escreve?
Ele lê o que já documenta o projeto e escreve só duas coisas: comandos e arquitetura. A lista abaixo saiu do prompt do comando, em src/commands/init.ts.
| Lê | Escreve no CLAUDE.md |
|---|---|
README.md | Comandos de build, lint e teste |
Regras do Cursor: .cursor/rules/ e .cursorrules | Como rodar um teste só |
Regras do Copilot: .github/copilot-instructions.md | Arquitetura de alto nível, a que exige ler vários arquivos para entender |
CLAUDE.md existente | Sugestões de melhoria, em vez de um arquivo novo |
O prompt também manda o agente evitar o óbvio: nada de "escreva testes unitários", nada de listar cada arquivo e nada de inventar seções como "Dicas de desenvolvimento" que não estejam em algum arquivo lido. O resultado tende a ser curto, e isso é de propósito.
Dá para migrar do Cursor ou do Copilot com o /init?
Dá, e é o jeito mais rápido. Se o repositório tem .cursorrules, .cursor/rules/ ou .github/copilot-instructions.md, o /init é instruído a levar as partes importantes para o CLAUDE.md. Você não precisa copiar regra por regra: rode o comando e confira se o que importava entrou.
Como revisar o CLAUDE.md gerado?
Leia cada linha e pergunte: sem isso, o agente erraria? Se não erraria, corte. Tudo no arquivo entra no contexto de toda sessão, e o código define 40.000 caracteres como tamanho máximo recomendado por arquivo.
# CLAUDE.md
## Comandos
- Instalar: pnpm install (nunca npm)
- Testes: make test
- Um teste só: pnpm vitest run src/api/users.test.ts
## Arquitetura
- src/api expõe REST; src/jobs roda as filas. Os dois leem src/core.
- Migrações em db/migrations, geradas com make migration name=...Para editar depois, use o /memory, que abre o arquivo no seu editor. Regra pessoal que não deve ir para o git fica no CLAUDE.local.md, fora do /init.
E se o repositório já tem AGENTS.md?
Mantenha um arquivo raiz só. Na mesma pasta, a Verboo Code carrega o AGENTS.md e só usa o CLAUDE.md quando o AGENTS.md não existe. Os dois não somam. Se depois do /init você ficou com os dois, leve o conteúdo novo para o AGENTS.md e apague o outro:
cat CLAUDE.md >> AGENTS.md
rm CLAUDE.mdDepois abra o AGENTS.md e tire o que ficou repetido. Se o repositório não tem AGENTS.md, o CLAUDE.md gerado é o arquivo do projeto e não precisa de nada disso.
Quando rodar o /init de novo?
Depois de mudança estrutural: troca de gerenciador de pacotes, novo serviço no monorepo, comando de teste diferente. Com o CLAUDE.md já existente, o /init propõe melhorias em vez de recomeçar, então você revisa a diferença e aceita o que fizer sentido. Se quiser ajustar algo específico, peça na mensagem seguinte, por exemplo: "acrescente como rodar os testes de integração".
Como isso se encaixa com os outros comandos?
- O /plan já monta o plano seguindo o que está no arquivo de instruções.
- O /context mostra quanto do contexto o arquivo ocupa.
- Instrução é pedido, não trava. Para bloquear comando de verdade, use o /permissions.
O /init lê README, manifest e regras antigas antes de escrever uma linha, e rodar de novo a cada refatoração grande é o que mantém o arquivo útil. Na Verboo Code o token é ilimitado, então reescanear o repositório não custa nada: crie a conta em verboo.ai, abra a CLI na raiz do projeto e rode /init.
