---
title: "Configuration"
description: "Every field of agent-kit.json."
canonical_url: "https://razcue-agent-kit.vercel.app/en/reference/configuration"
---
# Configuration

> Every field of agent-kit.json.

`agent-kit.json` holds the setup answers. Change them by re-running `agent-kit init`.

<table>
<thead>
  <tr>
    <th>
      Field
    </th>
    
    <th>
      What
    </th>
    
    <th>
      Default
    </th>
  </tr>
</thead>

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


## Sitemap

See the full [sitemap](https://razcue-agent-kit.vercel.app/sitemap.md) for all pages.