Primeros Pasos con Claude-Craft

Bienvenido a Claude-Craft. Esta guía te ayudará a entender qué es Claude-Craft y a poner en marcha tu primer proyecto en solo 5 minutos.

---

¿Qué es Claude-Craft?

Claude-Craft es un framework completo para desarrollo asistido por IA con Claude Code. Proporciona:

• 67+ Reglas - Mejores prácticas para arquitectura, pruebas, seguridad y calidad de código
• 23 Agentes IA - Asistentes especializados para diferentes tareas
• 74+ Comandos Slash - Acciones rápidas para generación y análisis de código
• 25+ Plantillas - Patrones de código listos para usar
• 21+ Checklists - Puertas de calidad para funcionalidades y releases

Tecnologías Soportadas

Tecnología	Enfoque	Casos de Uso
Symfony	Clean Architecture + DDD	APIs, Apps web, Servicios backend
Flutter	Patrón BLoC	Apps móviles (iOS/Android)
Python	FastAPI/Django	APIs, Servicios de datos
React	Hooks + State Management	SPAs web, Dashboards
React Native	Móvil multiplataforma	Apps móviles con JS
Docker	Infraestructura	Contenedorización, CI/CD

Idiomas Soportados

Todo el contenido está disponible en 5 idiomas: Inglés (en), Francés (fr), Español (es), Alemán (de), Portugués (pt)

---

Prerrequisitos

Obligatorios

• Bash - Shell para ejecutar scripts de instalación
• Claude Code - El asistente de codificación IA de Anthropic

Opcionales (Recomendados)

# yq - Procesador YAML
brew install yq  # macOS
sudo apt install yq  # Linux

# jq - Procesador JSON (para StatusLine)
brew install jq  # macOS
sudo apt install jq  # Linux

---

Instalación Rápida

Método 1: Makefile (Recomendado)

git clone https://github.com/thebeardedcto/claude-craft.git
cd claude-craft

# Instalar para proyecto Symfony (en español)
make install-symfony TARGET=~/mi-proyecto LANG=es

Método 2: Script Directo

./Dev/scripts/install-symfony-rules.sh --lang=es ~/mi-proyecto

Método 3: Configuración YAML (para Monorepos)

cp claude-projects.yaml.example claude-projects.yaml
nano claude-projects.yaml
make config-install CONFIG=claude-projects.yaml PROJECT=mi-proyecto

---

Tu Primer Proyecto en 5 Minutos

# Paso 1: Crear directorio del proyecto
mkdir ~/mi-api && cd ~/mi-api && git init

# Paso 2: Instalar reglas Claude-Craft
make install-symfony TARGET=~/mi-api LANG=es

# Paso 3: Verificar instalación
ls -la ~/mi-api/.claude/

# Paso 4: Configurar contexto del proyecto (elige una opción)
# Opción A: Interactiva (recomendada)
cd ~/mi-api && claude
# Luego ejecuta: /common:setup-project-context

# Opción B: Manual
nano ~/mi-api/.claude/rules/00-project-context.md

# Paso 5: Iniciar Claude Code
cd ~/mi-api && claude

---

Entendiendo la Estructura

Reglas (rules/)

Directrices que Claude sigue al trabajar en tu proyecto, numeradas por prioridad (00-12+).

Agentes (agents/)

@api-designer Diseña la API REST para gestión de usuarios
@database-architect Crea el esquema para el agregado Pedido
@symfony-reviewer Revisa mi implementación de UserService

Comandos (commands/)

/symfony:generate-crud User
/symfony:check-compliance
/common:architecture-decision

Plantillas (templates/)

service.md, value-object.md, aggregate-root.md, test-unit.md

Checklists (checklists/)

feature-checklist.md, pre-commit.md, release.md, security-audit.md

---

Conceptos Clave

1. Flujo de Trabajo TDD

1. Analizar → 2. Tests → 3. Implementar → 4. Refactorizar → 5. Revisar

2. Clean Architecture

┌─────────────────────────────────────┐
│           Presentación              │
├─────────────────────────────────────┤
│           Aplicación                │
├─────────────────────────────────────┤
│             Dominio                 │
├─────────────────────────────────────┤
│          Infraestructura            │
└─────────────────────────────────────┘

3. Calidad Primero

• 80%+ cobertura de tests
• Análisis estático aprobado
• Auditoría de seguridad clara
• Documentación actualizada

---

Próximos Pasos

1. Guía de Creación de Proyecto
2. Guía de Desarrollo de Funcionalidades
3. Guía de Corrección de Bugs

---

Siguiente: Creación de Proyecto →