# instintos/prompt-appendices.yaml
#
# Catálogo de apéndices reusables para construcción dinámica de prompts/
# instrucciones via `scripts/lib/prompt-builder.js`. Comandos `/swl:*` y
# agentes pueden referenciar estos apéndices por nombre al construir mensajes
# para subagentes o para output al usuario.
#
# Patrón adaptado de claudian (Yishen Tu, MIT) — buildSystemPrompt() con
# apéndices declarativos.
#
# Schema:
#   <nombre_apendice>: |
#     Texto del apéndice. Puede contener placeholders {clave} que se
#     interpolan con el contexto al construir el prompt.
#
# Soporta operadores YAML `>` (folded — colapsa newlines a espacios) y
# `|` (literal — preserva newlines). Sin anidamiento profundo.
#
# Uso desde código:
#   const pb = require('./scripts/lib/prompt-builder');
#   const ap = pb.cargarApendices();
#   const msg = pb.construirPrompt({
#     base: 'Implementa la fase {fase}.',
#     contexto: { fase: '03-validacion' },
#     appendices: ['estilo_respuesta_breve', 'restricciones_dominio'],
#     apendicesDisponibles: ap,
#   });

estilo_respuesta_breve: >
  Responde directo y conciso. Sin preámbulos de cortesía
  ("Por supuesto", "Claro"), sin cierres genéricos
  ("Espero que ayude"). Resultado primero, contexto solo
  si es no-obvio. Máximo 100 palabras salvo que la tarea
  requiera más detalle.

estilo_respuesta_detallado: >
  Responde con detalle técnico. Incluye contexto, ejemplos
  cuando ayuden a clarificar, y trade-offs si hay decisiones
  no obvias. Estructura con encabezados o tablas si el
  contenido lo justifica.

restricciones_dominio: |
  Restricciones de dominio del proyecto SWL-SES:
  - Stack: Node.js zero-dependencies en hooks/lib/ y scripts/lib/
  - Idioma: 100% español de México
  - Filosofía: integración ligera y reutilización, no reescritura
  - Antes de invocar herramientas externas opt-in, verificar disponibilidad
    con `command -v` (Bash) o `execSync('<bin> --version', { stdio: 'ignore' })`
    (Node) y caer al flujo nativo si no están

contexto_proyecto: >
  Proyecto: {proyecto}. Fase: {fase}. Working directory: {cwd}.

referencia_planning: >
  Antes de modificar archivos, lee `.planning/CONTEXTO.md`,
  `.planning/ESTADO.md` y `CLAUDE.md` del proyecto. No editar
  código que no se ha leído primero.