Saltar a contenido

Construir una funcionalidad

Usa /n45-feat siempre que quieras agregar o mejorar algo — un nuevo endpoint, un cambio de UI, un nuevo dominio, cualquier cosa desde una corrección de typo hasta un sistema de autenticación completo.

N45 decide automáticamente entre la ruta rápida (aplicar el cambio directamente) o la ruta estructurada (discovery → spec → roadmap → ejecución completos). La decisión se toma durante la clasificación con base en cuatro condiciones.

Las cuatro condiciones

Las cuatro deben ser verdaderas para la ruta rápida. Si alguna falla, N45 escala a la ruta estructurada.

Condición Qué significa
Intención clara Solicitud específica. Sin decisiones pendientes tipo "¿debería ser X o Y?"
Sin cambio arquitectural Sin nuevo módulo, patrón o abstracción
Sin schema o migration Base de datos intacta — sin CREATE / ALTER / DROP
Sin nuevo contrato público Sin nuevo endpoint, breaking change de API, evento de webhook o flag pública

El flujo

flowchart TD
    Start([/n45-feat]) --> Triage[Clasificación]
    Triage --> Project[Lee patrones del proyecto
STACK · PATTERNS · PROJECT]
    Project --> Ask[Clarificar intención y alcance]
    Ask --> Plan[Presentar plan]
    Plan --> Decision{Condiciones de la
ruta rápida?}
    Decision -->|las 4 cumplidas| Quick[Ruta rápida
branch + ejecutor]
    Decision -->|alguna falla| Structured[Ruta estructurada
discovery + spec + roadmap]
    Quick --> Validation
    Structured --> Validation
    Validation([Validación])

La clasificación siempre corre primero, y siempre lee los documentos fundamentales de tu proyecto — incluso en la ruta rápida. Así es como N45 evita romper patrones arquitecturales en cambios pequeños.

Tras presentar el plan, confirmas antes de que cualquier cambio se aplique:

Confirmar feat
¿Aplicar el cambio propuesto al codebase?

Ruta rápida — ejemplo

"Cambiar el color de fondo del botón primario de azul a violeta."

  1. N45 lee PATTERNS para entender tus convenciones de CSS/estilo
  2. Confirma el alcance: un componente, una línea en un stylesheet
  3. Decide: ruta rápida — las cuatro condiciones se cumplen
  4. Crea una rama dedicada (quick-feat/button-violet)
  5. Lanza el ejecutor con el cambio preciso
  6. Retorna: archivos modificados, resumen, cómo probar
  7. Tú validas → commit → merge

Tiempo total: alrededor de 1 minuto.

Ruta estructurada — ejemplo

"Agregar login con Google OAuth junto a email/contraseña."

  1. N45 lee los patrones del proyecto y confirma el alcance
  2. La clasificación detecta un nuevo contrato público (endpoint /auth/google) — falla la condición 4
  3. Decide: ruta estructurada
  4. Ejecuta discovery completo — explora código de auth, pregunta sobre modelo de sesión, scopes, URLs de redirect
  5. Genera un spec — flujos propuestos, endpoints, persistencia, casos de error
  6. Tú revisas y apruebas el spec
  7. N45 genera un roadmap con fases (DB → backend → frontend → tests)
  8. Cada fase pasa por agentes dedicados (ejecutor + revisor por task)
  9. Tras todas las fases pasar la revisión, entras en validación
  10. Aprobado → merge o PR

Tiempo total: minutos a horas dependiendo del alcance. Eres consultado en cada decisión relevante.

Qué se crea

  • Ruta rápida: una rama, un commit, opcionalmente un PR
  • Ruta estructurada: lo anterior, más artefactos permanentes dentro de .n45/:
    • Un documento de discovery
    • Un spec
    • Un roadmap con tasks
    • Una retrospectiva al cierre

Estos artefactos permiten que las ejecuciones futuras construyan sobre el contexto previo — incluso el tuyo, semanas después.

Mira también