La carpeta .n45/¶

Cuando ejecutas npx n45-ai init, N45 crea un directorio .n45/ en la raíz de tu proyecto. Todo lo que N45 necesita para operar vive ahí.

Estructura¶

.n45/
├── docs/           # documentos fundamentales sobre tu proyecto
├── planning/       # trabajo activo — discoveries, specs, roadmaps, tasks
├── worktree/       # workspaces aislados (git worktrees) de los agentes durante la ejecución
└── tmp/            # área de staging para archivos siendo escritos

¿Dónde está el binario?

El binario de N45 no vive en tu proyecto. Se descarga a una caché compartida en tu home (~/.n45/bin/) y se reutiliza entre proyectos. Los slash commands lo invocan por debajo — no necesitas llamarlo directamente.

Qué va dónde¶

`docs/`¶

Documentos fundamentales generados en la primera ejecución y actualizados conforme tu proyecto evoluciona:

STACK.md — lenguaje, runtime, framework, build tooling
PATTERNS.md — convenciones arquitecturales encontradas en tu código
PROJECT.md — visión general del dominio, módulos, entry points
RUNBOOK.md — cómo ejecutar, testear y hacer deploy

Mira Documentos del proyecto para detalles completos.

`planning/`¶

Artefactos de trabajo activo y completado. Toda feat o fix estructurada crea archivos aquí:

Discoveries
Specs
Roadmaps
Archivos de task (uno por task)
Retrospectivas (al cierre del roadmap)

`worktree/`¶

Workspaces aislados donde los agentes ejecutores trabajan durante un flujo. Cada agente recibe un git worktree dedicado en worktree/agent-<hash>/ — una copia de la branch activa donde escribe código sin tocar tu working tree. Al final, N45 hace merge de vuelta y elimina el worktree. Transitorio y gestionado por N45 — no lo edites ni lo commitees.

`tmp/`¶

Donde se preparan los archivos borrador antes de ser persistidos. No es para edición manual — N45 escribe aquí y lee de vuelta a través de sus propios comandos.

Qué commitear¶

Todo .n45/ es seguro y recomendado para commitear:

docs/ y planning/ son contexto compartido del equipo

Agrega .n45/tmp/ y .n45/worktree/ a tu .gitignore si N45 no los agregó por ti. Todo lo demás debería ser rastreado.

Qué N45 no va a tocar¶

Cualquier cosa fuera de .n45/ pertenece a tu proyecto. N45 solo escribe fuera de .n45/ a través de agentes ejecutores dedicados durante un flujo — y esos cambios siempre pasan por branch y commit.