---
title: "Estructura del proyecto"
description: "Cada archivo y carpeta que agent-kit añade a un proyecto y para qué sirve."
canonical_url: "https://razcue-agent-kit.vercel.app/es/getting-started/project-layout"
---
# Estructura del proyecto

> Cada archivo y carpeta que agent-kit añade a un proyecto y para qué sirve.

## La capa del agente (todo proyecto)

<table>
<thead>
  <tr>
    <th>
      Ruta
    </th>
    
    <th>
      Qué es
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        agent-kit.json
      </code>
    </td>
    
    <td>
      Las respuestas de la instalación (<a href="https://razcue-agent-kit.vercel.app/es/reference/configuration">
        cada campo
      </a>
      
      ). Cámbialas volviendo a ejecutar <code>
        init
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        AGENTS.md
      </code>
      
       + <code>
        CLAUDE.md
      </code>
    </td>
    
    <td>
      Reglas cortas del proyecto más un bloque gestionado de agent-kit; <code>
        CLAUDE.md
      </code>
      
       importa <code>
        @AGENTS.md
      </code>
      
      . Mantenlo por debajo de 300 líneas.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .claude/settings.json
      </code>
    </td>
    
    <td>
      El plugin activado desde su marketplace + reglas de permisos de git para tu flujo (tus propias reglas se conservan).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .claude/skills/stack-*
      </code>
    </td>
    
    <td>
      La skill de convenciones del stack de tu plantilla (la renueva <code>
        upgrade
      </code>
      
      ).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .knowledge/
      </code>
    </td>
    
    <td>
      Conocimiento del proyecto: <code>
        business
      </code>
      
      , <code>
        env
      </code>
      
      , <code>
        decisions
      </code>
      
      , <code>
        ux
      </code>
      
      , <code>
        stack
      </code>
      
       y <code>
        local
      </code>
      
       (ignorado por git). Ver <a href="https://razcue-agent-kit.vercel.app/es/concepts/knowledge">
        Conocimiento
      </a>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/
      </code>
    </td>
    
    <td>
      Specs, cambios, features, QA (ver abajo).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        scripts/
      </code>
    </td>
    
    <td>
      Scripts conservados y documentados; <code>
        scripts/README.md
      </code>
      
       es un índice generado.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .agent-kit/
      </code>
    </td>
    
    <td>
      Estado de la máquina, ignorado por git: <code>
        scratch/
      </code>
      
       scripts desechables (se pueden buscar), <code>
        runs/
      </code>
      
       logs completos, <code>
        backups/
      </code>
      
      , el checkpoint.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        commitlint.config.mjs
      </code>
      
      , <code>
        .husky/commit-msg
      </code>
    </td>
    
    <td>
      Revisión de los mensajes de commit (solo con Conventional Commits).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        .mcp.json
      </code>
    </td>
    
    <td>
      Servidor MCP de Supabase de solo lectura, si diste un ref de proyecto.
    </td>
  </tr>
</tbody>
</table>

## `work/`

<table>
<thead>
  <tr>
    <th>
      Ruta
    </th>
    
    <th>
      Qué es
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        work/specs/<capacidad>/spec.md
      </code>
    </td>
    
    <td>
      <strong>
        Specs vivas
      </strong>
      
      : cómo se comporta el sistema hoy. La fuente de verdad.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/changes/NNN-slug/
      </code>
    </td>
    
    <td>
      <strong>
        Cambios
      </strong>
      
       del carril spec: <code>
        proposal.md
      </code>
      
      , specs delta en <code>
        specs/<capacidad>.md
      </code>
      
      , <code>
        plan.md
      </code>
      
      , <code>
        tasks.md
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/features/NNN-slug.md
      </code>
    </td>
    
    <td>
      Trabajo de vía rápida: objetivo, tareas, evidencia.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/qa/
      </code>
    </td>
    
    <td>
      <code>
        checklist.md
      </code>
      
       y <code>
        checklist.html
      </code>
      
       (generados), <code>
        runs/
      </code>
      
       (pasadas de QA).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/BOARD.md
      </code>
    </td>
    
    <td>
      Resumen generado del trabajo activo.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        work/README.md
      </code>
    </td>
    
    <td>
      Un mapa de esta carpeta (lo gestiona el kit).
    </td>
  </tr>
</tbody>
</table>

## Plantillas

<table>
<thead>
  <tr>
    <th>
      Tipo
    </th>
    
    <th>
      Añade
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Monorepo de app
    </td>
    
    <td>
      <code>
        apps/web
      </code>
      
       (sitio público), <code>
        apps/app
      </code>
      
       (SPA + BFF + base de autenticación con Supabase), <code>
        apps/docs
      </code>
      
       (Docus), <code>
        packages/ui
      </code>
      
       (capa shadcn-vue), <code>
        packages/shared
      </code>
      
       (Zod + utilidades), <code>
        supabase/migrations/
      </code>
      
      , <code>
        supabase/test-data/
      </code>
      
      , CI.
    </td>
  </tr>
  
  <tr>
    <td>
      Sitio de contenido
    </td>
    
    <td>
      Un sitio Nuxt: cada archivo Markdown en <code>
        content/
      </code>
      
       es una página; los colores en <code>
        app/assets/css/main.css
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      Existente / en blanco
    </td>
    
    <td>
      Solo la capa del agente (en blanco recibe además un <code>
        package.json
      </code>
      
       mínimo).
    </td>
  </tr>
</tbody>
</table>

Detalles en [Plantillas](https://razcue-agent-kit.vercel.app/es/reference/templates).


## Sitemap

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