Lo que trae el paquete
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
Sección titulada «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.
| 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
Sección titulada «Archivos de contexto»Los que el agente lee al abrir cada sesión.
Documentos de definición
Sección titulada «Documentos de definición»Los que dicen qué se construye y cómo se ve, antes de escribir código.
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.
Documentos vivos
Sección titulada «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 nombra como destino de lo que se aprende, y los que AI-FIRST.md declara en artefactos.
El inventario de componentes es el que vigila la verificación 5. Para que lo vigile, AI-FIRST.md necesita artefactos.inventario_componentes y artefactos.componentes_dir.
El documento de cambio
Sección titulada «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:
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.