FAQ

¿Escribo yo la spec y el roadmap, o los hace N45?

Los hace N45. Vos describís qué querés en lenguaje natural; él corre el discovery, propone la spec (flujos, pantallas/contratos, casos de error) y genera el roadmap con tasks. Vos aprobás en cada etapa — la intención, la spec, el roadmap — y ajustás lo que quieras antes de que se escriba código.

¿Por qué usar N45 en vez de solo chatear con la IA en mi IDE?

Chatear directo sirve para cambios chicos, pero la IA olvida el contexto entre solicitudes, no sigue tus patrones de forma consistente y no revisa su propio trabajo. N45 agrega estructura (discovery → spec → roadmap → ejecución), revisión por defecto (un revisor por task), memoria (STACK/PATTERNS/PROJECT viven en .n45/ y alimentan ejecuciones futuras) y vos en control (cada decisión relevante se detiene a preguntar).

¿Cuál es la diferencia entre el camino rápido y el estructurado?

En una feature de proyecto, N45 decide en el triage: un cambio puntual y claro (sin nuevo contrato, sin migration, sin cambio arquitectónico) → camino rápido (aplicado directo en una rama). Cualquier cosa más grande → camino estructurado (discovery + spec + roadmap + ejecución por fase). Las features de workspace son siempre estructuradas (tienen un CONTRACT). Mirá Construir una feature.

¿N45 tiene algún costo además de mi suscripción de IA?

Las llamadas de IA usan la conexión de tu propia IDE con tu proveedor (Anthropic, OpenAI, etc.) — N45 no cobra tokens aparte ni intermedia el modelo. Lo que N45 requiere es una licencia activa para usar el producto. O sea: pagás tu IA (como ya lo hacés) + la licencia de N45.

¿Qué modelo de IA debería usar?

Usá el más capaz y reciente disponible en tu IDE (en la familia Claude, el modelo más nuevo). N45 orquesta varios subagentes con contratos estrictos, y la calidad del resultado acompaña la calidad del modelo. Los modelos más débiles funcionan, pero entregan menos.

¿N45 edita mi código por su cuenta?

No directamente. El orquestador nunca escribe código — delega a subagentes especializados que trabajan en worktrees aislados (copias de trabajo separadas). Vos ves el resultado, lo revisás y aprobás antes del merge. Nada llega a tu código principal sin pasar por vos.

¿N45 corre tests?

Sí. El comportamiento testeable (un endpoint, una regla de negocio, un cálculo, una validación) siempre recibe test — es parte del criterio de aceptación de cada task, y un revisor lo verifica. "Sin tests" solo aplica a un prototipo genuinamente descartable, y con tu confirmación explícita.

¿Qué pasa si una task se traba o falla?

N45 no lo empuja a la fuerza. Si una task no puede completarse (una dependencia externa, ambigüedad, un error de infra), se bloquea y N45 escala hacia vos para decidir — en vez de entregar código roto. Los problemas fuera del alcance se convierten en tech debt registrado, no en correcciones silenciosas.

¿Puedo ajustar la spec o el roadmap después de generados?

Sí. Revisás y ajustás la spec antes de aprobar. Durante la ejecución, si notás que algo tiene que cambiar, N45 recomputa la parte afectada (una spec de workspace es inmutable con un roadmap activo, pero change-spec re-planifica solo lo que cambió).

¿Puedo retomar un roadmap después, en otra sesión?

Sí. Todo el estado vive en el .n45/ de tu repositorio (roadmap, tasks, worktrees). Cerrá la IDE, volvé semanas después, corré /n45 — lee el estado del disco y continúa donde quedó. En un workspace, el estado se lee del disco de cada miembro.

¿N45 toca mi git?

Sí, de forma disciplinada y transparente. Cada feature nace en su propia rama (a partir de una rama protegida, o de tu rama actual si elegís). Los subagentes trabajan en worktrees. En la finalización elegís merge o Pull Request y la rama protegida de destino. Nada pasa sin tu confirmación.

¿Va a hacer push o abrir un PR sin que yo lo pida?

No. Al finalizar, N45 pregunta si querés un merge o un PR y a qué rama protegida apuntar. El push en sí queda con vos. Nunca mergea en una protegida ni abre un PR sin tu elección.

¿Para qué sirve la carpeta .n45/worktree/?

Es donde N45 crea worktrees — copias de trabajo aisladas donde cada task corre sin molestar a tu árbol principal. Son temporales: se limpian tras el merge (o vía cleanup-worktree). La carpeta está gitignored.

¿Puedo usar N45 en un proyecto que ya existe?

Sí. La primera vez, N45 analiza tu código y genera la documentación base (STACK, PATTERNS, PROJECT, RUNBOOK) — la "memoria" que usa para respetar tus convenciones. A partir de ahí, cada feature construye sobre ese contexto.

¿N45 va a cambiar mis patrones o mi stack?

No. En un proyecto existente, N45 preserva lo que ya está en uso — no migra tu lenguaje, framework ni base de datos. Lo que la feature introduce como nuevo sigue tus patrones (y, si hay políticas de organización, se conforma a ellas). La regla: preservá lo existente, conformá lo nuevo.

¿Cuándo debería usar un Workspace en vez de un Project?

Usá Project cuando el trabajo vive en un único repositorio (incluso un monorepo — eso es un repositorio). Usá Workspace cuando tu producto vive en varios repositorios y querés features que los atraviesan como una sola cosa. Mirá Qué es un Workspace.

¿Cómo actualizo N45? ¿Y qué es "ejecutá upgrade primero"?

Corré npx n45-ai@latest upgrade — migra el .n45/ y refresca las skills (en un workspace, corre en cada miembro). Si intentás un init con una versión diferente de la que configuró el proyecto, N45 se detiene y pide el upgrade primero: esto garantiza que el .n45/ se migre antes de que las skills nuevas corran contra un schema viejo.

¿N45 envía mi código a algún lado?

N45 en sí no envía tu código a ningún lado. Las llamadas de IA pasan por la conexión existente de tu IDE con tu proveedor (Anthropic, OpenAI, etc.). N45 solo ve las respuestas, nunca tu código como una transmisión separada. Los datos que guarda (.n45/) viven en tu repositorio. Son tuyos.

¿Puedo alternar entre Claude Code, Cursor y Codex?

Sí. Corré npx n45-ai@latest init de nuevo en el mismo proyecto desde la otra IDE — N45 detecta la nueva herramienta e instala la configuración correspondiente junto a la existente. Podés usar las tres indistintamente.

¿Qué lenguajes soporta el análisis de N45?

Cualquier lenguaje. N45 lee código fuente como texto y razona sobre él usando el modelo de tu asistente de IA. Documentos como STACK y PATTERNS reflejan lo que el modelo logra interpretar — típicamente excelente para lenguajes mainstream (Python, TypeScript, Go, Java, C#, Rust, Ruby, etc.) y razonable para el resto.

¿Funciona en monorepos?

Sí. Corré npx n45-ai@latest init en la raíz del monorepo — N45 lee patrones en todos los paquetes. Si tu producto vive en varios repositorios (polyrepo), usá un Workspace, que coordina los repositorios como miembros y planifica/ejecuta features que los atraviesan, desde una sola sesión.

¿Funciona offline?

No. N45 necesita red para validar tu licencia (una verificación ocasional), hacer las llamadas de IA (vía tu IDE) y descargar actualizaciones. El binario corre localmente, pero los workflows que dirigen agentes exigen conexión.

¿Puedo usar N45 en CI?

No por ahora. N45 está diseñado para sesiones interactivas dentro de tu IDE, donde el humano toma las decisiones. Los casos de uso en CI (PRs auto-generados, refactors agendados) están en evaluación pero todavía no se soportan.

¿Qué pasa cuando desinstalo N45?

No hay un uninstall formal — solo borrá .n45/ de tu proyecto. Los archivos de configuración de la IDE (CLAUDE.md, .cursor/rules/, AGENTS.md) guardan el bloque de N45 entre marcadores <!-- n45:start --> y <!-- n45:end -->. Quitá ese bloque (o el archivo entero si lo creó N45) y listo.

Mi IDE no está soportada. ¿Qué puedo hacer?

Hoy N45 soporta Claude Code, Cursor y OpenAI Codex. Si querés soporte para otra herramienta, escribí a support@n45.tech con tu caso de uso.