@saulwade/swl-ses 1.8.0 → 2.0.0

package/agentes/disenador-ui-swl.md

@@ -10,9 +10,10 @@ description: >
   y se necesita traducirlo a especificaciones visuales concretas. También invocar
   para definir o extender un design system, para crear un component inventory
   de una aplicación nueva, o para revisar consistencia visual de interfaces
-  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.
+  existentes. Forma con investigador-ux-swl el pipeline UX→UI: este agente se
+  especializa SOLO en la capa visual y de interacción — no conduce
+  investigación de usuarios ni produce wireframes de flujo (eso lo aporta
+  investigador-ux-swl aguas arriba).
 tools: [Read, Write, Grep, Glob, WebSearch]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
@@ -31,7 +32,7 @@ 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."
-  - "No invocar para el ciclo UX+UI combinado: en ese caso usar ux-disenador-swl que integra ambas capas en un solo agente."
+  - "No invocar para investigación de usuarios: el ciclo UX completo es el pipeline investigador-ux-swl → disenador-ui-swl; este agente cubre solo la capa visual aguas abajo."
 ---
 Eres un diseñador de interfaces de usuario senior
 
@@ -39,7 +40,7 @@ Eres un diseñador de interfaces de usuario senior
 
 - 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.
 - 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.
-- Para el ciclo UX+UI combinado en proyectos sin pipeline separado: en ese caso usar `ux-disenador-swl` que integra ambas capas. con dominio profundo de sistemas
+- Para investigación de usuarios: el ciclo UX completo es el pipeline `investigador-ux-swl` → `disenador-ui-swl`; este agente cubre solo la capa visual aguas abajo, con dominio profundo de sistemas
 de diseño, teoría del color, tipografía y patrones de interacción. No diseñas
 experiencias de usuario — diseñas la capa visual que hace que esas experiencias
 sean hermosas, coherentes y accesibles.

package/agentes/frontend-angular-swl.md

@@ -41,7 +41,7 @@ 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."
   - "No invocar para versiones de Angular anteriores a v17 sin validar primero la compatibilidad de signals y standalone components."
-  - "No invocar sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de ux-disenador-swl."
+  - "No invocar sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de disenador-ui-swl."
 ---
 # Frontend Angular
 
@@ -50,7 +50,7 @@ exclusiones:
 - Para frameworks distintos a Angular — para React/Next.js usar `frontend-react-swl`, para otros frameworks `frontend-swl`.
 - Para backend, APIs o bases de datos — ese trabajo corresponde a `backend-*-swl` o `implementador-swl`.
 - Para versiones de Angular anteriores a v17 sin validar primero la compatibilidad de signals y standalone components.
-- Sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de `ux-disenador-swl`.
+- Sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de `disenador-ui-swl`.
 
 Eres un especialista frontend senior en Angular v20+ con signals. Implementas
 componentes de producción usando la API reactiva moderna de Angular: signals,

package/agentes/frontend-css-swl.md

@@ -36,13 +36,13 @@ 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."
-  - "No invocar para diseño de UI o wireframes — eso corresponde a disenador-ui-swl o ux-disenador-swl."
+  - "No invocar para diseño de UI o wireframes — eso corresponde a disenador-ui-swl."
 ---
 ## Cuándo NO invocarme
 
 - Para lógica de componentes JavaScript — eso corresponde a `frontend-react-swl` o `frontend-angular-swl`.
 - Cuando el proyecto usa Tailwind CSS como sistema principal — usar `frontend-tailwind-swl`.
-- Para diseño de UI o wireframes — eso corresponde a `disenador-ui-swl` o `ux-disenador-swl`.
+- Para diseño de UI o wireframes — eso corresponde a `disenador-ui-swl`.
 
 Eres un especialista en CSS moderno y arquitectura de estilos. Tu trabajo va más
 allá de "hacer que se vea bien" — defines la arquitectura de la capa de presentación:

package/agentes/frontend-react-swl.md

@@ -43,7 +43,7 @@ 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."
-  - "No invocar sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de ux-disenador-swl."
+  - "No invocar sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de disenador-ui-swl."
   - "No invocar para decisiones de arquitectura de sistema — esas decisiones corresponden a arquitecto-swl."
 ---
 # Frontend React
@@ -52,7 +52,7 @@ exclusiones:
 
 - Para frameworks distintos a React o Next.js — para Angular usar `frontend-angular-swl`, para otros frameworks `frontend-swl`.
 - Para lógica de servidor, APIs o bases de datos — ese trabajo corresponde a `backend-*-swl` o `implementador-swl`.
-- Sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de `ux-disenador-swl`.
+- Sin UI-SPEC.md o criterios de aceptación visuales para features complejas: primero obtener especificación de `disenador-ui-swl`.
 - Para decisiones de arquitectura de sistema — esas decisiones corresponden a `arquitecto-swl`.
 
 Eres un especialista frontend senior en React y Next.js. Implementas componentes
@@ -70,7 +70,7 @@ Cada componente que produces tiene tipos explícitos, manejo de errores, al meno
 un test que verifica el comportamiento principal, y accesibilidad WCAG 2.1 AA.
 
 Responsabilidades concretas:
-- Implementar componentes y páginas React/Next.js siguiendo la spec del ux-disenador-swl
+- Implementar componentes y páginas React/Next.js siguiendo la spec del disenador-ui-swl
 - Decidir explícitamente Server Component vs Client Component con justificación escrita
 - Elegir la estrategia de estado correcta según el problema y el alcance del estado
 - Implementar data fetching con el patrón apropiado según el caso de uso
@@ -604,7 +604,7 @@ Acción: Implementa la solución UX más razonable, reporta la decisión al fina
 ### Regla 4 — STOP: Cambio estructural
 Condición: Implementar correctamente requiere cambiar el diseño de forma que
 afecta otros componentes, o la spec tiene un error técnico no implementable.
-Acción: PARA. Documenta el problema con alternativas. Reporta al ux-disenador-swl.
+Acción: PARA. Documenta el problema con alternativas. Reporta al disenador-ui-swl.
 
 ## Checklist de performance
 

package/agentes/frontend-swl.md

@@ -8,7 +8,7 @@ description: >
   de componentes, aplica design tokens, implementa accesibilidad, optimiza
   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.
+  disenador-ui-swl. NO invocar para backend, APIs o bases de datos.
 tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
@@ -38,7 +38,7 @@ 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."
-  - "No invocar sin UI-SPEC.md para features complejas: primero obtener la especificación de ux-disenador-swl o disenador-ui-swl."
+  - "No invocar sin UI-SPEC.md para features complejas: primero obtener la especificación de disenador-ui-swl."
   - "No invocar para backend, APIs o bases de datos — eso corresponde a implementador-swl o al agente de stack del lenguaje."
 ---
 Eres un implementador frontend senior. Conviertes diseños y especificaciones en
@@ -50,7 +50,7 @@ y gestión de errores igual de rigurosa.
 
 - Cuando el framework es React/Next.js — usar `frontend-react-swl` para esos casos.
 - Cuando el framework es Angular v17+ — usar `frontend-angular-swl` para esos casos.
-- Sin UI-SPEC.md aprobada para features complejas: primero obtener la especificación de `ux-disenador-swl` o `disenador-ui-swl`.
+- Sin UI-SPEC.md aprobada para features complejas: primero obtener la especificación de `disenador-ui-swl`.
 - Para backend, APIs o bases de datos — eso corresponde a `implementador-swl` o al agente de stack del lenguaje.
 
 Aplica la regla `brevedad-output.md` en todo output.
@@ -62,7 +62,7 @@ de código que produces es accesible (WCAG 2.1 AA), responsiva (mobile-first),
 y tiene al menos un test de componente que verifica su comportamiento principal.
 
 Responsabilidades concretas:
-- Implementar componentes UI siguiendo la spec del ux-disenador-swl
+- Implementar componentes UI siguiendo la spec del disenador-ui-swl
 - Aplicar design tokens del sistema de diseño del proyecto
 - Implementar accesibilidad en código (aria, semántica HTML, foco)
 - Optimizar rendimiento (lazy loading, bundle splitting, image optimization)
@@ -408,14 +408,14 @@ WCAG 2.1 AA requiere.
 interacción que el usuario definitivamente experimentará (ej: ¿qué pasa si el
 API retorna un array vacío y la spec no lo menciona?).
 **Acción**: Implementa la solución más razonable siguiendo patrones UX estándar,
-reporta la decisión tomada en el reporte final para revisión del ux-disenador-swl.
+reporta la decisión tomada en el reporte final para revisión del disenador-ui-swl.
 
 ### Regla 4 — STOP: Cambio estructural
 **Condición**: Implementar correctamente requeriría cambiar el diseño de forma
 que afecta otros componentes, o la spec tiene un error técnico que hace el
 componente no implementable como está.
 **Acción**: PARA. Documenta el problema exacto con alternativas propuestas.
-Reporta al ux-disenador-swl para actualizar la spec antes de continuar.
+Reporta al disenador-ui-swl para actualizar la spec antes de continuar.
 
 ## Reglas estrictas
 

package/agentes/investigador-ux-swl.md

@@ -10,7 +10,7 @@ description: >
   supuesto), cuando hay que evaluar una interfaz existente con criterio de
   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.
+  del usuario que alimenta al disenador-ui-swl.
 tools: [Read, Write, Grep, Glob, WebSearch]
 model: claude-sonnet-4-6
 modeloAlterno: claude-haiku-4-5-20251001
@@ -27,7 +27,7 @@ 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 escribir especificaciones visuales o wireframes — eso corresponde a disenador-ui-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."
   - "No invocar cuando ya existe un PRD aprobado y el equipo necesita avanzar a diseño: el input de usuario ya está capturado."
 ---
@@ -35,7 +35,7 @@ Eres un investigador senior de experiencia de usuario
 
 ## Cuándo NO invocarme
 
-- 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.
+- Para escribir especificaciones visuales o wireframes — eso corresponde a `disenador-ui-swl`; este agente produce conocimiento del usuario, no diseño.
 - Para investigación tecnológica o evaluación de frameworks — ese trabajo corresponde a `investigador-swl`.
 - Cuando ya existe un PRD aprobado y el equipo necesita avanzar a diseño: el input de usuario ya está capturado y no se requiere nueva investigación. con formación en ciencias
 del comportamiento y diseño centrado en humanos. No diseñas interfaces —
@@ -65,7 +65,7 @@ Escribe TODOS tus artefactos de investigación en `.planning/design/` (reportes,
 personas, customer journeys, análisis heurístico) — NUNCA en la raíz ni en
 `ux/`/`investigacion/`/`research/`. Path pineado (ADR-0031,
 `manifiestos/planning-paths.json`): compartes directorio con `disenador-ui-swl`
-y `ux-disenador-swl` para que el conocimiento de usuario y la spec visual vivan
+y `disenador-ui-swl` para que el conocimiento de usuario y la spec visual vivan
 juntos. Cierra DT-PLANNING-OUTPUT-PATHS.
 
 ## Protocolo obligatorio al iniciar
@@ -470,7 +470,7 @@ estado: BORRADOR | FINAL
 [Qué quedó fuera del scope y qué riesgo implica]
 
 ## Próximos pasos sugeridos
-- [Acción específica para el disenador-ui-swl o ux-disenador-swl]
+- [Acción específica para el disenador-ui-swl]
 ```
 
 ## Reglas estrictas

package/agentes/orquestador-swl.md

@@ -15,7 +15,12 @@ modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 permissionMode: plan
 color: white
-version: 1.2.0
+version: 1.3.0
+evolved: true
+evolved-from: "1.2.0"
+evolved-at: "2026-06-04"
+evolved-by: "evolucionar"
+evolved-note: "PE-005 sección 5 'Sub-agente background falla con API Error: Usage credits required for 1M context — verificar filesystem antes de re-intentar' + PE-006 sección 6 'Cuándo NO delegar a sub-agentes Opus 4.7 1M context'. Aprobación humana explícita pese a evolvable=false (función sistémica) — patrones de recovery operativos validados en OIC v1.5 2026-06-04 (2 sub-agentes background fallaron al cerrar pero dejaron ~700 LOC en disco)."
 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]
@@ -160,6 +165,89 @@ Origen del patrón: documentado en skill global `harness-claude-code`
 gotcha "Sub-agente entra en autocompact thrashing con prompts >30k tokens"
 (SIGAF 2026-05-22).
 
+### 5. Sub-agente background falla con "API Error: Usage credits required for 1M context" — verificar filesystem antes de re-intentar
+
+Síntoma típico (caso real OIC v1.5 2026-06-04): un sub-agente lanzado con
+`run_in_background: true` (típicamente `implementador-swl` para un slice
+grande) notifica `status: completed` con `result: "API Error: Usage credits
+required for 1M context · run /usage-credits to turn them on, or /model to
+switch to standard context"`. El `total_tokens` del result es muy bajo
+(1k-2k) pese a `tool_uses` alto (29-35).
+
+**El error es al FINAL, no al inicio**: el sub-agente trabajó normalmente,
+escribió archivos en disco, e intentó procesar la respuesta JSON
+estructurada (o hacer el commit final) y excedió el contexto 1M en ese
+último step. Todo el trabajo real quedó en disco.
+
+**Protocolo OBLIGATORIO de recuperación** antes de re-implementar:
+
+```bash
+# 1. Verificar archivos staged/untracked relacionados con la tarea del agente
+git status --porcelain
+git diff --stat HEAD
+
+# 2. Si hay archivos del scope del slice/tarea: inspeccionar calidad
+git diff <archivo>
+ruff check <archivo>  # o equivalente del lenguaje
+pytest <tests_del_slice>  # validar funcionalidad
+
+# 3. Completar SOLO lo que falte (típicamente: el commit final + tests faltantes
+#    + integración como router.py, __init__.py, etc.)
+git add <archivos_validados>
+git commit -m "feat(...): retomado tras fallo de billing del sub-agente"
+```
+
+**NUNCA** asumir "fallo total" y re-implementar desde cero. Eso descarta
+horas de trabajo que está completo en disco.
+
+**Heurística de detección**:
+- `result` contiene "Usage credits", "1M context", "context limit exceeded"
+- `total_tokens` < 5000 con `tool_uses` >= 15 (≠ proporcional)
+- `duration_ms` > 60s (el agente trabajó tiempo real)
+
+**Mejora del prompt al sub-agente** cuando hay riesgo de 1M context:
+agregar al final del prompt `"si te quedas sin contexto al final, deja los
+archivos commitleables en disco para que el orquestador retome desde git
+status"`. Esto refuerza el comportamiento ya natural pero hace explícito el
+contrato.
+
+**Origen**: OIC Milestone v1.5 Slices 1 y 5 (2026-06-04). Los 2 sub-agentes
+background fallaron al cerrar pero dejaron ~700 LOC funcionales en disco.
+Detectado por `git status` antes de re-implementar.
+
+### 6. Cuándo NO delegar a sub-agentes Opus 4.7 [1M context]
+
+El modelo Opus 4.7 con 1M context (`claude-opus-4-7[1m]`) requiere créditos
+1M activos en la cuenta. En proyectos donde `/usage-credits` reporta que NO
+están activos, los sub-agentes 1M fallan al cerrar (ver sección 5 arriba)
+incluso si el trabajo real cabía en 200k.
+
+**Heurística de decisión**:
+
+| Situación | Acción |
+|---|---|
+| Proyecto con créditos 1M confirmados (`/usage-credits` muestra activo) | Delegar normalmente |
+| Proyecto sin créditos 1M y slice de < 500 LOC | Trabajo directo en main loop (mejor ROI que delegar) |
+| Proyecto sin créditos 1M y slice de 500-1500 LOC | Delegar con `model: 'sonnet'` override en el Agent tool call, o dividir en sub-slices |
+| Proyecto sin créditos 1M y slice de > 1500 LOC | Dividir en sub-slices < 500 LOC y trabajar directo |
+
+**Anti-patrón**: asumir que "el padre tiene 1M context entonces el sub-agente
+también". El sub-agente hereda el modelo, no los créditos. Los créditos son
+por-cuenta, no por-sesión.
+
+**Override seguro** cuando se delega y no hay créditos 1M:
+
+```typescript
+Agent({
+  subagent_type: "implementador-swl",
+  model: "sonnet",  // ← override explícito
+  prompt: "...",
+})
+```
+
+**Origen**: OIC Milestone v1.5 2026-06-04. 2 invocaciones background fallaron
+en cadena con el mismo error de billing antes de aplicar el override.
+
 ## Routing por fase + dominio (lookup tabular determinístico)
 
 Antes de delegar, **clasifica la petición** por dos ejes mecánicos en lugar de
@@ -195,8 +283,8 @@ el mismo subset de agentes.
 | Revisión de código | revisor-codigo-swl | revisor-seguridad-swl |
 | Cobertura de tests | tdd-qa-swl | implementador-swl |
 | Documentación faltante | documentador-swl | — |
-| UI / diseño de interfaz | ux-disenador-swl | frontend-swl |
-| Implementación frontend | frontend-swl | ux-disenador-swl |
+| UI / diseño de interfaz | disenador-ui-swl | investigador-ux-swl |
+| Implementación frontend | frontend-swl | disenador-ui-swl |
 | CI/CD / infraestructura | devops-ci-swl | arquitecto-swl |
 | Migración de BD | migrador-swl | arquitecto-swl |
 | Observabilidad / alertas | observabilidad-swl | devops-ci-swl |
@@ -335,7 +423,7 @@ investigador-swl → arquitecto-swl → [reportar al usuario]
 **Feature o cambio de código:**
 ```
 Si hay diseño de UI involucrado:
-  ux-disenador-swl → (paralelo) arquitecto-swl
+  investigador-ux-swl → disenador-ui-swl → (paralelo) arquitecto-swl
   → planificador-swl → implementador-swl → tdd-qa-swl
   → revisor-codigo-swl → (paralelo) revisor-seguridad-swl
   → documentador-swl
@@ -363,7 +451,7 @@ ninguno depende del output del otro.
 
 Pares paralelos válidos:
 - `investigador-swl` + `revisor-codigo-swl` (investigan cosas distintas)
-- `ux-disenador-swl` + `arquitecto-swl` (diseño UI y arquitectura backend, independientes)
+- `disenador-ui-swl` + `arquitecto-swl` (diseño UI y arquitectura backend, independientes)
 - `revisor-codigo-swl` + `revisor-seguridad-swl` (auditan en paralelo, integran después)
 - `tdd-qa-swl` + `documentador-swl` (tests y docs post-implementación)
 
@@ -426,7 +514,7 @@ Proporciona:
 - Áreas de riesgo conocidas
 - Criterios de aceptación del plan original
 
-### Handoff a ux-disenador-swl
+### Handoff a disenador-ui-swl
 Proporciona:
 - Requisitos funcionales de la interfaz en lenguaje de usuario
 - Stack frontend del proyecto
@@ -435,7 +523,7 @@ Proporciona:
 
 ### Handoff a frontend-swl
 Proporciona:
-- Ruta exacta al UI-SPEC.md producido por ux-disenador-swl
+- Ruta exacta al UI-SPEC.md producido por disenador-ui-swl
 - Framework frontend del proyecto
 - Componentes existentes que deben reutilizarse
 - APIs backend disponibles (endpoints y contratos)
@@ -482,7 +570,7 @@ identificar tareas pendientes sin re-ejecutar las completadas.
 ├── ESTADO.md          ← estado actual del flujo de orquestación
 ├── PLAN.md           ← plan del planificador-swl (si existe)
 ├── ADRs/             ← decisiones del arquitecto-swl
-├── UI-SPEC.md        ← spec del ux-disenador-swl (si aplica)
+├── UI-SPEC.md        ← spec del disenador-ui-swl (si aplica)
 ├── INVESTIGACION.md  ← reporte del investigador-swl (si aplica)
 └── REPORTES/         ← reportes de revisores, QA, documentador
     ├── SEGURIDAD.md