Guía de Workflows

Aprende workflows reales que usan los desarrolladores con ClaudeKit.

¿Principiante? Completa el Nivel Principiante primero.

Workflows Principales

🏗️ Construir una Nueva Feature

Desde la idea hasta el deployment completo.

🐛 Debug de Producción

Investigar y solucionar problemas en producción.

🔄 Refactorizar Código Legacy

Modernizar código existente con seguridad.

📝 Crear Tests

Suites de tests completas con alta cobertura.

Workflow 1: Construir una Nueva Feature

Planning

# Paso 1: Investigar y planear
claude plan "Agregar notificaciones en tiempo real con WebSocket"

# Resultado: Plan detallado en plans/
# - research/report.md - Investigación de WebSocket vs SSE
# - plan.md - Plan de implementación

Implementation

# Paso 2: Implementar basado en el plan
claude cook "Implementar notificaciones WebSocket según el plan"

# ClaudeKit hará:
# - Crear schema de eventos
# - Implementar servidor WebSocket
# - Crear cliente de conexión
# - Agregar manejo de errores
# - Escribir tests

Testing

# Paso 3: Validar
claude test "WebSocket notifications"

# Tester agent creará:
# - Unit tests para handlers
# - Integration tests E2E
# - Mock server para tests
# - Reporte de cobertura

Deployment

# Paso 4: Commit y deploy
claude commit
git push origin main

Workflow 2: Debug de Producción

Análisis

# Investigar problema
claude debug "Users reporting timeout errors on checkout"

# Debugger agent:
# 1. Busca patrones en logs
# 2. Traza ejecución del código
# 3. Identifica cuello de botella
# 4. Sugiere fixes con impacto

Solución

# Implementar fix
claude cook "Fix payment processing timeout"

# Validar
claude test "checkout flow"

Workflow 3: Refactorizar Código Legacy

Mapeo

# Analizar código existente
claude scout "Analyze authentication system"

# Scout crea:
# - Mapa de arquitectura
# - Dependencias identificadas
# - Code smells encontrados

Planning

# Planear refactor
claude plan "Migrate from sessions to JWT"

Implementation

# Limpiar e implementar
claude clear
claude cook "Implement JWT authentication as planned"

Validación

# Asegurar que nada se rompió
claude test "authentication system"

Workflow 4: Code Review Automatizado

Review Continuo

# Revisar cambios recientes
claude review

# Code reviewer analiza:
# - Calidad del código
# - Vulnerabilidades de seguridad
# - Performance issues
# - Best practices
# - Documentación faltante

Review Específico

# Revisar archivo específico
claude review src/components/Header.tsx

# Revisar con estándares estrictos
claude review --strict --security

Workflow 5: Mantener Documentación

Actualización Automática

# Después de cambios significativos
claude docs update

# Docs manager:
# - Actualiza architecture docs
# - Sincroniza changelog
# - Actualiza roadmap
# - Revisa referencias cruzadas

Patrones de Comandos

Desarrollo Iterativo

# 1. Plan feature
claude plan "Feature X"

# 2. Implementar
claude cook "Implement Feature X según plan"

# 3. Validar
claude test

# 4. Review
claude review

# 5. Commit
claude commit

Hotfix Rápido

# Fix rápido sin research
claude cook "Fix critical bug" --fast --no-test

Feature Completa

# Con investigación completa
claude cook "Major feature" --parallel

# Múltiples agentes trabajando simultáneamente

Errores Comunes

Error 1: Saltarse el Planning

# ❌ MAL - Directo al código sin plan
claude cook "Agregar auth compleja"

# ✅ BIEN - Planear primero
claude plan "Agregar auth con OAuth2"
claude cook "Implementar auth según plan"

Error 2: Ignorar Tests

# ❌ MAL - Sin tests
claude cook "Feature" --no-test

# ✅ BIEN - Con tests
claude cook "Feature"
claude test

Error 3: No Revisar

# ❌ MAL - Commit sin revisar
git commit -am "feature"

# ✅ BIEN - Revisar primero
claude review
claude commit

Siguiente: Skills Populares

Domina las skills más utilizadas en producción.

---

¿Dudas? Usa claude ask "tu pregunta" en cualquier momento.