---
title: "Introducción"
description: "Qué es agent-kit, qué no es y qué problemas resuelve."
canonical_url: "https://razcue-agent-kit.vercel.app/es/getting-started/introduction"
---
# Introducción

> Qué es agent-kit, qué no es y qué problemas resuelve.

agent-kit es un arnés mínimo para el **desarrollo guiado por agentes con Claude Code**. Tiene dos partes:

- **Una CLI de npx** (`npx @razcue/agent-kit`) que prepara un proyecto a partir de preguntas fijas y escribe archivos planos: `agent-kit.json`, un bloque gestionado en `AGENTS.md`, `.claude/settings.json`, `.knowledge/`, `work/`, `scripts/` y, en proyectos nuevos, una plantilla.
- **Un plugin de Claude Code** (`agent-kit@agent-kit`) con skills, hooks, un agente revisor de solo lectura y scripts sin dependencias. Tiene versiones y se instala desde el marketplace de este repositorio.

## Por qué existe

Los agentes leen lo que cargas en cada sesión y olvidan todo lo demás. Sin un arnés, los proyectos caen en los mismos fallos:

<table>
<thead>
  <tr>
    <th>
      Fallo
    </th>
    
    <th>
      Qué hace agent-kit
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Un <code>
        AGENTS.md
      </code>
      
       enorme cargado en cada sesión
    </td>
    
    <td>
      Un bloque gestionado corto; los procedimientos van a skills (se cargan bajo demanda) y los hechos al conocimiento (solo cargan los resúmenes). <code>
        agent-kit context
      </code>
      
       mide el costo.
    </td>
  </tr>
  
  <tr>
    <td>
      Reglas escritas en prosa
    </td>
    
    <td>
      Hooks y comprobaciones: el git guard bloquea los comandos de git que tu flujo prohíbe; preflight bloquea fusiones inseguras.
    </td>
  </tr>
  
  <tr>
    <td>
      Ayudantes reescritos cada vez
    </td>
    
    <td>
      Un registro de scripts: buscar antes de escribir, conservar y documentar lo que se reutiliza.
    </td>
  </tr>
  
  <tr>
    <td>
      Sesiones que olvidan
    </td>
    
    <td>
      Un checkpoint tras cada turno y una sección "retomar" al empezar la siguiente sesión.
    </td>
  </tr>
  
  <tr>
    <td>
      Specs que se pudren
    </td>
    
    <td>
      Specs vivas por capacidad, que solo cambian mediante cambios aprobados, con cada escenario trazado a un test.
    </td>
  </tr>
  
  <tr>
    <td>
      QA manual de memoria
    </td>
    
    <td>
      Un checklist de QA generado desde las specs vivas y datos de prueba que crecen con ellas.
    </td>
  </tr>
</tbody>
</table>

## Principios

- **Perfil, no inferencia.** Tu nivel técnico, idioma, método y flujo de git se responden una vez; nada se adivina a partir del código.
- **Aplicar, no pedir.** Todo lo que una máquina puede comprobar se vuelve un hook, un script o una regla de permisos.
- **Contexto pequeño.** Cada skill, regla y entrada de conocimiento debe ganarse los tokens que cuesta por sesión.
- **Sin dependencias en tiempo de ejecución.** La CLI y los scripts del plugin usan solo los módulos de Node (Node ≥ 20.11).
- **Solo Claude Code.** El kit usa directamente los plugins, skills, hooks y ajustes de Claude Code.

## Siguiente

- [Instálalo](https://razcue-agent-kit.vercel.app/es/getting-started/installation) en un proyecto nuevo o existente.
- Lee cómo los [carriles y métodos](https://razcue-agent-kit.vercel.app/es/concepts/lanes-and-methods) dan forma a cada pedido.


## Sitemap

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