Guía de Desarrollo de Funcionalidades

Flujo de trabajo completo para desarrollar nuevas funcionalidades con Claude-Craft.

---

Flujo de Trabajo TDD

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ 1. Analizar │ --> │ 2. Diseñar  │ --> │  3. Tests   │
└─────────────┘     └─────────────┘     └─────────────┘
                                              │
                                              v
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  6. Revisar │ <-- │5. Refactorizar│ <--│4. Implementar│
└─────────────┘     └─────────────┘     └─────────────┘

---

Fase 1: Análisis

/common:analyze-feature "Autenticación de usuarios con tokens JWT"

@research-assistant Investiga las mejores prácticas para autenticación JWT en Symfony 7

---

Fase 2: Diseño

Base de Datos

@database-architect Diseña el esquema para la entidad User con roles y permisos

API

@api-designer Diseña la API REST para gestión de usuarios

Decisión Arquitectónica

/common:architecture-decision "Cómo implementar control de acceso basado en roles"

---

Fase 3: Escribir Tests

@tdd-coach Ayúdame a escribir tests para el método de autenticación de UserService

Tipos de Tests

Tests Unitarios:

public function test_user_can_change_password(): void
{
    $user = User::create('test@example.com', 'old-password');
    $user->changePassword('new-password');
    $this->assertTrue($user->verifyPassword('new-password'));
}

Tests de Integración:

public function test_user_service_creates_user_in_database(): void
{
    $service = $this->container->get(UserService::class);
    $user = $service->createUser('test@example.com', 'password');
    $this->assertNotNull($user->getId());
}

---

Fase 4: Implementación

Comandos de Generación

# Symfony
/symfony:generate-crud User
/symfony:api-endpoint POST /api/users CreateUserRequest

# Flutter
/flutter:generate-bloc Authentication
/flutter:generate-screen LoginScreen

# Python
/python:generate-endpoint POST /users CreateUser
/python:generate-service UserService

# React
/react:generate-component UserProfile
/react:generate-hook useAuth

---

Fase 5: Refactorización

/symfony:check-code-quality
/symfony:check-architecture

@refactoring-specialist Revisa esta clase de servicio para mejoras potenciales

---

Fase 6: Revisión

# Auditoría completa (puntuación /100)
/symfony:check-compliance

@symfony-reviewer Revisa mi implementación completa de autenticación de Usuario

/common:security-audit

---

Checklist de Funcionalidad

• [ ] User story definida
• [ ] Tests escritos (TDD)
• [ ] Código implementado
• [ ] Tests pasan (80%+ cobertura)
• [ ] Revisión efectuada
• [ ] Documentación actualizada

---

Resumen de Agentes

Agente	Uso
@api-designer	Diseño de endpoints API
@database-architect	Diseño de esquemas BD
@tdd-coach	Guía para escritura de tests
@refactoring-specialist	Mejora de código
@{tech}-reviewer	Revisión de código

---

← Creación de Proyecto | Corrección de Bugs →