Seu primeiro /n45¶

Depois de configurar, abra sua IDE e rode /n45 no chat. Ele é o hub — detecta o estado e te oferece as ações certas.

/n45

/n45 Retomar trabalho ou mostrar o estado

/n45-feat Construir uma nova feature

/n45-fix Investigar e corrigir um bug

/n45-status Ver o estado atual

Prefixo de invocação por ferramenta

No Claude Code e no Cursor os comandos usam / (ex.: /n45, /n45-feat). No Codex usam $ (ex.: $n45, $n45-feat). Os exemplos abaixo usam /; troque por $ se estiver no Codex.

O fluxo diferencia um pouco entre Project (um repositório) e Workspace (vários). Escolha o seu abaixo.

No seu projeto (Project)¶

A primeira execução¶

O N45 acorda e inspeciona seu projeto:

Lê seu package.json, go.mod, Cargo.toml, pyproject.toml, etc.
Detecta linguagens, frameworks e tooling
Gera quatro documentos fundamentais em .n45/docs/:

Documento	O que contém
STACK	Linguagem, runtime, framework, build tooling
PATTERNS	Convenções arquiteturais encontradas no seu código
PROJECT	Visão geral do domínio, módulos, entry points
RUNBOOK	Como rodar, testar e fazer deploy

A primeira execução leva 30–60 segundos. As seguintes são instantâneas — o N45 só lê os documentos existentes.

Sua primeira feature¶

Com o projeto aberto, digite algo como:

/n45-feat adicionar um endpoint de health check

O N45 faz perguntas pra clarificar, propõe um plano e então aplica a mudança direto (pra mudanças pequenas) ou monta discovery, spec e roadmap completos (pra mudanças maiores). Você aprova em cada passo. Detalhes em Construir uma feature.

No seu workspace (Workspace)¶

Rode /n45 na pasta do workspace — ele abre o hub do workspace (o estado é lido do disco de cada membro).

Sem membros? O hub te ajuda a adicionar — repositórios existentes (workspace add) ou criar aplicações novas que viram membros.
Com membros, planeje uma feature cross-repo:
```
/n45-feat adicionar um chat entre os serviços
```
O N45 entrevista você, mapeia as telas e os contratos por membro, gera a SPEC e o CONTRACT (a costura entre os serviços — você aprova), e faz o fan-out: cada membro ganha o próprio roadmap.
Execute e finalize: /n45-next avança cada membro em paralelo; quando todos concluem, o hub oferece a validação unificada e o finish coordenado.

O fluxo completo está na seção Workspace: Planejar uma feature → Executar, validar e finalizar.

Acompanhe pelo dashboard¶

Enquanto o N45 constrói, rode num terminal à parte:

npx n45-ai@latest status

Isso sobe o Dashboard no navegador — um kanban onde você vê as tasks andando conforme os agentes executam, além de métricas e os documentos do projeto. Num workspace, ele agrega todos os membros num lugar só. Deixe numa aba e acompanhe a construção em tempo real.

Depois¶

/n45 puro retoma o que estava em andamento; se nada estiver, ele mostra o que é possível em seguida.

Comando	Quando usar
`/n45-feat`	Construir uma feature ou melhoria
`/n45-fix`	Investigar um bug ou comportamento inesperado
`/n45-status`	Ver o estado — trabalho aberto, validação pendente
`/n45-next`	Avançar a execução (a próxima fase)
`/n45-run`	Rodar a aplicação