Conceptos Básicos de ClaudeKit

Ahora que ya has ejecutado tus primeros comandos, es hora de entender los conceptos fundamentales que hacen funcionar a ClaudeKit.

Prerrequisitos: Asegúrate de haber completado la sección Primeros Pasos antes de continuar.

¿Qué vas a aprender?

• Qué es un agente y cómo funciona
• Qué son las skills y cuándo usarlas
• Cómo funciona el sistema de archivos de ClaudeKit
• El workflow básico de desarrollo

¿Qué es un Agente?

Un agente es una IA especializada que realiza tareas específicas como planificar, investigar, programar, o hacer code review.

¿Qué es una Skill?

Las skills son módulos de conocimiento especializado que los agentes utilizan para tareas específicas como React, Python, o bases de datos.

Sistema de Archivos

ClaudeKit organiza tu proyecto en directorios específicos: .claude/ para configuración, plans/ para planes, y docs/ para documentación.

Workflow Básico

El flujo típico es: Planificar → Implementar → Testear → Revisar → Documentar → Commit.

Agentes Especializados

ClaudeKit incluye 14 agentes especializados. Aquí están los más importantes para principiantes:

Agente	Función	Cuándo usarlo
Planner	Crea planes de implementación	Antes de empezar una feature
Researcher	Investiga tecnologías	Cuando no sabes qué usar
Developer	Escribe código	Para implementar features
Tester	Ejecuta tests	Para validar el código
Code Reviewer	Revisa calidad	Antes de hacer commit

Tip: No necesitas recordar todos los agentes. ClaudeKit selecciona automáticamente el apropiado según tu comando.

Skills Principales

Las skills más usadas para principiantes:

Frontend

• react-best-practices - Patrones React/Next.js
• ui-styling - Estilos con shadcn/ui

Backend

• senior-backend - Node.js, Express, APIs
• databases - PostgreSQL, MongoDB

Workflow

• cook - Implementación completa
• fix - Solución de bugs
• ask - Consultas técnicas

Sistema de Archivos

tu-proyecto/
├── .claude/              # Configuración ClaudeKit
│   ├── agents/          # Definiciones de agentes
│   ├── skills/          # Skills disponibles
│   └── rules/           # Workflows y reglas
├── plans/               # Planes de implementación
│   └── reports/         # Reportes de agentes
├── docs/                # Documentación del proyecto
└── src/                 # Tu código fuente

Importante: Nunca modifiques .claude/ manualmente. ClaudeKit mantiene esta carpeta automáticamente.

Workflow Básico

El flujo de trabajo típico con ClaudeKit:

graph LR
    A[Idea] --> B[/plan/]
    B --> C[/cook/]
    C --> D[/test/]
    D --> E[/commit/]

Ejemplo Completo

# 1. Planificar la feature
claude plan "Agregar login con Google"

# 2. Implementar (investiga → planifica → codifica → testea → revisa)
claude cook "Implementar login con OAuth"

# 3. Ejecutar tests
claude test

# 4. Hacer commit del código
claude commit

Siguiente: Proyectos Básicos

Pon en práctica lo aprendido construyendo tu primer proyecto real.