Garantías
Cuatro hooks y unos pocos scripts hacen las comprobaciones. Están en silencio fuera de los proyectos agent-kit y tardan unos 70–100 ms cada uno. La lista completa está en Hooks.
Git guard
Un hook PreToolUse(Bash) aplica el flujo de git que elegiste, incluso a través de bash -c, eval, $( ) y alias de git:
| Flujo | El agente puede | Bloqueado |
|---|---|---|
| Solo lectura | leer (status, diff, log, …) | toda escritura en git: el agente te da el comando exacto |
| Ramas + PRs | hacer commits en una rama de feature | commits / pushes en la rama principal |
| Trunk | hacer commits en main | — |
Todos los flujos bloquean force-push, reset --hard, clean -f, branch -D y --no-verify, y el guard valida los mensajes de git commit -m antes de ejecutarlos. Las reglas de permisos de .claude/settings.json son la primera capa; el hook es el respaldo.
Preflight
agent-kit preflight [base] (y la skill preflight) antes de fusionar:
- Violaciones (bloquean): lógica cambiada sin test (SDD + TDD), una migración ya commiteada editada, permisos a los roles del navegador, posibles secretos, scripts conservados sin documentar, cambios terminados con escenarios sin cubrir o sin fusionar en las specs vivas.
- Informe: migraciones por aplicar, variables de entorno nuevas, dependencias nuevas.
- Avisos: restos de depuración, huecos en las specs vivas, errores de notación, un checklist de QA desactualizado, migraciones sin cambios en seed / purge.
Commits
Con Conventional Commits, init añade commitlint + husky. La skill commit ejecuta preflight, escribe el mensaje, lo valida con agent-kit commit check y hace el commit dentro del flujo de git, o te da el comando en un proyecto de solo lectura. agent-kit commit draft agrupa los archivos cambiados por ámbito sugerido.
Revisor
Un agente reviewer de solo lectura revisa un diff contra su cambio: la prueba de cada escenario, los requisitos EARS, las reglas del conocimiento y errores de corrección (comprobaciones de ámbito, redondeo, migraciones idempotentes).