# Descripción general

> Qué es el paquete @falcux/ai-first, cómo se instala en un comando y qué puedes hacer con él.

`@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

En la raíz de tu proyecto, o en una carpeta vacía:

* npx

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

* pnpm dlx

  ```bash
  pnpm dlx @falcux/ai-first@latest init
  ```

El `@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](https://ai-first.falcux.com/docs/empezar/inicio-rapido/).

## Lo que puedes hacer

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

```text
Usa protocolo-arranque. Quiero construir una app para reservar canchas de fútbol.
```

[Arrancar un producto desde cero](https://ai-first.falcux.com/docs/guias/arrancar-un-producto/)

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

```bash
npx @falcux/ai-first@latest init --entrevista
```

[Adaptar las skills](https://ai-first.falcux.com/docs/guias/adaptar-las-skills/)

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

```text
Usa protocolo-features para agregar la exportación de reservas a CSV.
```

[Desarrollar una feature](https://ai-first.falcux.com/docs/guias/desarrollar-una-feature/)

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

```text
Usa protocolo-cambios: el formulario de reserva pasa de tres pasos a uno.
```

[Cambiar algo que ya funciona](https://ai-first.falcux.com/docs/guias/gestionar-un-cambio/)

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

```text
Usa protocolo-cierre para cerrar la sesión de hoy.
```

[Cerrar la sesión](https://ai-first.falcux.com/docs/guias/cerrar-la-sesion/)

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

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

[Auditar en local y en CI](https://ai-first.falcux.com/docs/guias/auditar-en-local-y-en-ci/)

## 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](https://ai-first.falcux.com/docs/metodologia/).

## Próximos pasos

[Inicio rápido](https://ai-first.falcux.com/docs/empezar/inicio-rapido/)De una carpeta vacía a tu primer audit limpio.

[Qué deja init en tu repo](https://ai-first.falcux.com/docs/empezar/que-instala/)Cada archivo que escribe, para qué sirve y quién lo lee.

[Adoptar en un proyecto existente](https://ai-first.falcux.com/docs/empezar/proyecto-existente/)Qué salta, qué sugiere y qué tienes que revisar.

[Agentes compatibles](https://ai-first.falcux.com/docs/empezar/agentes/)Cómo lee las skills cada herramienta.