Hooks locales
Feedback rápido y advisory antes de que el commit salga de tu máquina.
/// sistema
La mayoría de librerías de skills venden capacidad.Nosotros vendemos disciplina que puedes verificar.
npx @juandelossantos/another-agent-skills installPaso 1 — empieza aquí
Una skill. Detecta tu stack, instala los hooks locales, la puerta TDD y el check de CI requerido, y prueba que la primera puerta se dispara de verdad. Todo lo demás se apoya en esto.
> /gate
Detectando · VCS: git · stack: Node · hooksPath: sin definir
Conectando · L1 hooks locales · L2 check remoto gates requerido · L3 CODEOWNERS
Probando · git commit → ✗ BLOQUEADO: cada cambio de código necesita un testEl enforcement funciona con cualquier agente basado en git — OpenCode, Claude Code, Cursor, Codex, Gemini CLI, y cualquier agente que lea AGENTS.md.
Ver la skill /gateTL;DR: modelos capaces igual se saltan tests, review y contexto. La brecha es proceso, no inteligencia.
Código que parece correcto y falla en producción.
Dos agentes se sobrescriben sin darse cuenta.
Los mismos patrones sin importar el contexto ni el stack.
El daño se descubre horas después, por una persona.
Cuando los desarrolladores usaron IA, tardaron 19 por ciento más. Estimaron que la IA les ahorró 20 por ciento del tiempo.
Becker et al., METR, julio 2025
La brecha entre capaz y confiable no es inteligencia. Es proceso.
01 / ciclo de vida
TL;DR: cada tarea pasa por DEFINIR, PLANEAR, CONSTRUIR, VERIFICAR, REVISAR y ENTREGAR. Ninguna fase es opcional y cada una tiene criterio de salida.
/specSpec aprobado, alcance bloqueado/planTareas chicas, dependencias mapeadas/buildUn slice, tests escritos primero/verifyTests pasan, coincide con el spec/reviewSin issues P0, seguridad revisada/shipCommit limpio, puertas en verdeNinguna fase es opcional. Cada paso tiene una skill. Cada skill tiene una puerta.
02 / el harness
TL;DR: el Harness son seis capas alrededor del modelo. Un cambio malo llega a la capa de guardrails y se bloquea ahí, y queda registrado.
Quién es el agente y qué no debe hacer jamás.
Capacidades específicas, cargadas bajo demanda.
Dónde corren los comandos, aislados de tu sistema.
Cuándo se activa cada herramienta y cómo se coordinan.
Hooks deterministas en puntos del ciclo de vida.
Evidencia de que funciona o está derivando.
Bloqueado en Guardrails: llegó un cambio de código sin test que lo cubra. Observabilidad lo registró.
Una regla que vive solo en un archivo es una sugerencia. Una regla que vive en una capa es una puerta.
03 / el bucle
TL;DR: cada sesión puede auditar, diagnosticar, arreglar y registrar un ADR. Los hallazgos se vuelven fixes, y los fixes se vuelven decisiones registradas.
Verificación sin evidencia es inspección.
04 / enforcement
TL;DR: un cambio de código sin test que lo cubra se bloquea localmente por L1 y no se puede mergear sin el check remoto gates de L2.
Feedback rápido y advisory antes de que el commit salga de tu máquina.
Un status check requerido. El committer no puede saltarlo. Solo GitHub.
Una persona es dueña de las rutas sensibles. El review es requerido. Solo GitHub.
$ git commit -m "feat: add checkout"
[commit-msg v6] scanning staged files
[commit-msg v6] code changed: src/checkout.js
[commit-msg v6] matching test: none
✗ BLOCKED: every code change needs a matching test.El mismo check corre en remoto como el status requerido gates, así que el committer no puede saltearlo.
TL;DR: el instalador detecta tu agente y tu stack, y conecta las skills y hooks correspondientes.
Agnóstico de stack: Node, Rust, Python, Go, Ruby, Dart, o cualquier stack. init-agents escribe STACK_CONFIG.md.
Ver la matriz de adaptadores de agentes05 / skills
TL;DR: 58 skills curadas, mapeadas al ciclo de vida. Usa todas o solo las que tu flujo necesita.
Contratos, contexto y la entrevista que bloquea el alcance antes del código.
spec-driven-developmentinterview-meidea-refineengineering-fundamentalscontext-engineering
planning-and-task-breakdownarchitecture-analysisdoubt-driven-developmentmulti-agent-orchestration
incremental-implementationtest-driven-developmentsource-driven-developmentfrontend-webbackend-api-masteryapi-and-interface-design
debugging-and-error-recoverydebugging-three-strikesbrowser-testing-with-devtoolsproject-health-check
code-review-and-qualitysecurity-and-hardeningperformance-optimizationaudit-skillcritique-skillcode-simplification
git-workflow-and-versioningci-cd-and-automationshipping-and-launchfullstack-shippingdocumentation-and-adrsobservability-and-instrumentation
critique-skillaudit-skillclarify-skillhard-skillpolish-skilltypeset-skilladapt-skilloptimize-skilldelight-skillredesign-skill
skill-creatorskill-improverself-improvementproject-metrics
58 skills · 153 guías · 6 componentes del harness · un eval para cada una
Explorar el catálogo completoTL;DR: sin git tienes solo reglas. Con git sumas hooks L1. Con GitHub sumas L2 y L3. Re-ejecuta init-agents después de cada cambio.
Independiente o privado, sin VCS. Las reglas y AGENTS.md se instalan, pero no hay hooks ni gate remoto. El enforcement es solo por convención.
Mejorar:git initdespués re-ejecutainit-agents
Un repo privado o una forja que no es GitHub. Los hooks L1 están activos. No hay L2 ni L3, así que falta la autoridad remota.
Mejorar:git remote add origin <url>después re-ejecutainit-agents
L1 + L2 + L3 completos. El check remoto gates es requerido, CODEOWNERS es dueño de las rutas sensibles, y el committer no puede saltear ninguno.
Aplicar:setup-branch-protection.sh --dry-run
Sin git ahora, git y GitHub después. La regla clave: re-ejecuta init-agents después de git init y después de agregar el remoto. Detecta lo que ahora está disponible e instala las capas faltantes.
Regla:init-agentsdespués de cada cambio
06 / faq
Un framework de 58 skills compuestos que convierten agentes de IA en ingenieros senior disciplinados. Agrega enforcement mecánico, no solo prompts. Las skills siguen un ciclo de seis fases: Definir, Planear, Construir, Verificar, Revisar, Entregar.
Tres capas. L1 son hooks de git locales para feedback rápido y advisory. L2 es un check remoto gates requerido que el committer no puede saltar. L3 es review de CODEOWNERS para rutas sensibles. Un cambio de código sin test que lo cubra se bloquea, local y remotamente.
Diseñado para OpenCode. Portable a Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, Windsurf, Aider y cualquier agente que lea AGENTS.md. El instalador detecta el agente y conecta las skills y hooks correspondientes.
Sí. Licencia MIT. Open source. Sin suscripciones ni tiers pagos. El instalador, las skills y el enforcement son gratis.
Sí. Los hooks lo hacen más difícil, no imposible. Un agente podría malinterpretar una aprobación ambigua o actuar fuera del protocolo. Estas puertas crean fricción, no garantías. La persona sigue en el loop, y la persona sigue atenta.
El Harness es todo lo que rodea al modelo y convierte inteligencia cruda en output confiable: instrucciones, herramientas, sandboxes, orquestación, guardrails y observabilidad. Agente es igual a Modelo más Harness. La mayoría de los fallos de agentes son fallos de configuración.
Tres canales. Clona y ejecuta install.sh, o usa el bootstrap curl pineado del último release, o instala vía npm. Después ejecuta init-agents en cualquier proyecto. Los tres están activos hoy.
07 / empezar
Un comando. El instalador detecta tu agente y tu stack, y arma el enforcement.
npx @juandelossantos/another-agent-skills install