---
title: "Project layout"
description: "Every file and folder agent-kit adds to a project, and what each one is for."
canonical_url: "https://razcue-agent-kit.vercel.app/en/getting-started/project-layout"
---
# Project layout

> Every file and folder agent-kit adds to a project, and what each one is for.

## The agent layer (every project)

<table>
<thead>
  <tr>
    <th>
      Path
    </th>
    
    <th>
      What
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        agent-kit.json
      </code>
    </td>
    
    <td>
      The setup answers (<a href="https://razcue-agent-kit.vercel.app/en/reference/configuration">
        every field
      </a>
      
      ). Change them by re-running <code>
        init
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        AGENTS.md
      </code>
      
       + <code>
        CLAUDE.md
      </code>
    </td>
    
    <td>
      Short project rules plus a managed agent-kit block; <code>
        CLAUDE.md
      </code>
      
       imports <code>
        @AGENTS.md
      </code>
      
      . Keep it under 300 lines.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .claude/settings.json
      </code>
    </td>
    
    <td>
      Plugin enabled from its marketplace + git permission rules for your flow (your own rules are kept).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .claude/skills/stack-*
      </code>
    </td>
    
    <td>
      The stack conventions skill of your template (refreshed by <code>
        upgrade
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .knowledge/
      </code>
    </td>
    
    <td>
      Project knowledge: <code>
        business
      </code>
      
      , <code>
        env
      </code>
      
      , <code>
        decisions
      </code>
      
      , <code>
        ux
      </code>
      
      , <code>
        stack
      </code>
      
      , and <code>
        local
      </code>
      
       (gitignored). See <a href="https://razcue-agent-kit.vercel.app/en/concepts/knowledge">
        Knowledge
      </a>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/
      </code>
    </td>
    
    <td>
      Specs, changes, features, QA — see below.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        scripts/
      </code>
    </td>
    
    <td>
      Kept, documented scripts; <code>
        scripts/README.md
      </code>
      
       is a generated index.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .agent-kit/
      </code>
    </td>
    
    <td>
      Gitignored machine state: <code>
        scratch/
      </code>
      
       throwaway scripts (still searchable), <code>
        runs/
      </code>
      
       full logs, <code>
        backups/
      </code>
      
      , the checkpoint.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        commitlint.config.mjs
      </code>
      
      , <code>
        .husky/commit-msg
      </code>
    </td>
    
    <td>
      Commit message checks (Conventional Commits only).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .mcp.json
      </code>
    </td>
    
    <td>
      Read-only Supabase MCP server, when you gave a project ref.
    </td>
  </tr>
</tbody>
</table>

## `work/`

<table>
<thead>
  <tr>
    <th>
      Path
    </th>
    
    <th>
      What
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        work/specs/<capability>/spec.md
      </code>
    </td>
    
    <td>
      <strong>
        Living specs
      </strong>
      
      : how the system behaves now. The source of truth.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/changes/NNN-slug/
      </code>
    </td>
    
    <td>
      <strong>
        Changes
      </strong>
      
       from the spec lane: <code>
        proposal.md
      </code>
      
      , delta specs in <code>
        specs/<capability>.md
      </code>
      
      , <code>
        plan.md
      </code>
      
      , <code>
        tasks.md
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/features/NNN-slug.md
      </code>
    </td>
    
    <td>
      Fast-track work: goal, tasks, evidence.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/qa/
      </code>
    </td>
    
    <td>
      <code>
        checklist.md
      </code>
      
       and <code>
        checklist.html
      </code>
      
       (generated), <code>
        runs/
      </code>
      
       (QA passes).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/BOARD.md
      </code>
    </td>
    
    <td>
      Generated overview of active work.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/README.md
      </code>
    </td>
    
    <td>
      A map of this folder (managed by the kit).
    </td>
  </tr>
</tbody>
</table>

## Templates

<table>
<thead>
  <tr>
    <th>
      Kind
    </th>
    
    <th>
      Adds
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      App monorepo
    </td>
    
    <td>
      <code>
        apps/web
      </code>
      
       (public site), <code>
        apps/app
      </code>
      
       (SPA + BFF + Supabase auth starter), <code>
        apps/docs
      </code>
      
       (Docus), <code>
        packages/ui
      </code>
      
       (shadcn-vue layer), <code>
        packages/shared
      </code>
      
       (Zod + utils), <code>
        supabase/migrations/
      </code>
      
      , <code>
        supabase/test-data/
      </code>
      
      , CI.
    </td>
  </tr>
  
  <tr>
    <td>
      Content site
    </td>
    
    <td>
      One Nuxt site: every Markdown file in <code>
        content/
      </code>
      
       is a page; colours in <code>
        app/assets/css/main.css
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      Existing / blank
    </td>
    
    <td>
      Only the agent layer (blank also gets a minimal <code>
        package.json
      </code>
      
      ).
    </td>
  </tr>
</tbody>
</table>

Details in [Templates](https://razcue-agent-kit.vercel.app/en/reference/templates).


## Sitemap

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