IntermedioSkills

Hook Scope Guard — detecta cambios fuera del scope declarado del spec

Hook con 108 installs. Detecta cuando se modifican archivos fuera del scope declarado en un .spec.md. Para teams con spec-driven development que querés enforcement del alcance acordado.

29 de mayo de 20262 min de lecturaclaude-code

Qué es#

Cuando tu .spec.md declara explícitamente qué archivos/paths están en scope (scope: src/auth/**), el hook detecta si Claude modificó archivos fuera de eso. Hook event: Stop.

Diferencia con Plan Gate (que enforce que exista spec): Scope Guard enforce que se respete el scope del spec existente.

Para teams enterprise con specs estrictos.

Tabla resumen#

CampoValor
Categoría aitmplquality-gates
Installs108
Hook eventStop
TriggerFiles modified outside .spec.md scope

Cómo se instala#

bash
npx claude-code-templates@latest --hook quality-gates/scope-guard

Para Claude:

bash
Instalé el hook quality-gates/scope-guard. Verificá que mi .spec.md
activo tenga la sección `scope:`. Si edito fuera del scope, debería
warn al cerrar la sesión.

Qué podés hacer con esto#

Mantener foco del scope#

Si el spec dice "solo módulo auth", el hook detecta cuando Claude tocó algo de billing por error.

Auditoría de adherence#

Después de la sesión, el log te dice si hubo desbordes y cuáles.

Combo con Spec Kit#

Spec Kit genera specs con scope. Scope Guard enforce el scope.

Combo con Plan Gate#

Plan Gate enforce que exista spec. Scope Guard enforce que se respete su alcance. Combo natural.

Cuándo NO conviene#

⚠️ Antes de instalar
  • Si no usás specs con scope declarado: no hace nada útil.
  • Para repos sin spec-driven development: overhead.
  • Para refactors cross-module legítimos: el hook puede ser cauteloso de más.

Bajalo de la fuente#

Recursos relacionados#