@saulwade/swl-ses 1.7.3 → 1.7.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "1.7.3",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 61 agentes, 178 habilidades, 44 comandos, 71 reglas y 43 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.7.3 agrega skill calidad-anti-patrones-universales (catalogo de 10 anti-patrones nombrados) + utility scripts/lib/pr-analyzer.js (analizador zero-deps de PRs) + 3 sub-secciones nuevas en estilo-sin-ai-isms (agencia falsa, narrador-distancia, aperturas Wh-).",
+  "version": "1.7.4",
+  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 61 agentes, 178 habilidades, 44 comandos, 71 reglas y 43 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.7.4 documenta knobs nativos de Claude Code (CLAUDE_CODE_SUBAGENT_MODEL, --max-budget-usd, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS) en reglas/harness-claude-code.md + ADR-0030 Propuesto (Dreaming API para consolidacion de memoria). Hereda de v1.7.3: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",
     "swl-telegram-bot": "bin/swl-telegram-bot.js",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "swl-ses",
-  "version": "1.7.3",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 61 agentes, 178 habilidades, 44 comandos, 71 reglas y 43 hooks. 62 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.7.3 agrega skill calidad-anti-patrones-universales (catalogo de 10 anti-patrones nombrados) + utility scripts/lib/pr-analyzer.js (analizador zero-deps de PRs) + 3 sub-secciones nuevas en estilo-sin-ai-isms (agencia falsa, narrador-distancia, aperturas Wh-).",
+  "version": "1.7.4",
+  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 61 agentes, 178 habilidades, 44 comandos, 71 reglas y 43 hooks. 62 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.7.4 documenta knobs nativos de Claude Code (CLAUDE_CODE_SUBAGENT_MODEL, --max-budget-usd, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS) en reglas/harness-claude-code.md + ADR-0030 Propuesto (Dreaming API para consolidacion de memoria). Hereda de v1.7.3: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "author": "Saul Wade Leon",
   "license": "MIT",
   "repository": "https://github.com/saul-wade/swl-ses",

package/reglas/harness-claude-code.md

@@ -101,6 +101,45 @@ con uso constante de tools mantiene el prefijo caliente indefinidamente
 - Cambiar de modelo a media sesión invalida el cache (regla de cache
   discipline arriba). Si necesitas otro modelo, abre nueva sesión.
 
+### Knobs nativos para sub-agentes y teams (env vars del harness)
+
+Claude Code expone variables de entorno que controlan el routing de
+modelos y el costo de sesiones con múltiples agentes. Son del **harness
+Anthropic**, no de swl-ses — complementan, no reemplazan, el Model-Tier
+por frontmatter (`model:` en cada agente) ni el `budget-enforcer.js`.
+
+```bash
+# Forzar el modelo de TODOS los sub-agentes/teammates a uno más barato.
+# Útil en sesiones ad-hoc donde no quieres routing granular por agente.
+# El líder mantiene el modelo de la sesión (Opus); los teammates bajan a Sonnet.
+export CLAUDE_CODE_SUBAGENT_MODEL="claude-sonnet-4-6"
+
+# Habilitar Agent Teams nativo (experimental): un líder coordina teammates
+# que se comunican entre sí vía task list compartida. swl-ses NO lo usa por
+# defecto — su patrón es orquestador-swl + Agent tool. Activar solo para
+# experimentar con coordinación teammate-to-teammate.
+export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
+```
+
+```bash
+# Cap de costo nativo por sesión headless/team. Aborta la sesión completa
+# al alcanzar el límite, sin importar cuántos agentes estén activos.
+claude -p "build the auth system" --max-budget-usd 15.00
+```
+
+**Relación con la infra de swl-ses:**
+
+| Knob nativo | Equivalente swl-ses | Cuándo usar el nativo |
+|-------------|---------------------|------------------------|
+| `CLAUDE_CODE_SUBAGENT_MODEL` | `model:` en frontmatter de cada agente (Model-Tier) | El frontmatter es **superior** (granular por agente). El env var solo para sesiones ad-hoc sin SWL o como override global temporal |
+| `--max-budget-usd` | `scripts/lib/budget-enforcer.js` (4 niveles + idempotency) + `hooks/tracking-costos.js` | El `budget-enforcer` es **superior** (warning/approval/backpressure/hard). El flag nativo es un cap duro complementario para sesiones de orquestador con muchos sub-agentes en paralelo |
+| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | `orquestador-swl` + Agent tool | swl-ses prefiere su patrón. El nativo solo para experimentación — su modelo teammate-to-teammate no está integrado con los hooks de gobernanza SWL |
+
+**Anti-patrón**: usar `CLAUDE_CODE_SUBAGENT_MODEL` como reemplazo del
+Model-Tier por frontmatter. Pierde la granularidad (revisor-seguridad
+necesita Opus aunque sea teammate). Usar solo como override de sesión,
+nunca persistente en `.bashrc` si trabajas con swl-ses.
+
 ### `/effort` per-prompt (no per-session)
 
 ```