# Templates

> Los ocho templates de documento del paquete y el molde del documento de cambio: qué documento sale de cada uno, dónde vive y quién lo escribe.

Un template es el molde de un documento del proyecto: trae la estructura, las secciones y lo que va en cada una. El paquete trae ocho, más el molde del documento de cambio, que vive dentro de su skill. Viajan en el paquete npm, en su carpeta `templates/`, y cada tarjeta de esta página abre el archivo tal como está publicado.

## Quién los usa

**Los templates ya no se rellenan a mano.** `protocolo-arranque` escribe cada documento a partir del suyo, en su ruta definitiva del repo, después de un descubrimiento que cierra los vacíos y de registrar la decisión de stack en el ADR. El perfil del producto, que declara `AI-FIRST.md`, decide cuáles escribe: un producto sin interfaz no lleva guía de diseño ni inventario de componentes. Qué hace la skill está en [Las 11 skills](https://ai-first.falcux.com/docs/referencia/skills/#protocolo-arranque).

| Template                        | Documento en tu proyecto                 | Lo escribe                                                                                 | Cuándo                                                          |
| ------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| `PRD_TEMPLATE.md`               | `docs/PRD.md`                            | `protocolo-arranque`                                                                       | Siempre                                                         |
| `ARQUITECTURA_TEMPLATE.md`      | `docs/ARQUITECTURA.md`                   | `protocolo-arranque`                                                                       | Siempre                                                         |
| `SPEC_MODULO_TEMPLATE.md`       | `docs/specs/<modulo>.md`                 | `protocolo-arranque`                                                                       | Una por módulo; en una landing, una sola, `docs/specs/sitio.md` |
| `GUIA_DISENO_TEMPLATE.md`       | `docs/GUIA_DISENO.md`                    | `protocolo-arranque`                                                                       | Si el producto tiene interfaz: `saas`, `landing`, `movil`       |
| `COMPONENT_LIBRARY_TEMPLATE.md` | `docs/COMPONENTES.md`                    | `protocolo-arranque`                                                                       | Si el producto tiene interfaz                                   |
| `TECH_NOTES_TEMPLATE.md`        | `docs/TECH_NOTES.md`                     | `protocolo-arranque`                                                                       | Siempre                                                         |
| `AGENTS_MD_TEMPLATE.md`         | `AGENTS.md`                              | `init` crea el archivo con su bloque; `protocolo-arranque` lo completa fuera de las marcas | Siempre                                                         |
| `CLAUDE_MD_TEMPLATE.md`         | `CLAUDE.md`                              | Tú: es una línea, `@AGENTS.md`                                                             | Si usas Claude Code                                             |
| `documento-de-cambio.md`        | `docs/changes/pending/CHG-XXX_nombre.md` | `protocolo-cambios`                                                                        | Al abrir cada cambio                                            |

Si prefieres escribir un documento sin la skill, el template sirve igual: copia el molde, reemplaza los marcadores `{...}` con lo de tu proyecto y quita las secciones marcadas `[OPCIONAL]` que no apliquen. Funcionan con cualquier agente, no sólo con Claude Code.

## Archivos de contexto

Los que el agente lee al abrir cada sesión.

[AGENTS\_MD\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/AGENTS_MD_TEMPLATE.md)Fuente de verdad cross-tool (\~150 líneas)

[CLAUDE\_MD\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/CLAUDE_MD_TEMPLATE.md)Puntero liviano + ecosistema de archivos

## Documentos de definición

Los que dicen qué se construye y cómo se ve, antes de escribir código.

[PRD\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/PRD_TEMPLATE.md)PRD completo (10 secciones)

[GUIA\_DISENO\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/GUIA_DISENO_TEMPLATE.md)Guía de diseño organizada por sistema: tokens, tipografía, layout en niveles, móvil, formularios y cicatrices (18 secciones)

[SPEC\_MODULO\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/SPEC_MODULO_TEMPLATE.md)La spec autocontenida de un módulo, que la AI carga sólo cuando trabaja en él; con el índice de docs/specs/ como apéndice

Cada spec lleva una sección «Archivos» o «Alcance» con las rutas entre acentos graves: es la que lee la verificación de [alcance excedido](https://ai-first.falcux.com/docs/referencia/verificaciones/#alcance-excedido).

## Documentos vivos

Crecen con el proyecto y se mantienen en el mismo commit que el código. Son los que el capítulo [Gobierno del contexto](https://ai-first.falcux.com/docs/parte-2/gobierno-del-contexto/) nombra como destino de lo que se aprende, y los que `AI-FIRST.md` declara en `artefactos`.

[ARQUITECTURA\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/ARQUITECTURA_TEMPLATE.md)Documento de estado del plano técnico: stack, capas y reglas de dependencia, mapa de módulos, ambientes. El porqué va al ADR

[TECH\_NOTES\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/TECH_NOTES_TEMPLATE.md)Catálogo de cicatrices técnicas por stack: síntoma, causa, solución y fecha para poder podarlas

[COMPONENT\_LIBRARY\_TEMPLATE.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/templates/COMPONENT_LIBRARY_TEMPLATE.md)Inventario vivo de componentes UI por capas: cuándo usar cada uno, cuándo no y qué usar en su lugar

El inventario de componentes es el que vigila la [verificación 5](https://ai-first.falcux.com/docs/referencia/verificaciones/#inventario-de-componentes-desactualizado). Para que lo vigile, `AI-FIRST.md` necesita `artefactos.inventario_componentes` y `artefactos.componentes_dir`.

## El documento de cambio

Los cuatro protocolos de la Parte III ya no se descargan como documento: su versión vigente es la skill. El de cambios exige producir un documento propio antes de tocar código, y éste es su molde:

[documento-de-cambio.md](https://raw.githubusercontent.com/HoruxDeEdfu/falcux-ai-first-package/prod/skills/protocolo-cambios/references/documento-de-cambio.md)El CHG que el protocolo de cambios exige antes de tocar código: impacto, plan, validación y rollback. Vive dentro de su skill, que lo consulta al abrir un cambio

Cada CHG nace en `docs/changes/pending/` del proyecto: ahí lo lee la verificación de alcance y ahí lo revisa un humano en el pull request. El molde vive dentro de la skill porque tiene una sola dueña; los demás templates se quedan aparte porque son documentos permanentes que el `AI-FIRST.md` declara.

Nota

**Las skills no se descargan desde aquí.** Las instala `init`, y el catálogo con el enlace a cada `SKILL.md` está en [Las 11 skills](https://ai-first.falcux.com/docs/referencia/skills/). Cómo instalarlas está en [Inicio rápido](https://ai-first.falcux.com/docs/empezar/inicio-rapido/), y cómo hacerlo en un repo que ya tiene las suyas, en [Adoptar en un proyecto existente](https://ai-first.falcux.com/docs/empezar/proyecto-existente/).

## Relacionado

[Arrancar un producto desde cero](https://ai-first.falcux.com/docs/guias/arrancar-un-producto/)Cómo protocolo-arranque escribe estos documentos a partir de sus templates.

[La cadena de artefactos](https://ai-first.falcux.com/docs/parte-2/cadena-de-artefactos/)Qué alimenta cada documento y en qué orden se escriben.

[Las 11 skills](https://ai-first.falcux.com/docs/referencia/skills/)Las skills del paquete, con su enlace de descarga.
