agent-kit

Responde unas preguntas. Obtén un proyecto que tu agente entiende.

agent-kit prepara un proyecto para el desarrollo guiado por agentes con Claude Code: reglas aplicadas por hooks en lugar de prosa, un contexto pequeño en cada sesión, trabajo que se retoma donde quedó, specs vivas trazadas a los tests y un checklist de QA que sigue a las specs.
EmpezarVer en GitHub
~/shop
$ npx @razcue/agent-kit init shop
? Setup New app monorepo
? Technical level Technical
? Development method SDD + TDD
? Git flow for the agent Branches + pull requests
? QA checklist · Supabase test data Yes · Yes
 
✓ apps/web · apps/app · apps/docs · packages/ui · packages/shared
✓ AGENTS.md · agent-kit.json · .claude/settings.json
✓ .knowledge/ · work/specs/ · work/qa/ · supabase/test-data/
✓ plugin agent-kit@agent-kit enabled
 
Next: cd shop && npm install && claude
$

Menos contexto, más trabajo

Lo que el agente lee antes de tu primera pregunta, medido con agent-kit context.

84%

menos contexto en cada sesión · 6.3×

Un proyecto real en producción, reglas en AGENTS.md + memoria22.974 tokens
Un monorepo nuevo con agent-kit, todo incluido3631 tokens

Ambos medidos con agent-kit context, incluido el mismo ~/CLAUDE.md personal. El contexto de sesión propio de agent-kit ronda los 1300 tokens; doctor falla un proyecto por encima de 8000.

ReglasUna línea en AGENTS.md que el agente puede olvidar o ignorar.Hooks y comprobaciones — el git guard bloquea lo que tu flujo de git prohíbe, probado en vivo en cada versión.
Sesión nuevaVuelves a explicar dónde estabas y qué seguía.Empieza con el último checkpoint y la próxima tarea de cada trabajo.
RequisitosRepartidos entre chats y tickets; nadie sabe cuál es la verdad actual.Specs vivas — requisitos EARS con escenarios Given / When / Then, ids que nunca se reutilizan.
Prueba“Parece que está listo.”Cada escenario trazado a un test o una comprobación; preflight bloquea un cambio que no lo esté.
ScriptsReescritos en /tmp cada vez, perdidos al día siguiente.Se buscan primero, se conservan con cabecera y test, y se ejecutan con un resultado compacto.
QAProbar de memoria, haciendo clics.Un checklist generado desde las specs vivas, pasadas con fecha y datos de prueba con seed / purge.
InstalaciónAGENTS.md, ajustes, hooks y convenciones escritos a mano.Un comando, unas diez preguntas, nada inferido.

Reglas que se aplican, no que se piden

"Nunca hagas commit en main" en un Markdown es una sugerencia. El git guard de agent-kit lee tu flujo de git y bloquea el comando antes de que se ejecute —incluso a través de bash -c, eval y alias— y le dice al agente qué hacer en su lugar.
Garantías
agent · shop (main)
$ git commit -m "feat: add invoices"
✗ [agent-kit git-guard] Git flow is branches + pull requests:
don't `git commit` on main. Create a feature branch first
(`git switch -c feat/<name>`).
 
$ git switch -c feat/invoices
✓ Switched to a new branch 'feat/invoices'
$

Specs vivas que se fusionan, no que se pudren

Un cambio trae un delta. Cuando está verificado, un comando lo fusiona en la spec viva: el requisito nuevo llega, el eliminado queda retirado para siempre y su escenario ya está probado por un test y listado para QA.
Cambio 004 — spec deltachanges/004-invoices/specs/invoices.md
## ADDED Requirements
+### invoices.R3 — Rounded totals
+When an invoice is saved, the BFF shall round its total to 3 decimals.
+#### invoices.R3.S1 — Rounding edge @boundary
+- Given a line of 0.0005
+- When the invoice is saved
+- Then the total is 0.001
## REMOVED Requirements
−### invoices.R1 — Manual totals
specs.mjs merge 004
Spec vivaspecs/invoices/spec.md
retired: [invoices.R1]
### invoices.R1 — Manual totalsretirado
### invoices.R2 — Line amounts
### invoices.R3 — Rounded totals
When an invoice is saved, the BFF shall round its total to 3 decimals.
#### invoices.R3.S1 — Rounding edge @boundary
Testit("invoices.R3.S1 rounds 0.0005 up")
Checklist de QA[ ] invoices.R3.S1

Cómo funciona

    Respondes preguntas fijas
    Tipo de proyecto, nivel técnico, idioma, método (SDD o SDD + TDD), commits, flujo de git, QA. Nada se infiere.
    Recibes la capa del agente
    Un bloque corto en AGENTS.md, agent-kit.json, permisos aplicados, conocimiento, archivos de trabajo, scripts y el plugin con sus skills y hooks.
    Trabajas por carriles
    Responder, vía rápida o spec. El trabajo complejo se vuelve un cambio con requisitos EARS y escenarios Given/When/Then que se fusionan en las specs vivas.

Lo que obtienes

    Specs vivas, una notación
    Requisitos EARS, escenarios Given/When/Then como tests de aceptación y ZOMBIES para elegir los casos; los fusiona un script y los ids nunca se reutilizan.
    QA que sigue a las specs
    Un checklist generado desde las specs vivas, pasadas de QA con fecha y datos de prueba de Supabase que se niegan a correr en producción.
    Skills que cargan solo cuando hacen falta
    Once skills del plugin y una skill de stack por plantilla; sus descripciones se prueban para que se activen con pedidos reales y callen en lo demás.
    Garantías que se aplican
    Git guard, preflight antes de fusionar, revisión de commits y un aviso de scripts perdidos; en silencio fuera de los proyectos agent-kit.
    Conocimiento barato de cargar
    Un concepto por archivo y solo carga el resumen de una línea; ámbitos de proyecto, de máquina y globales.
    Documentación también para agentes
    llms.txt, llms-full.txt y un servidor MCP para que tu agente lea esta documentación mientras trabaja.

Empieza con un comando

Node ≥ 20.11 y Claude Code. No se añade ninguna dependencia en tiempo de ejecución a tu proyecto.
Leer la guía de instalaciónAdoptar un proyecto existente
Terminal
npx @razcue/agent-kit init my-project