@saulwade/swl-ses 1.0.1 → 1.1.2

package/agentes/disenador-ui-swl.md

@@ -13,23 +13,21 @@ description: >
   existentes. A diferencia del ux-disenador-swl que cubre UX y UI juntos, este
   agente se especializa SOLO en la capa visual y de interacción — no conduce
   investigación de usuarios ni produce wireframes de flujo.
-tools: Read, Write, Grep, Glob, WebSearch
+tools: [Read, Write, Grep, Glob, WebSearch]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: pink
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: design-tokens, wireframes-flujos, ux-diseno, accesibilidad-a11y, css-moderno, diseno-responsivo, brand-guidelines, canvas-design, algorithmic-art
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
+skillsInvocables: [design-tokens, wireframes-flujos, ux-diseno, accesibilidad-a11y, css-moderno, diseno-responsivo, brand-guidelines, canvas-design, algorithmic-art]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns]
 permisosRed: true
 permisosEscritura: true
 permisosComandos: false
 evolvable: true  # nivelRiesgo=BAJO
+fase: plan
+dominio: ux
 exclusiones:
   - "No invocar para investigación de usuarios ni wireframes de flujo — ese trabajo corresponde a investigador-ux-swl; este agente solo actúa sobre el conocimiento del usuario ya obtenido."
   - "No invocar para implementar estilos en código: este agente produce especificaciones visuales, no código CSS o Tailwind; usar frontend-css-swl o frontend-tailwind-swl para eso."

package/agentes/documentador-swl.md

@@ -8,19 +8,21 @@ description: >
   operativo, cuando se toma una decisión arquitectónica relevante, o cuando la
   documentación existente está desactualizada. No genera docs vacíos, genéricos
   ni de relleno — solo documentación que un humano real necesitaría.
-tools: Read, Write, Edit, Bash, Grep, Glob
+tools: [Read, Write, Edit, Bash, Grep, Glob]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: cyan
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: doc-sync, api-rest-diseno, deprecacion-migracion, pdf, pptx, docx, xlsx, internal-comms, doc-coauthoring, swl-markitdown, diagrama-arquitectura, generacion-mermaid
-skillsRestringidos: ninguno
+skillsInvocables: [doc-sync, api-rest-diseno, deprecacion-migracion, pdf, pptx, docx, xlsx, internal-comms, doc-coauthoring, swl-markitdown, diagrama-arquitectura, generacion-mermaid]
+skillsRestringidos: []
 permisosRed: false
 permisosEscritura: true
 permisosComandos: false
 evolvable: true  # nivelRiesgo=BAJO
+fase: meta
+dominio: docs
 exclusiones:
   - "No invocar para implementar código de producción — este agente documenta código ya implementado, no lo construye."
   - "No invocar para generar tests — ese trabajo corresponde a tdd-qa-swl."

package/agentes/frontend-angular-swl.md

@@ -11,7 +11,7 @@ description: >
   de migración de NgModules a standalone, o cuando se necesita modernizar código
   con signals. NO invocar para versiones de Angular anteriores a v17 sin validar
   primero. NO invocar para backend, APIs o bases de datos.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -19,16 +19,8 @@ permissionMode: acceptEdits
 color: red
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: angular-moderno, angular-avanzado, typescript-avanzado, css-moderno, accesibilidad-a11y, diseno-responsivo, manejo-errores, web-artifacts-builder, webapp-testing
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - python-testing-patterns
-  - dataverse-python-production-code
-  - vercel-react-best-practices
-  - react-native-best-practices
+skillsInvocables: [angular-moderno, angular-avanzado, typescript-avanzado, css-moderno, accesibilidad-a11y, diseno-responsivo, manejo-errores, web-artifacts-builder, webapp-testing]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, python-testing-patterns, dataverse-python-production-code, vercel-react-best-practices, react-native-best-practices]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -43,6 +35,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: frontend
 exclusiones:
   - "No invocar para frameworks distintos a Angular — para React/Next.js usar frontend-react-swl, para otros frameworks usar frontend-swl."
   - "No invocar para backend, APIs o bases de datos — ese trabajo corresponde a backend-*-swl o implementador-swl."

package/agentes/frontend-css-swl.md

@@ -13,7 +13,7 @@ description: >
   arquitectónica, o cuando hay problemas de performance de rendering relacionados
   con CSS. NO invocar para lógica de componentes JavaScript — eso corresponde
   a frontend-react-swl o frontend-angular-swl.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -21,14 +21,8 @@ permissionMode: acceptEdits
 color: violet
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: css-moderno, diseno-responsivo, design-tokens, tailwind-experto, accesibilidad-a11y, brand-guidelines, theme-factory
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - python-testing-patterns
-  - dataverse-python-production-code
+skillsInvocables: [css-moderno, diseno-responsivo, design-tokens, tailwind-experto, accesibilidad-a11y, brand-guidelines, theme-factory]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, python-testing-patterns, dataverse-python-production-code]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -37,6 +31,8 @@ toolBudget:
   standard: 30
   complex: 60
 evolvable: true  # nivelRiesgo=BAJO
+fase: implement
+dominio: frontend
 exclusiones:
   - "No invocar para lógica de componentes JavaScript — eso corresponde a frontend-react-swl o frontend-angular-swl."
   - "No invocar cuando el proyecto usa Tailwind CSS como sistema de estilos principal — usar frontend-tailwind-swl."

package/agentes/frontend-react-swl.md

@@ -14,7 +14,7 @@ description: >
   o cuando se necesita migrar código class-based a funcional moderno. NO invocar
   para backend, APIs o bases de datos — eso corresponde a implementador-swl. NO
   invocar sin especificación mínima para features complejas.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -22,14 +22,8 @@ permissionMode: acceptEdits
 color: cyan
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: react-experto, react-optimizacion, typescript-avanzado, css-moderno, accesibilidad-a11y, diseno-responsivo, nextjs-experto, nextjs-patrones, nextjs-testing, manejo-errores, web-artifacts-builder, webapp-testing
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - python-testing-patterns
-  - dataverse-python-production-code
+skillsInvocables: [react-experto, react-optimizacion, typescript-avanzado, css-moderno, accesibilidad-a11y, diseno-responsivo, nextjs-experto, nextjs-patrones, nextjs-testing, manejo-errores, web-artifacts-builder, webapp-testing]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, python-testing-patterns, dataverse-python-production-code]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -44,6 +38,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: frontend
 exclusiones:
   - "No invocar para frameworks distintos a React o Next.js — para Angular usar frontend-angular-swl, para Vue/Svelte usar frontend-swl."
   - "No invocar para lógica de servidor, APIs o bases de datos — ese trabajo corresponde a backend-*-swl o implementador-swl."

package/agentes/frontend-swl.md

@@ -9,7 +9,7 @@ description: >
   rendimiento (bundle, lazy loading, Core Web Vitals) y escribe tests de
   componentes. NO invocar sin UI-SPEC.md para features complejas — primero
   ux-disenador-swl. NO invocar para backend, APIs o bases de datos.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -17,14 +17,8 @@ permissionMode: acceptEdits
 color: cyan
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: frontend-avanzado, css-moderno, typescript-avanzado, accesibilidad-a11y, diseno-responsivo, manejo-errores, web-artifacts-builder, webapp-testing
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - python-testing-patterns
-  - dataverse-python-production-code
+skillsInvocables: [frontend-avanzado, css-moderno, typescript-avanzado, accesibilidad-a11y, diseno-responsivo, manejo-errores, web-artifacts-builder, webapp-testing]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, python-testing-patterns, dataverse-python-production-code]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -39,6 +33,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: frontend
 exclusiones:
   - "No invocar cuando el framework es React o Next.js — usar frontend-react-swl para esos casos."
   - "No invocar cuando el framework es Angular v17+ — usar frontend-angular-swl para esos casos."

package/agentes/frontend-tailwind-swl.md

@@ -13,7 +13,7 @@ description: >
   cuando hay que configurar un design system en Tailwind, o cuando hay deuda
   técnica de inconsistencia visual en un proyecto Tailwind. NO invocar para CSS
   puro sin Tailwind — usar frontend-css-swl en ese caso.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -21,14 +21,8 @@ permissionMode: acceptEdits
 color: teal
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: tailwind-experto, css-moderno, design-tokens, diseno-responsivo, brand-guidelines, theme-factory
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - python-testing-patterns
-  - dataverse-python-production-code
+skillsInvocables: [tailwind-experto, css-moderno, design-tokens, diseno-responsivo, brand-guidelines, theme-factory]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, python-testing-patterns, dataverse-python-production-code]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -37,6 +31,8 @@ toolBudget:
   standard: 30
   complex: 60
 evolvable: true  # nivelRiesgo=BAJO
+fase: implement
+dominio: frontend
 exclusiones:
   - "No invocar para CSS puro sin Tailwind — usar frontend-css-swl en ese caso."
   - "No invocar para lógica de componentes JavaScript o TypeScript — eso corresponde a frontend-react-swl o frontend-angular-swl."

package/agentes/implementador-swl.md

@@ -8,15 +8,15 @@ description: >
   y documentado. Requiere PLAN.md aprobado. Sigue vertical slices, carga skills
   relevantes y hace commits atomicos por tarea. No invocar sin plan previo para
   features complejas — primero planificador-swl.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: yellow
 version: 1.1.0
 nivelRiesgo: MEDIO
-skillsInvocables: patrones-python, fastapi-experto, django-experto, angular-moderno, angular-avanzado, postgresql-experto, testing-python, api-rest-diseno, async-python, auth-patrones, manejo-errores, typescript-avanzado, rails-experto, php-experto, php-patrones, filament-admin, agent-browser
-skillsRestringidos: auto-evolucion-protocolo
+skillsInvocables: [patrones-python, fastapi-experto, django-experto, angular-moderno, angular-avanzado, postgresql-experto, testing-python, api-rest-diseno, async-python, auth-patrones, manejo-errores, typescript-avanzado, rails-experto, php-experto, php-patrones, filament-admin, agent-browser]
+skillsRestringidos: [auto-evolucion-protocolo]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -29,6 +29,7 @@ toolBudget:
   simple: 15
   standard: 30
   complex: 60
+maxTurnos: 15  # write-complete-test-once: máximo 2 iteraciones por error + overhead
 evolvable: true
 evolvable_scope: [description, examples, instructions]
 invariantes:
@@ -36,6 +37,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: general
 exclusiones:
   - "No invocar para backend Python puro — usar backend-python-swl que tiene mayor profundidad en async SQLAlchemy, FastAPI avanzado y Django."
   - "No invocar para backend Node.js puro — usar backend-node-swl para mayor profundidad en NestJS, Prisma y ecosistema Node."

package/agentes/investigador-swl.md

@@ -9,19 +9,21 @@ description: >
   cuando el equipo necesita entender el estado del arte de un dominio.
   No escribe código de producción — produce análisis y recomendaciones.
   Guarda outputs en .planning/knowledge/outputs/ para reutilización futura.
-tools: Read, Grep, Glob, WebSearch, WebFetch, Bash, Write
+tools: [Read, Grep, Glob, WebSearch, WebFetch, Bash, Write, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: blue
 version: 1.1.0
 nivelRiesgo: BAJO
-skillsInvocables: todos
-skillsRestringidos: ninguno
+skillsInvocables: [todos]
+skillsRestringidos: []
 permisosRed: true
 permisosEscritura: true
 permisosComandos: true
 evolvable: true  # nivelRiesgo=BAJO
+fase: discover
+dominio: general
 exclusiones:
   - "No invocar para implementar código — el investigador produce análisis y recomendaciones, no código de producción; usar implementador-swl para eso."
   - "No invocar para tomar decisiones de arquitectura definitivas — produce insumos para arquitecto-swl, quien es el responsable de las decisiones finales."

package/agentes/investigador-ux-swl.md

@@ -11,25 +11,21 @@ description: >
   usabilidad, o cuando el equipo necesita validar hipótesis de diseño con datos.
   NO escribe código ni produce especificaciones visuales — produce conocimiento
   del usuario que alimenta al disenador-ui-swl y al ux-disenador-swl.
-tools: Read, Write, Grep, Glob, WebSearch
+tools: [Read, Write, Grep, Glob, WebSearch]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: rose
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: ux-diseno, wireframes-flujos, accesibilidad-a11y, extraccion-documentos
-skillsRestringidos:
-  - fastapi-python
-  - django-expert
-  - postgresql-table-design
-  - python-patterns
-  - angular-component
-  - angular-forms
+skillsInvocables: [ux-diseno, wireframes-flujos, accesibilidad-a11y, extraccion-documentos]
+skillsRestringidos: [fastapi-python, django-expert, postgresql-table-design, python-patterns, angular-component, angular-forms]
 permisosRed: true
 permisosEscritura: true
 permisosComandos: false
 evolvable: true  # nivelRiesgo=BAJO
+fase: discover
+dominio: ux
 exclusiones:
   - "No invocar para escribir especificaciones visuales o wireframes — eso corresponde a disenador-ui-swl o ux-disenador-swl; este agente produce conocimiento del usuario, no diseño."
   - "No invocar para investigación tecnológica o evaluación de frameworks — ese trabajo corresponde a investigador-swl."

package/agentes/llm-apps-swl.md

@@ -7,7 +7,7 @@ description: >
   herramientas, fine-tuning de modelos, evaluación con RAGAS, o integración de
   Claude/OpenAI/Ollama en una aplicación. NO invocar para backend general sin
   componentes LLM — usar backend-python-swl.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-opus-4-7
 ventanaContexto: 200k
@@ -15,8 +15,8 @@ permissionMode: acceptEdits
 color: purple
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: langchain-langraph, rag-arquitectura, prompt-engineering, fastapi-experto, async-python, testing-python, structured-outputs, agentes-como-servicio, wiki-conocimiento, diseno-herramientas-agente
-skillsRestringidos: angular-moderno, mobile-flutter
+skillsInvocables: [langchain-langraph, rag-arquitectura, prompt-engineering, fastapi-experto, async-python, testing-python, structured-outputs, agentes-como-servicio, wiki-conocimiento, diseno-herramientas-agente]
+skillsRestringidos: [angular-moderno, mobile-flutter]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -31,6 +31,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: backend
 exclusiones:
   - "No invocar para backend general sin componentes LLM — usar backend-python-swl para FastAPI/Django sin IA."
   - "No invocar para frontend ni mobile — ese trabajo corresponde a frontend-*-swl o mobile-*-swl."

package/agentes/migrador-swl.md

@@ -8,15 +8,15 @@ description: >
   refactorizar un módulo completo sin cambiar su comportamiento observable,
   o cambiar un contrato de API con retrocompatibilidad. No invocar para migraciones
   pequeñas de una sola tabla sin riesgo de datos — usar desarrollador-swl directamente.
-tools: Read, Write, Edit, Bash, Grep, Glob
+tools: [Read, Write, Edit, Bash, Grep, Glob]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: yellow
 version: 1.0.0
 nivelRiesgo: ALTO
-skillsInvocables: postgresql-experto, sql-optimizacion, deprecacion-migracion, datos-etl
-skillsRestringidos: ninguno
+skillsInvocables: [postgresql-experto, sql-optimizacion, deprecacion-migracion, datos-etl]
+skillsRestringidos: []
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -24,7 +24,10 @@ toolBudget:
   simple: 15
   standard: 30
   complex: 60
+maxTurnos: 25  # 6 fases iterativas + ciclos test-fail-fix; expand-contract con 3 fases
 evolvable: false  # nivelRiesgo=ALTO
+fase: implement
+dominio: data
 exclusiones:
   - "No invocar para migraciones pequeñas de una sola tabla sin riesgo de datos — usar implementador-swl directamente."
   - "No invocar para diseño de pipelines de datos analíticos — ese trabajo corresponde a datos-swl."

package/agentes/mobile-android-swl.md

@@ -11,7 +11,7 @@ description: >
   multiplataforma o backend — esos corresponden a mobile-ios-swl,
   mobile-cross-swl e implementador-swl respectivamente. Siempre carga
   manejo-errores antes de implementar cualquier capa de red o base de datos.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -19,8 +19,8 @@ permissionMode: acceptEdits
 color: green
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: manejo-errores, auth-patrones, accesibilidad-a11y, kotlin-experto, kotlin-compose, kotlin-testing
-skillsRestringidos: fastapi-experto, angular-moderno, react-native-best-practices
+skillsInvocables: [manejo-errores, auth-patrones, accesibilidad-a11y, kotlin-experto, kotlin-compose, kotlin-testing]
+skillsRestringidos: [fastapi-experto, angular-moderno, react-native-best-practices]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -35,6 +35,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: mobile
 exclusiones:
   - "No invocar para desarrollo iOS — ese trabajo corresponde a mobile-ios-swl."
   - "No invocar para desarrollo multiplataforma (React Native, Flutter) — usar mobile-cross-swl."

package/agentes/mobile-cross-swl.md

@@ -12,7 +12,7 @@ description: >
   invocar para desarrollo Android o iOS nativo puro — esos corresponden a
   mobile-android-swl y mobile-ios-swl. Siempre carga typescript-avanzado cuando
   el stack es React Native.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill, WebSearch
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill, WebSearch]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -20,8 +20,8 @@ permissionMode: acceptEdits
 color: purple
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: accesibilidad-a11y, manejo-errores, auth-patrones, typescript-avanzado, mobile-flutter, mobile-react-native
-skillsRestringidos: django-experto, fastapi-experto, postgresql-experto
+skillsInvocables: [accesibilidad-a11y, manejo-errores, auth-patrones, typescript-avanzado, mobile-flutter, mobile-react-native]
+skillsRestringidos: [django-experto, fastapi-experto, postgresql-experto]
 permisosRed: true
 permisosEscritura: true
 permisosComandos: true
@@ -36,6 +36,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: mobile
 exclusiones:
   - "No invocar para desarrollo Android nativo puro con Kotlin/Compose — usar mobile-android-swl."
   - "No invocar para desarrollo iOS nativo puro con Swift/SwiftUI — usar mobile-ios-swl."

package/agentes/mobile-ios-swl.md

@@ -11,7 +11,7 @@ description: >
   esos corresponden a mobile-android-swl, implementador-swl y
   mobile-cross-swl. Siempre carga manejo-errores antes de implementar
   cualquier capa de red o persistencia.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -19,8 +19,8 @@ permissionMode: acceptEdits
 color: blue
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: manejo-errores, auth-patrones, accesibilidad-a11y, swift-experto, swift-patrones, swift-testing
-skillsRestringidos: fastapi-experto, angular-moderno, react-native-best-practices
+skillsInvocables: [manejo-errores, auth-patrones, accesibilidad-a11y, swift-experto, swift-patrones, swift-testing]
+skillsRestringidos: [fastapi-experto, angular-moderno, react-native-best-practices]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -35,6 +35,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: implement
+dominio: mobile
 exclusiones:
   - "No invocar para desarrollo Android — ese trabajo corresponde a mobile-android-swl."
   - "No invocar para desarrollo multiplataforma (React Native, Flutter) — usar mobile-cross-swl."

package/agentes/mobile-testing-swl.md

@@ -9,7 +9,7 @@ description: >
   tests flaky. NO invocar para testing unitario de componentes — eso
   corresponde a tdd-qa-swl. NO invocar para implementación de features —
   usar mobile-android-swl, mobile-ios-swl o mobile-cross-swl.
-tools: Read, Write, Edit, Bash, Grep, Glob, Skill
+tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -17,8 +17,8 @@ permissionMode: acceptEdits
 color: cyan
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: tdd-workflow, manejo-errores, typescript-avanzado
-skillsRestringidos: django-experto, fastapi-experto, postgresql-experto
+skillsInvocables: [tdd-workflow, manejo-errores, typescript-avanzado]
+skillsRestringidos: [django-experto, fastapi-experto, postgresql-experto]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
@@ -27,6 +27,8 @@ toolBudget:
   standard: 30
   complex: 50
 evolvable: true  # nivelRiesgo=BAJO
+fase: verify
+dominio: quality
 exclusiones:
   - "No invocar para testing unitario de componentes — ese trabajo corresponde a tdd-qa-swl."
   - "No invocar para implementación de features — usar mobile-android-swl, mobile-ios-swl o mobile-cross-swl."

package/agentes/notificador-swl.md

@@ -12,15 +12,15 @@ description: >
   interactuando en la misma sesión. Preferir claude-notifications-go para
   notificaciones de desktop en Windows/macOS/Linux. Integra con
   respositorios-git/claude-notifications-go para notificaciones nativas.
-tools: Read, Write, Bash, Grep, Glob
+tools: [Read, Write, Bash, Grep, Glob]
 model: claude-haiku-4-5-20251001
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: amber
 version: 1.0.0
 nivelRiesgo: BAJO
-skillsInvocables: notificaciones-multicanal, checkpoints-verificacion
-skillsRestringidos: ninguno
+skillsInvocables: [notificaciones-multicanal, checkpoints-verificacion]
+skillsRestringidos: []
 permisosRed: true
 permisosEscritura: true
 permisosComandos: true
@@ -38,6 +38,8 @@ invariantes:
     operador: eq
     valor: true
     razon: Necesita ejecutar binarios de notificacion (claude-notifications-go).
+fase: meta
+dominio: meta
 exclusiones:
   - "No invocar para lógica de negocio o implementación de features — este agente solo envía notificaciones de estado del sistema SWL."
   - "No invocar para decisiones de diseño o planificación — esas decisiones corresponden a planificador-swl o arquitecto-swl."

package/agentes/observabilidad-swl.md

@@ -7,15 +7,15 @@ description: >
   necesita añadir observabilidad a un módulo nuevo, cuando hay incidentes repetidos
   sin visibilidad suficiente, cuando se deben definir SLOs, o cuando los logs
   actuales no son suficientes para depurar incidentes en producción.
-tools: Read, Write, Edit, Bash, Grep, Glob
+tools: [Read, Write, Edit, Bash, Grep, Glob]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: green
 version: 1.0.0
 nivelRiesgo: MEDIO
-skillsInvocables: monitoring-alertas, performance-baseline, cloud-aws
-skillsRestringidos: ninguno
+skillsInvocables: [monitoring-alertas, performance-baseline, cloud-aws]
+skillsRestringidos: []
 permisosRed: true
 permisosEscritura: true
 permisosComandos: true
@@ -26,6 +26,8 @@ invariantes:
     operador: eq
     valor: MEDIO
     razon: Este agente no debe escalar riesgo sin ADR explicito.
+fase: release
+dominio: infra
 exclusiones:
   - "No invocar para configurar infraestructura cloud (VPC, EC2, RDS) — usar cloud-infra-swl."
   - "No invocar para debugging de código de aplicación — usar depurador-swl."

package/agentes/orquestador-swl.md

@@ -9,7 +9,7 @@ description: >
   NO invocar para tareas simples de un solo agente (una pregunta técnica puntual,
   un fix de un bug trivial, o lectura de documentación) — en esos casos el
   usuario puede invocar directamente el agente especializado.
-tools: Read, Grep, Glob, Write, Bash, Agent
+tools: [Read, Grep, Glob, Write, Bash, Agent]
 model: claude-opus-4-7
 modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
@@ -17,12 +17,8 @@ permissionMode: plan
 color: white
 version: 1.1.0
 nivelRiesgo: BAJO
-skillsInvocables: compactacion-contexto, checkpoints-verificacion, aprendizaje-continuo, discutir-fase, ejecutar-fase, planear-fase, nuevo-proyecto, brainstorming, control-profundidad, prevencion-racionalizacion, estructura-proyecto-claude, workflow-claude-code, git-worktrees-paralelo, swl-dashboard, instalar-sistema, mapear-codebase, orquestacion-async, context-builder
-skillsRestringidos:
-  - fastapi-python
-  - angular-component
-  - angular-forms
-  - postgresql-table-design
+skillsInvocables: [compactacion-contexto, checkpoints-verificacion, aprendizaje-continuo, discutir-fase, ejecutar-fase, planear-fase, nuevo-proyecto, brainstorming, control-profundidad, prevencion-racionalizacion, estructura-proyecto-claude, workflow-claude-code, git-worktrees-paralelo, swl-dashboard, instalar-sistema, mapear-codebase, orquestacion-async, context-builder]
+skillsRestringidos: [fastapi-python, angular-component, angular-forms, postgresql-table-design]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: false
@@ -30,7 +26,10 @@ toolBudget:
   simple: 10
   standard: 25
   complex: 50
+maxTurnos: 10  # thin orchestrator: delegación simple sin loops esperados
 evolvable: false  # bloqueado por lista (funcion sistemica)
+fase: meta
+dominio: process
 exclusiones:
   - "No invocar para implementar código de producción directamente — ese trabajo corresponde a implementador-swl o al agente de stack especializado."
   - "No invocar para tareas de un solo agente o preguntas técnicas puntuales: el usuario puede invocar el agente especializado directamente sin pasar por el orquestador."
@@ -125,6 +124,28 @@ paralelismo:
 La regla de paralelización del Nivel 3 sigue aplicando, pero ahora el
 orquestador DEBE invocarla explícitamente en el prompt del sub-agente.
 
+## Routing por fase + dominio (lookup tabular determinístico)
+
+Antes de delegar, **clasifica la petición** por dos ejes mecánicos en lugar de
+parsear `description` con LLM:
+
+- **fase** del SDLC: `discover | plan | implement | verify | release | learn | meta`
+- **dominio**: `backend | frontend | mobile | data | infra | security | ux | quality | docs | process | meta | general`
+
+Cada agente declara su `fase` y `dominio` en frontmatter (schema
+`agent-frontmatter.schema.json`). El orquestador filtra agentes candidatos con
+`Grep("^(fase|dominio):", "agentes/")` o leyendo `INVENTARIO.md`. Solo si hay
+ambigüedad (>3 candidatos) recurre a desambiguación por `description`.
+
+**Ejemplo**: petición "implementa endpoint nuevo en FastAPI"
+→ `fase: implement`, `dominio: backend`
+→ candidatos: `backend-python-swl`, `backend-api-swl`, `implementador-swl`
+→ desambiguación por stack del proyecto (Python detectado) → `backend-python-swl`.
+
+Este routing reduce tokens de clasificación (no se pasa la `description` de 59
+agentes al LLM cada vez) y es determinista — la misma petición siempre matchea
+el mismo subset de agentes.
+
 ## Tabla de rutas — petición a agente responsable
 
 | Tipo de petición | Agente(s) primario(s) | Agentes de apoyo |
@@ -721,7 +742,7 @@ en un solo bloque de respuesta. Ejemplo conceptual:
 2. SIEMPRE proporciona contexto completo a cada agente paralelo (no pueden leer el output del otro)
 3. El orquestador DEBE integrar los resultados después de la convergencia
 4. Si un agente paralelo falla, los otros continúan — el orquestador maneja el fallo
-5. Máximo 4 agentes en paralelo (limitación práctica de contexto)
+5. Máximo 3 subagentes concurrentes — límite duro impuesto por `hooks/lib/delegation-tracker.js` (`MAX_CONCURRENT_CHILDREN = 3`). Intentar lanzar un cuarto resulta en bloqueo del runtime. Si se anuncia "ejecutaré 4 en paralelo", el cuarto fallará con `BLOQUEADO: límite de subagentes concurrentes alcanzado` — viola la regla de anti-degradación silenciosa. Mantener este número alineado con la constante del tracker.
 
 ### Cuándo paralelizar por equipo