@saulwade/swl-ses 2.2.4 → 2.3.1

package/hooks/validar-planning-paths.js

@@ -1,134 +1,134 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * Hook: validar-planning-paths.js
- * Tipo: PostToolUse  (aplica a: Write, Edit, MultiEdit)
- *
- * Advierte cuando una sesion crea un directorio top-level NUEVO en .planning/
- * que NO esta en la allowlist canonica (manifiestos/planning-paths.json).
- * Atrapa divergencias es/en (auditoria/ vs audit/, ux/ vs design/) ANTES de
- * que proliferen.
- *
- * Aplica reglas/analizar-directorios-antes-de-escribir.md y cierra
- * DT-PLANNING-OUTPUT-PATHS. No bloquea (modo warn-only). ADR-0031.
- *
- * Opt-out: SWL_PLANNING_PATHS=0 desactiva el hook.
- *
- * Formato del nudge: kind "planning-path-divergente" -> documentador-swl.
- */
-
-const fs = require('fs');
-const path = require('path');
-const crypto = require('crypto');
-
-if (process.env.SWL_PLANNING_PATHS === '0') process.exit(0);
-
-let evento;
-try {
-  evento = JSON.parse(fs.readFileSync(0, 'utf-8'));
-} catch (_) {
-  process.exit(0);
-}
-
-const toolName = evento?.tool_name;
-const toolInput = evento?.tool_input;
-if (!toolName || !['Write', 'Edit', 'MultiEdit'].includes(toolName)) process.exit(0);
-
-const filePath = toolInput?.file_path;
-if (!filePath) process.exit(0);
-
-const norm = filePath.replace(/\\/g, '/');
-
-// Solo nos interesa lo que cae dentro de .planning/. Soporta path absoluto
-// (con '/.planning/' embebido, lo que Claude Code envia en produccion) y path
-// relativo ('.planning/...'). `resto` es todo lo que sigue a '.planning/'.
-const marcador = '/.planning/';
-let resto;
-const idx = norm.indexOf(marcador);
-if (idx >= 0) {
-  resto = norm.slice(idx + marcador.length);     // path absoluto / embebido
-} else if (norm.startsWith('.planning/')) {
-  resto = norm.slice('.planning/'.length);        // path relativo
-} else {
-  process.exit(0);                                // fuera de .planning/
-}
-
-// resto = "<segmento>/..." o "<archivo>"
-const partes = resto.split('/').filter(Boolean);
-if (partes.length === 0) process.exit(0);
-
-// Si es un archivo directo en .planning/ (sin subdirectorio), es archivo
-// top-level: lo permitimos (ESTADO.md, nudges.jsonl, etc.).
-if (partes.length === 1) process.exit(0);
-
-const topDir = partes[0];
-
-// ─── Allowlist embebida (fallback portable) ────────────────────────────────
-// manifiestos/ NO se propaga a proyectos consumidores; el hook debe ser
-// autosuficiente. En el repo swl-ses se prefiere el manifest (fuente de
-// verdad); en consumidores se usa esta lista. Mantener ambas en sync.
-const DIRS_CANONICOS = [
-  'adrs', 'analysis', 'archive', 'audit', 'auto-evolution', 'backups',
-  'benchmark', 'comms', 'cron', 'design', 'evolution', 'fases', 'gateway',
-  'inbox', 'knowledge', 'locks', 'red-team', 'research', 'runs', 'sessions',
-  'traces', 'user-profile', 'wiki',
-];
-
-// ─── Cargar allowlist (manifest si existe, embebida si no) ──────────────────
-const CWD = process.cwd();
-const allowlistPath = path.join(CWD, 'manifiestos', 'planning-paths.json');
-let permitidos;
-try {
-  const allow = JSON.parse(fs.readFileSync(allowlistPath, 'utf-8'));
-  permitidos = new Set((allow.directorios || []).map((d) => d.nombre));
-} catch (_) {
-  permitidos = new Set(DIRS_CANONICOS);
-}
-if (permitidos.has(topDir)) process.exit(0);
-
-// Directorio top-level NO canonico -> divergencia potencial.
-// Detectar variante es/en conocida para sugerir el canonico correcto.
-const VARIANTES = {
-  auditoria: 'audit', auditorias: 'audit',
-  ux: 'design', ui: 'design', diseno: 'design', 'diseno-visual': 'design',
-  investigacion: 'research', conocimiento: 'knowledge',
-  evolucion: 'evolution', 'auto-evolucion': 'auto-evolution',
-  'perfil-usuario': 'user-profile', archivo: 'archive',
-  sesiones: 'sessions', decisiones: 'adrs',
-};
-const sugerido = VARIANTES[topDir] || null;
-
-// Ruta de display relativa a .planning/, independiente de si el path era
-// absoluto o relativo (resto ya es todo lo que sigue a '.planning/').
-const rutaRelativa = '.planning/' + resto;
-const nudge = {
-  id: crypto.randomBytes(8).toString('hex'),
-  kind: 'planning-path-divergente',
-  target: 'documentador-swl',
-  source: 'hooks/validar-planning-paths.js',
-  message:
-    `[planning-path] Se escribio en \`.planning/${topDir}/\`, un directorio top-level ` +
-    `NO canonico (${rutaRelativa}).\n` +
-    (sugerido
-      ? `  Probable divergencia es/en: usa el canonico \`.planning/${sugerido}/\` en su lugar.\n`
-      : `  Si es un dominio nuevo legitimo, agregalo a \`manifiestos/planning-paths.json\`.\n`) +
-    `  Ver \`reglas/analizar-directorios-antes-de-escribir.md\` y la allowlist canonica.`,
-  data: {
-    dir_detectado: topDir,
-    canonico_sugerido: sugerido,
-    archivo: rutaRelativa,
-  },
-  ts: new Date().toISOString(),
-  accionado: false,
-  accionado_ts: null,
-  accionado_por: null,
-};
-
-try {
-  const nudgesPath = path.join(CWD, '.planning', 'evolution', 'nudges.jsonl');
-  fs.mkdirSync(path.dirname(nudgesPath), { recursive: true });
-  fs.appendFileSync(nudgesPath, JSON.stringify(nudge) + '\n', 'utf-8');
-} catch (_) { /* no fallar el hook */ }
-
-process.exit(0);
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: validar-planning-paths.js
+ * Tipo: PostToolUse  (aplica a: Write, Edit, MultiEdit)
+ *
+ * Advierte cuando una sesion crea un directorio top-level NUEVO en .planning/
+ * que NO esta en la allowlist canonica (manifiestos/planning-paths.json).
+ * Atrapa divergencias es/en (auditoria/ vs audit/, ux/ vs design/) ANTES de
+ * que proliferen.
+ *
+ * Aplica reglas/analizar-directorios-antes-de-escribir.md y cierra
+ * DT-PLANNING-OUTPUT-PATHS. No bloquea (modo warn-only). ADR-0031.
+ *
+ * Opt-out: SWL_PLANNING_PATHS=0 desactiva el hook.
+ *
+ * Formato del nudge: kind "planning-path-divergente" -> documentador-swl.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+if (process.env.SWL_PLANNING_PATHS === '0') process.exit(0);
+
+let evento;
+try {
+  evento = JSON.parse(fs.readFileSync(0, 'utf-8'));
+} catch (_) {
+  process.exit(0);
+}
+
+const toolName = evento?.tool_name;
+const toolInput = evento?.tool_input;
+if (!toolName || !['Write', 'Edit', 'MultiEdit'].includes(toolName)) process.exit(0);
+
+const filePath = toolInput?.file_path;
+if (!filePath) process.exit(0);
+
+const norm = filePath.replace(/\\/g, '/');
+
+// Solo nos interesa lo que cae dentro de .planning/. Soporta path absoluto
+// (con '/.planning/' embebido, lo que Claude Code envia en produccion) y path
+// relativo ('.planning/...'). `resto` es todo lo que sigue a '.planning/'.
+const marcador = '/.planning/';
+let resto;
+const idx = norm.indexOf(marcador);
+if (idx >= 0) {
+  resto = norm.slice(idx + marcador.length);     // path absoluto / embebido
+} else if (norm.startsWith('.planning/')) {
+  resto = norm.slice('.planning/'.length);        // path relativo
+} else {
+  process.exit(0);                                // fuera de .planning/
+}
+
+// resto = "<segmento>/..." o "<archivo>"
+const partes = resto.split('/').filter(Boolean);
+if (partes.length === 0) process.exit(0);
+
+// Si es un archivo directo en .planning/ (sin subdirectorio), es archivo
+// top-level: lo permitimos (ESTADO.md, nudges.jsonl, etc.).
+if (partes.length === 1) process.exit(0);
+
+const topDir = partes[0];
+
+// ─── Allowlist embebida (fallback portable) ────────────────────────────────
+// manifiestos/ NO se propaga a proyectos consumidores; el hook debe ser
+// autosuficiente. En el repo swl-ses se prefiere el manifest (fuente de
+// verdad); en consumidores se usa esta lista. Mantener ambas en sync.
+const DIRS_CANONICOS = [
+  'adrs', 'analysis', 'archive', 'audit', 'auto-evolution', 'backups',
+  'benchmark', 'comms', 'cron', 'design', 'evolution', 'fases', 'gateway',
+  'inbox', 'knowledge', 'locks', 'red-team', 'research', 'runs', 'sessions',
+  'traces', 'user-profile', 'wiki',
+];
+
+// ─── Cargar allowlist (manifest si existe, embebida si no) ──────────────────
+const CWD = process.cwd();
+const allowlistPath = path.join(CWD, 'manifiestos', 'planning-paths.json');
+let permitidos;
+try {
+  const allow = JSON.parse(fs.readFileSync(allowlistPath, 'utf-8'));
+  permitidos = new Set((allow.directorios || []).map((d) => d.nombre));
+} catch (_) {
+  permitidos = new Set(DIRS_CANONICOS);
+}
+if (permitidos.has(topDir)) process.exit(0);
+
+// Directorio top-level NO canonico -> divergencia potencial.
+// Detectar variante es/en conocida para sugerir el canonico correcto.
+const VARIANTES = {
+  auditoria: 'audit', auditorias: 'audit',
+  ux: 'design', ui: 'design', diseno: 'design', 'diseno-visual': 'design',
+  investigacion: 'research', conocimiento: 'knowledge',
+  evolucion: 'evolution', 'auto-evolucion': 'auto-evolution',
+  'perfil-usuario': 'user-profile', archivo: 'archive',
+  sesiones: 'sessions', decisiones: 'adrs',
+};
+const sugerido = VARIANTES[topDir] || null;
+
+// Ruta de display relativa a .planning/, independiente de si el path era
+// absoluto o relativo (resto ya es todo lo que sigue a '.planning/').
+const rutaRelativa = '.planning/' + resto;
+const nudge = {
+  id: crypto.randomBytes(8).toString('hex'),
+  kind: 'planning-path-divergente',
+  target: 'documentador-swl',
+  source: 'hooks/validar-planning-paths.js',
+  message:
+    `[planning-path] Se escribio en \`.planning/${topDir}/\`, un directorio top-level ` +
+    `NO canonico (${rutaRelativa}).\n` +
+    (sugerido
+      ? `  Probable divergencia es/en: usa el canonico \`.planning/${sugerido}/\` en su lugar.\n`
+      : `  Si es un dominio nuevo legitimo, agregalo a \`manifiestos/planning-paths.json\`.\n`) +
+    `  Ver \`reglas/analizar-directorios-antes-de-escribir.md\` y la allowlist canonica.`,
+  data: {
+    dir_detectado: topDir,
+    canonico_sugerido: sugerido,
+    archivo: rutaRelativa,
+  },
+  ts: new Date().toISOString(),
+  accionado: false,
+  accionado_ts: null,
+  accionado_por: null,
+};
+
+try {
+  const nudgesPath = path.join(CWD, '.planning', 'evolution', 'nudges.jsonl');
+  fs.mkdirSync(path.dirname(nudgesPath), { recursive: true });
+  fs.appendFileSync(nudgesPath, JSON.stringify(nudge) + '\n', 'utf-8');
+} catch (_) { /* no fallar el hook */ }
+
+process.exit(0);

package/instintos/autonomia.yaml

@@ -1,27 +1,27 @@
-# Dial de autonomía — SWL-SES (Fase 13, ADR-0037)
-#
-# Presupuesto de autonomía por clase de riesgo. Consumido por hooks/lib/autonomia.js
-# (orquestador y agentes ALTO leen el dial como GUÍA; no es un gate bloqueante en v1).
-#
-# Defaults = los controles vigentes de reglas/seguridad-agentes.md. Este archivo
-# NO relaja ningún control: lo hace visible y ajustable. El dial sube SOLO por
-# decisión explícita del usuario, nunca por conveniencia del agente.
-#
-# Niveles válidos por clase:
-#   total                -> acción autónoma sin checkpoint (lectura/análisis).
-#   con_auto_checkpoint  -> autónoma, pero registra un auto-checkpoint antes de actuar.
-#   hitl                 -> requiere confirmación humana siempre.
-# Cualquier valor desconocido se degrada a 'hitl' (nunca relaja).
-#
-# Estructura PLANA obligatoria (1 nivel bajo `clases:`) — ver 13-PLAN.md.
-
-version: "1.0"
-generado: "2026-06-11"
-defaults: seguridad-agentes.md
-clases:
-  lectura_analisis: total
-  # Subido a `total` por decisión explícita del usuario (2026-06-11, cierre Fase 13):
-  # cambios reversibles autónomos sin auto-checkpoint. Los commits atómicos siguen
-  # siendo el mecanismo de rollback. Default de seguridad-agentes.md era con_auto_checkpoint.
-  cambio_reversible: total
-  migracion_auth_push_publish: hitl
+# Dial de autonomía — SWL-SES (Fase 13, ADR-0037)
+#
+# Presupuesto de autonomía por clase de riesgo. Consumido por hooks/lib/autonomia.js
+# (orquestador y agentes ALTO leen el dial como GUÍA; no es un gate bloqueante en v1).
+#
+# Defaults = los controles vigentes de reglas/seguridad-agentes.md. Este archivo
+# NO relaja ningún control: lo hace visible y ajustable. El dial sube SOLO por
+# decisión explícita del usuario, nunca por conveniencia del agente.
+#
+# Niveles válidos por clase:
+#   total                -> acción autónoma sin checkpoint (lectura/análisis).
+#   con_auto_checkpoint  -> autónoma, pero registra un auto-checkpoint antes de actuar.
+#   hitl                 -> requiere confirmación humana siempre.
+# Cualquier valor desconocido se degrada a 'hitl' (nunca relaja).
+#
+# Estructura PLANA obligatoria (1 nivel bajo `clases:`) — ver 13-PLAN.md.
+
+version: "1.0"
+generado: "2026-06-11"
+defaults: seguridad-agentes.md
+clases:
+  lectura_analisis: total
+  # Subido a `total` por decisión explícita del usuario (2026-06-11, cierre Fase 13):
+  # cambios reversibles autónomos sin auto-checkpoint. Los commits atómicos siguen
+  # siendo el mecanismo de rollback. Default de seguridad-agentes.md era con_auto_checkpoint.
+  cambio_reversible: total
+  migracion_auth_push_publish: hitl

package/instintos/prompt-appendices.yaml

@@ -1,57 +1,57 @@
-# 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.
+# 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.

package/llms.txt

@@ -1,6 +1,6 @@
 # swl-ses (@saulwade/swl-ses)
 
-> Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo), distribuido como paquete npm y plugin de Claude Code. 60 agentes, 182 habilidades, 44 comandos, 37 reglas base y 48 hooks. Soporta 11 lenguajes y 7 runtimes (Claude Code, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot). Versión 2.2.4.
+> Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo), distribuido como paquete npm y plugin de Claude Code. 60 agentes, 182 habilidades, 44 comandos, 37 reglas base y 50 hooks. Soporta 11 lenguajes y 7 runtimes (Claude Code, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot). Versión 2.3.1.
 
 Archivo generado por `node scripts/generar-inventario.js` — no editar a mano. Las cifras se sincronizan con INVENTARIO.md en cada regeneración.
 
@@ -20,7 +20,7 @@ Archivo generado por `node scripts/generar-inventario.js` — no editar a mano.
 - 182 habilidades cargables bajo demanda en `habilidades/` (conocimiento operacional con divulgación progresiva)
 - 44 comandos `/swl:*` en `comandos/swl/` (ciclo GSD, calidad, release, diagnóstico)
 - 37 reglas base + 40 reglas por lenguaje en `reglas/` (políticas obligatorias por matcher)
-- 48 hooks en `hooks/` (telemetría, validación, seguridad; zero-deps, escrituras atómicas)
+- 50 hooks en `hooks/` (telemetría, validación, seguridad; zero-deps, escrituras atómicas)
 
 ## Opcional
 

package/manifiestos/agent-output-schemas.json

@@ -1,57 +1,57 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "descripcion": "Schemas de output esperado por agente — formato compacto declarado en reglas/brevedad-output.md. El hook validar-formato-post-subagente.js usa estos patrones para detectar cuándo un agente devuelve output fuera de contrato.",
-  "version": "1.0.0",
-  "schemas": {
-    "revisor-codigo-swl": {
-      "descripcion": "Revisión de calidad — formato compacto",
-      "patronesRequeridos": [
-        "(?im)VEREDICTO\\s*:\\s*(APROBADO|APROBADO_CON_OBSERVACIONES|RECHAZADO|REQUIERE_CORRECCIONES|CUMPLE|PARCIAL|NO\\s+CUMPLE)",
-        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
-        "(?im)MAYORES\\s*:\\s*\\d+",
-        "(?im)MENORES\\s*:\\s*\\d+",
-        "(?im)HALLAZGOS\\s*:"
-      ]
-    },
-    "revisor-seguridad-swl": {
-      "descripcion": "Revisión de seguridad OWASP — formato compacto",
-      "patronesRequeridos": [
-        "(?im)VEREDICTO\\s*:\\s*(APROBADO|APROBADO_CON_OBSERVACIONES|RECHAZADO|REQUIERE_CORRECCIONES)",
-        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
-        "(?im)MAYORES\\s*:\\s*\\d+",
-        "(?im)HALLAZGOS\\s*:"
-      ]
-    },
-    "revisor-typescript-swl": {
-      "descripcion": "Revisión TypeScript — formato compacto",
-      "patronesRequeridos": [
-        "(?im)VEREDICTO\\s*:\\s*\\w+",
-        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
-        "(?im)HALLAZGOS\\s*:"
-      ]
-    },
-    "revisor-react-swl": {
-      "descripcion": "Revisión React — formato compacto",
-      "patronesRequeridos": [
-        "(?im)VEREDICTO\\s*:\\s*\\w+",
-        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
-        "(?im)HALLAZGOS\\s*:"
-      ]
-    },
-    "revisor-angular-swl": {
-      "descripcion": "Revisión Angular — formato compacto",
-      "patronesRequeridos": [
-        "(?im)VEREDICTO\\s*:\\s*\\w+",
-        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
-        "(?im)HALLAZGOS\\s*:"
-      ]
-    },
-    "tdd-qa-swl": {
-      "descripcion": "QA con TDD — reporte de implementación",
-      "patronesRequeridos": [
-        "(?im)ESTADO\\s*:\\s*(COMPLETADO|PARCIAL|BLOQUEADO)",
-        "(?im)(SLICES|TESTS)\\s*:"
-      ]
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "descripcion": "Schemas de output esperado por agente — formato compacto declarado en reglas/brevedad-output.md. El hook validar-formato-post-subagente.js usa estos patrones para detectar cuándo un agente devuelve output fuera de contrato.",
+  "version": "1.0.0",
+  "schemas": {
+    "revisor-codigo-swl": {
+      "descripcion": "Revisión de calidad — formato compacto",
+      "patronesRequeridos": [
+        "(?im)VEREDICTO\\s*:\\s*(APROBADO|APROBADO_CON_OBSERVACIONES|RECHAZADO|REQUIERE_CORRECCIONES|CUMPLE|PARCIAL|NO\\s+CUMPLE)",
+        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
+        "(?im)MAYORES\\s*:\\s*\\d+",
+        "(?im)MENORES\\s*:\\s*\\d+",
+        "(?im)HALLAZGOS\\s*:"
+      ]
+    },
+    "revisor-seguridad-swl": {
+      "descripcion": "Revisión de seguridad OWASP — formato compacto",
+      "patronesRequeridos": [
+        "(?im)VEREDICTO\\s*:\\s*(APROBADO|APROBADO_CON_OBSERVACIONES|RECHAZADO|REQUIERE_CORRECCIONES)",
+        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
+        "(?im)MAYORES\\s*:\\s*\\d+",
+        "(?im)HALLAZGOS\\s*:"
+      ]
+    },
+    "revisor-typescript-swl": {
+      "descripcion": "Revisión TypeScript — formato compacto",
+      "patronesRequeridos": [
+        "(?im)VEREDICTO\\s*:\\s*\\w+",
+        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
+        "(?im)HALLAZGOS\\s*:"
+      ]
+    },
+    "revisor-react-swl": {
+      "descripcion": "Revisión React — formato compacto",
+      "patronesRequeridos": [
+        "(?im)VEREDICTO\\s*:\\s*\\w+",
+        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
+        "(?im)HALLAZGOS\\s*:"
+      ]
+    },
+    "revisor-angular-swl": {
+      "descripcion": "Revisión Angular — formato compacto",
+      "patronesRequeridos": [
+        "(?im)VEREDICTO\\s*:\\s*\\w+",
+        "(?im)CR[IÍ]TICOS\\s*:\\s*\\d+",
+        "(?im)HALLAZGOS\\s*:"
+      ]
+    },
+    "tdd-qa-swl": {
+      "descripcion": "QA con TDD — reporte de implementación",
+      "patronesRequeridos": [
+        "(?im)ESTADO\\s*:\\s*(COMPLETADO|PARCIAL|BLOQUEADO)",
+        "(?im)(SLICES|TESTS)\\s*:"
+      ]
+    }
+  }
+}