Subagent Scope Guard
Si eres subagente con una tarea concreta, ejecuta solo esa y reporta DONE / DONE_WITH_CONCERNS / BLOCKED.
Skill: Arquitectura de harness
Decide cuánta estructura necesita un trabajo de agentes y la diseña: contrato, herramientas,
contexto, verificación, presupuesto, bucles y sprints. Entrega un diseño con sus condiciones de
parada, no una implementación. Las skills hermanas ejecutan; esta decide.
Authoritative Paths
Lee estos paths antes de actuar. No inventes paths ni firmas.
| Para |
Lee |
| Seguridad de modos autónomos (git, PR, fail-safe) |
docs/rules/domain/autonomous-safety.md |
| Merges en serie bajo grant |
docs/rules/domain/autonomous-safety-merge-sprint.md |
| Productor/verificador, y verificador que falla cerrado |
docs/rules/domain/maker-checker-protocol.md, docs/rules/domain/checker-fail-closed.md |
| Niveles L0-L3; prosa, script, skill o hook |
docs/rules/domain/loop-phasing.md, docs/rules/domain/remedy-ladder.md |
| Equipos en paralelo, ámbitos disjuntos |
docs/agent-teams-sdd.md |
| Checklist de diseño |
references/checklist-diseno.md |
| Patrones y reglas de elección |
references/catalogo-patrones.md |
| Flujos largos, bucles y sprints nocturnos |
references/flujos-bucles-sprints.md |
| Metaharness (experimental) |
references/metaharness.md |
| Anti-patrones con coste observado |
references/antipatrones.md |
| Plantillas: ficha, encargo, sprint, progreso |
references/plantillas.md |
| Fuentes públicas con URL y fecha |
references/fuentes.md |
Si un path no existe, avisa y marca lo que dependa de él como no contrastado.
Cuándo usar
Montar un trabajo con varios agentes o decidir si hacen falta; diseñar un bucle autónomo, una tarea
de horas o un sprint nocturno; depurar un harness que se cuelga, repite, gasta de más o no reanuda.
Cuándo NO usar
- Tarea corta o de un paso: hazla directamente.
- Programar tareas periódicas:
automation-scheduler. Ejecutar un sprint ya diseñado: overnight-sprint.
- Mejora autónoma con métricas:
code-improvement-loop. Dependencias entre fases SDD: dag-scheduling.
- Backlog, capacity y sprint de proyecto:
sprint-management.
Etiquetas de evidencia
Las referencias etiquetan cada regla. Ante duda, trata [O] como hipótesis y mide.
[M] medida; [M-int] medida interna del autor, no reproducible; [E] experiencia propia de
Savia, sin estudio controlado; [O] práctica u opinión de fuentes; [D] documentación de producto.
Decision Checklist
- ¿Cabe en un paso o en un agente con herramientas y un contexto? → agente único. Fin.
- ¿Hay un fallo observado del agente único (contexto desbordado, instrucciones ignoradas, herramienta mal elegida)? → No: no añadas estructura.
- ¿Subtareas de lectura o amplitud, independientes? → orquestadora + subagentes que devuelven un resumen corto.
- ¿Subtareas de escritura con decisiones compartidas? → hilo único; paralelo solo con ficheros disjuntos comprobados antes.
- ¿Ejecutor especializado que gana en su dominio y autoridad de una persona? → metaharness, experimental:
references/metaharness.md.
- ¿Dura más que un contexto? → estado en ficheros y reanudación.
- ¿Se repite hasta cumplir un criterio? → bucle con tope.
- ¿Corre sin vigilancia? → sprint con cola, vigilantes y permisos preconcedidos.
- ¿Qué lo hace cumplir? → control determinista (hook, sandbox, test) antes que prosa; un control sin salida clara falla cerrado.
Detalle de 6-8: references/flujos-bucles-sprints.md; de 9: checklist de diseño.
Abort conditions
- Sin criterio de éxito comprobable ni modo de crearlo: no lances el bucle; diseña antes la comprobación.
- Sin persona que dé la autoridad (reviewer o grant): no lances nada autónomo.
- Sin presupuesto (tiempo, tokens, dinero, disco, RAM): defínelo antes.
Tres reglas que no se negocian
- Delegar nunca amplía autoridad: el hijo recibe como mucho lo que tiene la madre y ningún agente aprueba su propio trabajo. [E]
- Parar siempre está permitido; un bucle sin tope es gasto sin límite. [O, E]
- El tope de agentes simultáneos es un parámetro de política, no una verdad técnica: lo fijan la cuenta (consumo) y la máquina (RAM, disco). Una orden expresa de la persona lo mueve; el diseño funciona con cualquier N. [E]
Outputs esperados
- Diseño de 1-2 páginas: opción elegida y el fallo observado que la justifica; plan o ficha
(
references/plantillas.md), condiciones de parada, presupuesto y qué se medirá.
- Cada afirmación no trivial con su etiqueta de evidencia.
Memory hooks
- Al empezar:
bash scripts/memory-store.sh recall harness. Tras un fallo operativo nuevo: bash scripts/memory-store.sh save --type feedback --title '<título>' --content '<cue, lección, evidencia, confianza>' (comillas simples; texto de terceros nunca entre dobles) --source skill:harness-architecture
Related
- Skills:
../overnight-sprint/SKILL.md, ../code-improvement-loop/SKILL.md, ../automation-scheduler/SKILL.md, ../dag-scheduling/SKILL.md
- Spec:
docs/specs/SE-457-harness-architecture-skill.spec.md
1---2layer: peripheral3name: harness-architecture4description: "Diseña la arquitectura de un harness de agentes: único, orquestado o metaharness, flujos largos, bucles, sprints. Usar cuando se diseña o depura un harness, un bucle autónomo o un sprint nocturno."5license: MIT6metadata:7 source: https://skillmd.com/skills/gonzalezpazmonica/harness-architecture8 savia.maturity: "draft"9 savia.context: "standalone"10 savia.context_cost: "medium"11 savia.category: "meta"12 savia.tags: "harness, metaharness, orquestacion, bucles, sprints, flujos-largos"13 savia.priority: "medium"14 savia.loop_level: "L1"15---1617## Subagent Scope Guard1819> Si eres subagente con una tarea concreta, ejecuta solo esa y reporta DONE / DONE_WITH_CONCERNS / BLOCKED.2021# Skill: Arquitectura de harness2223Decide **cuánta estructura** necesita un trabajo de agentes y la diseña: contrato, herramientas,24contexto, verificación, presupuesto, bucles y sprints. Entrega un diseño con sus condiciones de25parada, no una implementación. Las skills hermanas ejecutan; esta decide.2627## Authoritative Paths2829> Lee estos paths antes de actuar. No inventes paths ni firmas.3031| Para | Lee |32|---|---|33| Seguridad de modos autónomos (git, PR, fail-safe) | `docs/rules/domain/autonomous-safety.md` |34| Merges en serie bajo grant | `docs/rules/domain/autonomous-safety-merge-sprint.md` |35| Productor/verificador, y verificador que falla cerrado | `docs/rules/domain/maker-checker-protocol.md`, `docs/rules/domain/checker-fail-closed.md` |36| Niveles L0-L3; prosa, script, skill o hook | `docs/rules/domain/loop-phasing.md`, `docs/rules/domain/remedy-ladder.md` |37| Equipos en paralelo, ámbitos disjuntos | `docs/agent-teams-sdd.md` |38| Checklist de diseño | `references/checklist-diseno.md` |39| Patrones y reglas de elección | `references/catalogo-patrones.md` |40| Flujos largos, bucles y sprints nocturnos | `references/flujos-bucles-sprints.md` |41| Metaharness (experimental) | `references/metaharness.md` |42| Anti-patrones con coste observado | `references/antipatrones.md` |43| Plantillas: ficha, encargo, sprint, progreso | `references/plantillas.md` |44| Fuentes públicas con URL y fecha | `references/fuentes.md` |4546Si un path no existe, avisa y marca lo que dependa de él como no contrastado.4748## Cuándo usar4950Montar un trabajo con varios agentes o decidir si hacen falta; diseñar un bucle autónomo, una tarea51de horas o un sprint nocturno; depurar un harness que se cuelga, repite, gasta de más o no reanuda.5253## Cuándo NO usar5455- Tarea corta o de un paso: hazla directamente.56- Programar tareas periódicas: `automation-scheduler`. Ejecutar un sprint ya diseñado: `overnight-sprint`.57- Mejora autónoma con métricas: `code-improvement-loop`. Dependencias entre fases SDD: `dag-scheduling`.58- Backlog, capacity y sprint de proyecto: `sprint-management`.5960## Etiquetas de evidencia6162Las referencias etiquetan cada regla. Ante duda, trata [O] como hipótesis y mide.63**[M]** medida; **[M-int]** medida interna del autor, no reproducible; **[E]** experiencia propia de64Savia, sin estudio controlado; **[O]** práctica u opinión de fuentes; **[D]** documentación de producto.6566## Decision Checklist67681. ¿Cabe en un paso o en un agente con herramientas y un contexto? → **agente único**. Fin.692. ¿Hay un fallo observado del agente único (contexto desbordado, instrucciones ignoradas, herramienta mal elegida)? → No: no añadas estructura.703. ¿Subtareas de lectura o amplitud, independientes? → **orquestadora + subagentes** que devuelven un resumen corto.714. ¿Subtareas de escritura con decisiones compartidas? → **hilo único**; paralelo solo con ficheros disjuntos comprobados antes.725. ¿Ejecutor especializado que gana en su dominio y autoridad de una persona? → **metaharness, experimental**: `references/metaharness.md`.736. ¿Dura más que un contexto? → estado en ficheros y reanudación.747. ¿Se repite hasta cumplir un criterio? → bucle con tope.758. ¿Corre sin vigilancia? → sprint con cola, vigilantes y permisos preconcedidos.769. ¿Qué lo hace cumplir? → control determinista (hook, sandbox, test) antes que prosa; un control sin salida clara falla cerrado.7778Detalle de 6-8: `references/flujos-bucles-sprints.md`; de 9: checklist de diseño.7980### Abort conditions8182- Sin criterio de éxito comprobable ni modo de crearlo: no lances el bucle; diseña antes la comprobación.83- Sin persona que dé la autoridad (reviewer o grant): no lances nada autónomo.84- Sin presupuesto (tiempo, tokens, dinero, disco, RAM): defínelo antes.8586## Tres reglas que no se negocian87881. **Delegar nunca amplía autoridad**: el hijo recibe como mucho lo que tiene la madre y ningún agente aprueba su propio trabajo. [E]892. **Parar siempre está permitido**; un bucle sin tope es gasto sin límite. [O, E]903. **El tope de agentes simultáneos es un parámetro de política**, no una verdad técnica: lo fijan la cuenta (consumo) y la máquina (RAM, disco). Una orden expresa de la persona lo mueve; el diseño funciona con cualquier N. [E]9192## Outputs esperados9394- Diseño de 1-2 páginas: opción elegida y el fallo observado que la justifica; plan o ficha95 (`references/plantillas.md`), condiciones de parada, presupuesto y qué se medirá.96- Cada afirmación no trivial con su etiqueta de evidencia.9798## Memory hooks99100- Al empezar: `bash scripts/memory-store.sh recall harness`. Tras un fallo operativo nuevo: `bash scripts/memory-store.sh save --type feedback --title '<título>' --content '<cue, lección, evidencia, confianza>' (comillas simples; texto de terceros nunca entre dobles) --source skill:harness-architecture`101102## Related103104- Skills: `../overnight-sprint/SKILL.md`, `../code-improvement-loop/SKILL.md`, `../automation-scheduler/SKILL.md`, `../dag-scheduling/SKILL.md`105- Spec: `docs/specs/SE-457-harness-architecture-skill.spec.md`