Subagent Scope Guard
Si fuiste invocado como subagente con una tarea concreta, ejecuta solo
esa tarea y reporta DONE / DONE_WITH_CONCERNS / BLOCKED. NO actives el
workflow completo de esta skill.
Skill: Evidence-First Development
El humano NO leerá tu implementación. Confianza en dos artefactos: un SPEC
ejecutable aprobado antes del código, y un informe EVIDENCE con números reales
después. La confianza pasa de inspección a restricciones.
Límite honesto: el gauntlet no demuestra que el SPEC cubre todo lo importante,
ni es auto-autenticable. Por eso el SPEC va al humano y EVIDENCE reporta
confianza en capas, nunca prueba absoluta. Ver DOMAIN.md.
Authoritative Paths
Lee antes de actuar. NUNCA asumas firmas ni inventes paths.
| Para |
Lee este path |
| Tooling del gauntlet por ecosistema + plantilla EVIDENCE |
references/gauntlet.md |
| Checkers caseros fail-closed |
docs/rules/domain/checker-fail-closed.md |
| Cobertura changed-line |
docs/rules/domain/changed-line-coverage.md |
| Mutation testing |
../mutation-audit/SKILL.md |
| Aprobación de spec (answer ≠ approval) |
../spec-driven-development/SKILL.md |
Cuándo usar / NO usar
- Usar: alta garantía explícita ("prove it works", "no leeré el código") · dominios de alto riesgo (dinero, auth, datos, concurrencia, API pública) · review que no escala.
- NO usar: cambios triviales (Tier 1) · tests normales sin bucle completo · ya cubierto por
verification-lattice + Court.
Decision Checklist
- ¿Toca dinero/auth/datos/concurrencia/API pública? → Tier 3 (failure model + adversarial pass)
- ¿Bug fix o feature pequeña? → Tier 2 (bucle completo, RED reproduce el bug)
- ¿Trivial (typo/comment/config)? → Tier 1 (suite + lint)
- ¿El humano aprobó el SPEC? → si NO: EVIDENCE registra
spec approval: not obtained y reclama menos confianza
Abort Conditions
- SPEC con placeholders (TODO/TBD) → incompleto, no empezar
- Sin test runner/linter/typechecker y el humano prohíbe añadirlos → capas manuales, confianza reducida
- Cualquier capa del gauntlet falla → bloquear "done", reportar verbatim
Workflow
SPEC → (humano aprueba spec, no código) → RED → GREEN → REFACTOR → GAUNTLET → EVIDENCE
↑_________________________| repeat per behavior
- SPEC: criterios ejecutables (Gherkin o lista de tests con inputs/outputs, edge cases, invariantes que deben sobrevivir) + setup plan (cada dependencia justificada). Path absoluto, aprobación antes de código.
- RED→GREEN→REFACTOR: un behavior por ciclo; obsérvalo fallar (si pasa de inmediato, throwaway mutant para probarlo); mínimo código; assertions congeladas.
- GAUNTLET→EVIDENCE: corre cada capa (tabla en
references/gauntlet.md), nunca saltes en silencio; informe con números de una ejecución fresca final, reproducible desde el repo (entry-point + versiones pineadas + source state).
Anti-gaming rules (absolutas)
Nunca debilitar un test · nunca editar test+impl a la vez · nunca mockear el SUT (mockea fronteras) · nunca perseguir cobertura · nunca reportar una capa no corrida · gauntlet fallando bloquea done.
Calibración
Tier 1 trivial (suite+lint) · Tier 2 normal (bucle completo, bug fix empieza en RED) · Tier 3 high-stakes (failure model: una capa por modo de daño + adversarial pass). Detalle: DOMAIN.md.
Outputs esperados
- SPEC aprobado (path absoluto, append-only)
- EVIDENCE report (
references/gauntlet.md) con spec→test mapping y números de ejecución fresca
- Entry-point persistido en repo (
tools/gauntlet.sh)
Memory hooks
- Tras éxito: guardar la capa que cazó un bug real →
bash scripts/memory-store.sh save --type pattern --title "gauntlet-catch-<lenguaje>" --content "<capa> cazó <bug>" --source skill:evidence-first-development
Related
- Skill:
../mutation-audit/SKILL.md, ../tdd-vertical-slices/SKILL.md, ../verification-lattice/SKILL.md, ../spec-driven-development/SKILL.md
- Rule:
docs/rules/domain/checker-fail-closed.md, docs/rules/domain/changed-line-coverage.md
- Ref: AmazingAng/old-coder (MIT) — pattern only, prosa propia
1---2name: evidence-first-development3description: Subagent Scope Guard4---56## Subagent Scope Guard78> Si fuiste invocado como subagente con una tarea concreta, ejecuta solo9> esa tarea y reporta DONE / DONE_WITH_CONCERNS / BLOCKED. NO actives el10> workflow completo de esta skill.1112# Skill: Evidence-First Development1314El humano NO leerá tu implementación. Confianza en dos artefactos: un SPEC15ejecutable aprobado antes del código, y un informe EVIDENCE con números reales16después. La confianza pasa de inspección a restricciones.1718Límite honesto: el gauntlet no demuestra que el SPEC cubre todo lo importante,19ni es auto-autenticable. Por eso el SPEC va al humano y EVIDENCE reporta20confianza en capas, nunca prueba absoluta. Ver `DOMAIN.md`.2122## Authoritative Paths2324> **Lee antes de actuar. NUNCA asumas firmas ni inventes paths.**2526| Para | Lee este path |27|---|---|28| Tooling del gauntlet por ecosistema + plantilla EVIDENCE | `references/gauntlet.md` |29| Checkers caseros fail-closed | `docs/rules/domain/checker-fail-closed.md` |30| Cobertura changed-line | `docs/rules/domain/changed-line-coverage.md` |31| Mutation testing | `../mutation-audit/SKILL.md` |32| Aprobación de spec (answer ≠ approval) | `../spec-driven-development/SKILL.md` |3334## Cuándo usar / NO usar3536- **Usar**: alta garantía explícita ("prove it works", "no leeré el código") · dominios de alto riesgo (dinero, auth, datos, concurrencia, API pública) · review que no escala.37- **NO usar**: cambios triviales (Tier 1) · tests normales sin bucle completo · ya cubierto por `verification-lattice` + Court.3839## Decision Checklist40411. ¿Toca dinero/auth/datos/concurrencia/API pública? → Tier 3 (failure model + adversarial pass)422. ¿Bug fix o feature pequeña? → Tier 2 (bucle completo, RED reproduce el bug)433. ¿Trivial (typo/comment/config)? → Tier 1 (suite + lint)444. ¿El humano aprobó el SPEC? → si NO: EVIDENCE registra `spec approval: not obtained` y reclama menos confianza4546### Abort Conditions4748- SPEC con placeholders (TODO/TBD) → incompleto, no empezar49- Sin test runner/linter/typechecker y el humano prohíbe añadirlos → capas manuales, confianza reducida50- Cualquier capa del gauntlet falla → bloquear "done", reportar verbatim5152## Workflow5354```55SPEC → (humano aprueba spec, no código) → RED → GREEN → REFACTOR → GAUNTLET → EVIDENCE56 ↑_________________________| repeat per behavior57```58591. **SPEC**: criterios ejecutables (Gherkin o lista de tests con inputs/outputs, edge cases, invariantes que deben sobrevivir) + setup plan (cada dependencia justificada). Path absoluto, aprobación antes de código.602. **RED→GREEN→REFACTOR**: un behavior por ciclo; **obsérvalo fallar** (si pasa de inmediato, throwaway mutant para probarlo); mínimo código; assertions congeladas.613. **GAUNTLET→EVIDENCE**: corre cada capa (tabla en `references/gauntlet.md`), nunca saltes en silencio; informe con números de **una ejecución fresca final**, reproducible desde el repo (entry-point + versiones pineadas + source state).6263## Anti-gaming rules (absolutas)6465Nunca debilitar un test · nunca editar test+impl a la vez · nunca mockear el SUT (mockea fronteras) · nunca perseguir cobertura · nunca reportar una capa no corrida · gauntlet fallando bloquea done.6667## Calibración6869Tier 1 trivial (suite+lint) · Tier 2 normal (bucle completo, bug fix empieza en RED) · Tier 3 high-stakes (failure model: una capa por modo de daño + adversarial pass). Detalle: `DOMAIN.md`.7071## Outputs esperados7273- SPEC aprobado (path absoluto, append-only)74- EVIDENCE report (`references/gauntlet.md`) con spec→test mapping y números de ejecución fresca75- Entry-point persistido en repo (`tools/gauntlet.sh`)7677## Memory hooks7879- Tras éxito: guardar la capa que cazó un bug real → `bash scripts/memory-store.sh save --type pattern --title "gauntlet-catch-<lenguaje>" --content "<capa> cazó <bug>" --source skill:evidence-first-development`8081## Related8283- Skill: `../mutation-audit/SKILL.md`, `../tdd-vertical-slices/SKILL.md`, `../verification-lattice/SKILL.md`, `../spec-driven-development/SKILL.md`84- Rule: `docs/rules/domain/checker-fail-closed.md`, `docs/rules/domain/changed-line-coverage.md`85- Ref: AmazingAng/old-coder (MIT) — pattern only, prosa propia