Referencia
Configuración
Cada campo de agent-kit.json.
agent-kit.json guarda las respuestas de la instalación. Cámbialas volviendo a ejecutar agent-kit init.
| Campo | Qué es | Por defecto |
|---|---|---|
name | Nombre del proyecto (kebab-case). | nombre de la carpeta |
kind | Tipo de proyecto: lo que generó init.monorepo — plantilla web + app + docs con Nuxt + Supabasesite — un sitio Nuxt sencillo con páginas en Markdown, lo más fácilexisting — añade la capa del agente al código de esta carpetablank — solo la capa del agente, sin plantilla, desde cero | se pregunta |
apps | Apps del monorepo (web, app, docs); vacío en los demás tipos.web — sitio público (Nuxt, prerenderizado)app — solución principal (SPA Nuxt + BFF + Supabase)docs — sitio de ayuda / wiki (Docus) | web,app,docs |
stack | Skill de convenciones del stack instalada en .claude/skills/.none — sin skill de convencionesnuxt-supabase — skill stack-nuxt-supabase (páginas, rutas BFF, migraciones, RPCs)nuxt-content-site — skill stack-nuxt-content-site (páginas Markdown, estilos, build) | según el tipo |
technicalLevel | Cómo te habla el agente.technical — lenguaje conciso de desarrolladornon-technical — lenguaje sencillo; el agente toma las decisiones técnicas | technical |
language | Idioma de respuesta del agente.en — Englishes — Español | en |
methodology | SDD, o SDD + TDD (tests primero, exigidos por preflight).sdd-tdd — spec primero, luego tests antes del código; preflight bloquea la lógica sin testssdd — spec primero; cada escenario verificado por un test o una comprobación | sdd-tdd |
commitConvention | Conventional Commits revisados por commitlint, o mensajes libres.conventional — type(scope): subject, revisado por commitlint y un hook de gitnone — sin revisión de mensajes | conventional |
gitFlow | Qué puede hacer el agente con git (lo aplica un hook).pr — el agente nunca hace commit ni push en maintrunk — commits en main; sin force-push ni reset duroread-only — el agente nunca cambia git; tú ejecutas git | pr |
mainBranch | La rama principal (de producción): se detecta desde git al instalar (el HEAD de origin, o la única rama main / master / trunk / production / prod), se pregunta si no hay certeza; upgrade comprueba que exista. Preflight compara contra ella; el git guard la protege. | detectada, si no main |
testIgnore | Rutas sin tests unitarios (manejadores de rutas delgados). | apps/*/server/api/ en el monorepo |
testCommand | Comando que ejecuta los tests, si no es el de siempre. | — |
contextBudget | Tokens por sesión a partir de los cuales falla doctor. | 8000 |
supabaseMcp | Ref del proyecto de Supabase para el servidor MCP de solo lectura en .mcp.json. | — |
qa.checklist | Genera work/qa/checklist.md desde las specs vivas. | true |
qa.testData | Scripts seed / purge de Supabase (solo proyectos con Supabase). | true con Supabase |
qa.testPrefix | Marca con la que empieza cada fila de prueba. | TEST_ |
qa.testDataDir | Dónde viven los scripts de datos de prueba. | supabase/test-data |
kitVersion | Versión del kit que escribió la instalación por última vez (activa el aviso de actualización). | la escribe init |