La carpeta .n45/

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

Estructura

.n45/
├── bin/            # el binario de N45
├── docs/           # documentos fundamentales sobre tu proyecto
├── planning/       # trabajo activo — discoveries, specs, roadmaps, tasks
└── tmp/            # área de staging para archivos siendo escritos

Qué va dónde

bin/

El binario de N45, descargado y verificado en el momento de instalación. Los slash commands lo invocan por debajo. No necesitas llamarlo directamente.

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)

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:

• bin/ es pequeño y con versión pinada
• docs/ y planning/ son contexto compartido del equipo

Agrega .n45/tmp/ a tu .gitignore si N45 no lo 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.