Novedades

Qué cambió en cada versión de @falcux/ai-first que se puede instalar desde npm, de la más reciente a la primera. Para saber cuál tienes:

npx @falcux/ai-first@latest --version

0.5.1 — 2026-09-22

Es la versión vigente. Trae el punto de control, que se etiquetó como 0.5.0 y no llegó a publicarse.

init escribe el punto de control. .githooks/pre-push corre audit sobre lo que vas a publicar, sin --estricto: sólo un P0 interrumpe el push. .github/workflows/ai-first.yml lo corre con --estricto en cada pull request.
core.hooksPath sólo se fija si estaba vacío. Uno de husky o lefthook no se pisa: se reporta como sugerido.
Tres opciones nuevas para init: --hook-local, --sin-hook y --sin-ci.
El hook no frena un push cuando no encuentra node. Un push desde un cliente gráfico o un IDE no hereda el PATH del shell. Ahora el hook busca node en las rutas habituales y en nvm.sh, y si no lo encuentra avisa en una línea y deja pasar.
El hook no habla con la red. Usa el ai-first del proyecto o del PATH, o npx --no-install, que no descarga.

La entrevista de init. Pregunta fase, perfil del producto, comandos de verificación, secuencia de implementación, agentes en paralelo y manifiesto de versión, y escribe las respuestas en AI-FIRST.md y en cada skill instalada, entre marcas.
protocolo-arranque, la undécima skill. Conduce la definición del proyecto hasta el PRD, la arquitectura y las specs.
El perfil del proyecto en AI-FIRST.md: producto y repositorio. Decide qué skills se instalan. Es opcional.
--entrevista y --sin-entrevista. Un proyecto ya documentado no se entrevista salvo que lo pidas, y sin terminal interactiva no se entrevista nunca.
init sobre una carpeta que no es repositorio la inicializa y sigue, en vez de salir con código 2.

ai-first --version y -v imprimen la versión instalada. Antes, --version terminaba en error.

El README publicado lleva un badge de npm en vez de un número de versión escrito a mano.

init completo. Además de AI-FIRST.md y el registro de decisiones, instala las skills en .agents/skills/, crea el enlace .claude/skills, crea docs/SESSION_LOG.md, docs/changes/CHANGE_LOG.md y docs/changes/pending/, y mantiene un bloque delimitado en AGENTS.md.
--skills <lista>|todas elige qué skills instalar; por defecto, las cinco sin interfaz.
--enlazar instala enlaces simbólicos en vez de copias.
init salta lo que ya existe y sigue, en vez de detenerse si AI-FIRST.md estaba presente.

El molde del documento de cambio pasó de templates/ a la carpeta de protocolo-cambios. El paquete queda en ocho templates.

La instalación que enseñaba el README podía pisar la skill de un proyecto que ya tuviera una con el mismo nombre. Ahora se copia carpeta por carpeta, se salta entera la que ya existe y se dice cuál se saltó.

Se quitaron los cuatro templates de protocolo, que repetían lo que las skills ya dicen.

Primera versión pública.

ai-first audit: las cinco verificaciones, el puntaje de entropía y los códigos de salida, en modo árbol de trabajo y con --base para CI. Código puro: git, sistema de archivos y expresiones regulares.
ai-first init mínimo: escanea el repo y escribe AI-FIRST.md y el registro de decisiones.
Las skills y los templates de la metodología.

Solución de problemasLos problemas conocidos y qué hacer con cada uno.

ai-first initTodas las opciones de la versión vigente.

ai-first auditModos, opciones y códigos de salida.