Reference
Configuration
Every field of agent-kit.json.
agent-kit.json holds the setup answers. Change them by re-running agent-kit init.
| Field | What | Default |
|---|---|---|
name | Project name (kebab-case). | folder name |
kind | Setup kind: what init scaffolded.monorepo — web + app + docs scaffold on Nuxt + Supabasesite — one simple Nuxt site with Markdown pages — easiestexisting — add the agent layer to this folder's codeblank — agent layer only, no template — start from nothing | asked |
apps | Monorepo apps (web, app, docs); empty for other kinds.web — public website (Nuxt, prerendered)app — main solution (Nuxt SPA + BFF + Supabase)docs — help / wiki site (Docus) | web,app,docs |
stack | Stack conventions skill installed in .claude/skills/.none — no stack conventions skillnuxt-supabase — stack-nuxt-supabase skill (pages, BFF routes, migrations, RPCs)nuxt-content-site — stack-nuxt-content-site skill (Markdown pages, styling, build) | from the kind |
technicalLevel | How the agent talks to you.technical — concise developer languagenon-technical — plain language; the agent makes technical decisions | technical |
language | Agent reply language.en — Englishes — Español | en |
methodology | SDD, or SDD + TDD (tests first, enforced by preflight).sdd-tdd — spec first, then tests before code; preflight blocks untested logicsdd — spec first; every scenario verified by a test or a check | sdd-tdd |
commitConvention | Conventional Commits checked by commitlint, or free-form.conventional — type(scope): subject — checked by commitlint and a git hooknone — no message checks | conventional |
gitFlow | What the agent may do with git (enforced by a hook).pr — agent never commits or pushes on maintrunk — commits on main; no force-push or hard resetread-only — agent never changes git; you run git yourself | pr |
mainBranch | The main (production) branch: detected from git at setup (origin's HEAD, or the only main / master / trunk / production / prod branch), asked when not sure; upgrade re-checks that it exists. Preflight compares against it; the git guard protects it. | detected, else main |
testIgnore | Paths without unit tests (thin route handlers). | apps/*/server/api/ in the monorepo |
testCommand | Command that runs the tests, when not the default. | — |
contextBudget | Tokens per session above which doctor fails. | 8000 |
supabaseMcp | Supabase project ref for the read-only MCP server in .mcp.json. | — |
qa.checklist | Generate work/qa/checklist.md from the living specs. | true |
qa.testData | Supabase seed / purge scripts (Supabase projects only). | true on Supabase |
qa.testPrefix | Marker every test row starts with. | TEST_ |
qa.testDataDir | Where the test-data scripts live. | supabase/test-data |
kitVersion | Kit version that last wrote the setup (drives the upgrade notice). | written by init |