Começar

Projeto novo

A · Pelo plugin, sem clone

1. Instale o plugin e abra o Claude Code no diretório que vai guardar os projetos.
2. Rode /nerviz:new-project: ele baixa a última release em nerviz-<tag>/ e imprime a sessão a abrir ali.
3. Nessa sessão, aceite o trust prompt, confirme que a imposição está ativa e gere.
4. Abra uma sessão nova dentro do projeto gerado e peça o primeiro caso de uso.

claude plugin marketplace add nerviz-ai/marketplace
claude plugin install nerviz@nerviz
cd ~/dev && claude        # o diretório que vai guardar os projetos

› /nerviz:new-project   # baixa a última release em nerviz-<tag>/

# aceite o trust prompt: os hooks garantem a arquitetura
cd ~/dev/nerviz-<tag> && claude
› /arch-doctor
› /init-project --blueprint hexagonal --build maven --name my-api

# depois, desenvolva dentro do projeto gerado
cd ~/dev/my-api && claude
› /new-feature <o primeiro caso de uso>

• --ref <tag|sha|main> fixa outra versão. Rodar de novo com a mesma tag reaproveita a árvore; árvores nerviz-* antigas são listadas como seguras de apagar, nunca apagadas.
• Ele recusa rodar dentro de um projeto (pom.xml ou build.gradle no diretório): ali, use /nerviz:arch-adopt.
• O /init-project escreve fora da árvore (../<artifactId>), então o prompt de permissão da pasta irmã aparece. Para aprovar uma vez, rode mkdir ~/dev/my-api e /add-dir ../my-api antes.

B · Por clone, o caminho de quem contribui

1. Clone ao lado de onde os projetos vão morar e abra o Claude Code no clone.
2. Confirme que a imposição está ativa e gere.
3. Abra uma sessão nova dentro do projeto gerado e peça o primeiro caso de uso.

# clone ao lado de onde os projetos vão morar
cd ~/dev
git clone --depth 1 https://github.com/nerviz-ai/nerviz
cd nerviz && claude

# confirma que a imposição está ativa nesta máquina
› /arch-doctor
› /init-project --blueprint hexagonal --build maven --name my-api

# depois, desenvolva dentro do projeto gerado
cd ../my-api && claude
› /new-feature <o primeiro caso de uso>

Projeto existente

O mesmo plugin serve aos dois casos: instale uma vez e adote de dentro do projeto Java. Revise com git diff; desfaça com git checkout -- .claude.

claude plugin marketplace add nerviz-ai/marketplace
claude plugin install nerviz@nerviz

# dentro do projeto Java
› /nerviz:arch-adopt

Abaixo do Spring Boot 4.0: /platform-upgrade antes

O /arch-adopt recusa um projeto numa linha do Spring Boot abaixo de 4.0: o export sai com 2 antes de escrever um byte. O /platform-upgrade é o caminho para cima. Ele leva o build até a linha que o Initializr serve hoje, deixa o build verde e o diff sem commit, e termina imprimindo /arch-adopt.

1. Parta de uma worktree limpa, com um JDK que o build aceite, um wrapper Maven ou Gradle na raiz do projeto e acesso de rede ao Initializr e aos repositórios do motor.
2. Rode /nerviz:platform-upgrade dentro do projeto. Ela é só manual: reescreve o seu build e o seu código, então só roda quando você pede pelo nome.
3. Revise o diff e depois rode /nerviz:arch-adopt.

# dentro do projeto Java, numa linha abaixo de 4.0
› /nerviz:platform-upgrade

# revise o diff, depois adote
› /nerviz:arch-adopt