# Novedades

> Qué cambió en cada versión de @falcux/ai-first publicada en npm, de la más reciente a la primera.

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:

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

Nota

Dos versiones se etiquetaron y nunca llegaron a npm: la 0.5.0, cuyo contenido entero trae la 0.5.1, y la 0.1.4, que incluye la 0.2.0. Por eso no aparecen como versiones propias.

## 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.

## 0.4.0 — 2026-09-21

* **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.

## 0.3.0 — 2026-09-21

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

## 0.2.1 — 2026-09-21

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

## 0.2.0 — 2026-09-18

* **`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.

## 0.1.3 — 2026-09-18

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

## 0.1.2 — 2026-09-18

* 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ó.

## 0.1.1 — 2026-09-18

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

## 0.1.0 — 2026-09-18

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.

## Relacionado

[Solución de problemas](https://ai-first.falcux.com/docs/guias/solucion-de-problemas/)Los problemas conocidos y qué hacer con cada uno.

[ai-first init](https://ai-first.falcux.com/docs/referencia/init/)Todas las opciones de la versión vigente.

[ai-first audit](https://ai-first.falcux.com/docs/referencia/audit/)Modos, opciones y códigos de salida.
