A pasta .n45/¶

Quando você roda npx n45-ai init, o N45 cria um diretório .n45/ na raiz do seu projeto. Tudo que o N45 precisa pra operar vive aí.

Estrutura¶

.n45/
├── docs/           # documentos fundamentais sobre seu projeto
├── planning/       # trabalho ativo — discoveries, specs, roadmaps, tasks
├── worktree/       # workspaces isolados (git worktrees) dos agentes durante a execução
└── tmp/            # área de staging pra arquivos sendo escritos

Cadê o binário?

O binário do N45 não vive no seu projeto. Ele é baixado pra um cache compartilhado na sua home (~/.n45/bin/) e reusado entre projetos. Os slash commands invocam ele por baixo — você não precisa chamar direto.

O que vai onde¶

`docs/`¶

Documentos fundamentais gerados na primeira execução e atualizados conforme o projeto evolui:

STACK.md — linguagem, runtime, framework, build tooling
PATTERNS.md — convenções arquiteturais encontradas no seu código
PROJECT.md — visão geral do domínio, módulos, entry points
RUNBOOK.md — como rodar, testar e fazer deploy

Veja Documentos do projeto pra detalhes completos.

`planning/`¶

Artefatos de trabalho ativo e concluído. Toda feat ou fix estruturada cria arquivos aqui:

Discoveries
Specs
Roadmaps
Arquivos de task (um por task)
Retrospectivas (no fechamento do roadmap)

`worktree/`¶

Workspaces isolados onde os agentes executores trabalham durante um fluxo. Cada agente recebe um git worktree dedicado em worktree/agent-<hash>/ — uma cópia da branch ativa onde ele escreve código sem mexer no seu working tree. Ao final, o N45 faz merge de volta e remove o worktree. Transitório e gerenciado pelo N45 — não edite nem commite.

`tmp/`¶

Onde arquivos rascunho são preparados antes de serem persistidos. Não é pra edição manual — o N45 escreve aqui e lê de volta através de seus próprios comandos.

O que commitar¶

Todo o .n45/ é seguro e recomendado pra commit:

docs/ e planning/ são contexto compartilhado do time

Adicione .n45/tmp/ e .n45/worktree/ ao seu .gitignore se o N45 não adicionou pra você. Todo o resto deve ser rastreado.

O que o N45 não vai tocar¶

Qualquer coisa fora de .n45/ pertence ao seu projeto. O N45 só escreve fora de .n45/ através de agentes executores dedicados durante um fluxo — e essas mudanças sempre passam por branch e commit.