El paquete
Descripción general
@falcux/ai-first es gobierno del contexto para proyectos que se construyen con
agentes de código. Trae tres piezas: los templates de los documentos que el
agente necesita leer, las skills que le dicen cómo trabajar en cada tipo de
tarea y el detector de entropía, que mide cuánto se alejó lo que el proyecto
documenta de lo que el proyecto es. La CLI nunca llama a un modelo ni a la red:
entrega el procedimiento; la inferencia la pone tu propio agente.
Comenzar
Sección titulada «Comenzar»En la raíz de tu proyecto, o en una carpeta vacía:
npx @falcux/ai-first@latest initpnpm dlx @falcux/ai-first@latest initEl @latest evita que npx reutilice una versión vieja de su caché. init
escribe AI-FIRST.md, el registro de decisiones y la carpeta de cambios,
instala las skills, deja el hook de git y el flujo de CI, y nunca sobreescribe
nada que ya exista. Si es tu primera vez, sigue el inicio rápido.
Lo que puedes hacer
Sección titulada «Lo que puedes hacer»Arrancar un producto desde una idea
Sección titulada «Arrancar un producto desde una idea»Con la entrevista, init instala protocolo-arranque. Tu agente la conduce
hasta el PRD, la arquitectura y las primeras specs, con la decisión de stack
registrada en el ADR.
Usa protocolo-arranque. Quiero construir una app para reservar canchas de fútbol.Arrancar un producto desde cero
Adaptar las skills a tu proyecto
Sección titulada «Adaptar las skills a tu proyecto»La entrevista escribe tus comandos, tu fase y tu orden de implementación dentro de cada skill instalada, entre marcas que respeta en la siguiente corrida.
npx @falcux/ai-first@latest init --entrevistaDesarrollar una feature con spec antes que código
Sección titulada «Desarrollar una feature con spec antes que código»protocolo-features recorre la pre-implementación y la secuencia por capas
antes de que el agente escriba una línea.
Usa protocolo-features para agregar la exportación de reservas a CSV.Cambiar algo que ya funciona sin romperlo
Sección titulada «Cambiar algo que ya funciona sin romperlo»protocolo-cambios clasifica el cambio, abre su documento en
docs/changes/pending/ y analiza el impacto antes de tocar nada.
Usa protocolo-cambios: el formulario de reserva pasa de tres pasos a uno.Cerrar la sesión sin perder el contexto
Sección titulada «Cerrar la sesión sin perder el contexto»protocolo-cierre escribe el registro de sesión, actualiza la documentación y
envía cada aprendizaje a su sitio.
Usa protocolo-cierre para cerrar la sesión de hoy.Auditar la entropía, en local y en CI
Sección titulada «Auditar la entropía, en local y en CI»audit corre cinco verificaciones en código puro y devuelve un puntaje de 0 a
100. El hook de pre-push y el flujo de CI que deja init lo corren por ti.
npx @falcux/ai-first@latest auditQuiero… → Usa…
Sección titulada «Quiero… → Usa…»| Quiero… | Usa… |
|---|---|
| Preparar un repo para la metodología | npx @falcux/ai-first@latest init |
| Que las skills conozcan mis comandos y mi fase | init --entrevista |
| Definir el producto antes de programar | la skill protocolo-arranque |
| Implementar algo nuevo | la skill protocolo-features |
| Modificar algo que ya funciona | la skill protocolo-cambios |
| Cerrar una sesión de trabajo | la skill protocolo-cierre |
| Saber si la documentación sigue diciendo la verdad | npx @falcux/ai-first@latest audit |
| Cortar un pull request por cualquier hallazgo | audit --estricto, que ya corre en .github/workflows/ai-first.yml |
| Saber qué versión tengo | npx @falcux/ai-first@latest --version |
El porqué de cada pieza —por qué un registro de decisiones, por qué Zonas Prohibidas, por qué un protocolo antes de cada tarea— está en la pestaña Metodología.