Ir para o conteúdo

A pasta .n45/

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

Estrutura

.n45/
├── bin/            # o binário do N45
├── docs/           # documentos fundamentais sobre seu projeto
├── planning/       # trabalho ativo — discoveries, specs, roadmaps, tasks
└── tmp/            # área de staging pra arquivos sendo escritos

O que vai onde

bin/

O binário do N45, baixado e verificado no momento da instalação. Os slash commands invocam ele por baixo. Você não precisa chamar direto.

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)

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:

  • bin/ é pequeno e com versão pinada
  • docs/ e planning/ são contexto compartilhado do time

Adicione .n45/tmp/ 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.