🤖 Sistema de 6 Agentes Especializados

Este proyecto define 6 agentes especializados en desarrollo full-stack. Cada agente es un archivo markdown con su propia metodología de programación.

📋 Los 6 Agentes

Cada agente está optimizado para una especialidad específica:

Archivo	Agente	Especialidad	Modo
FULLSTACK-AGENT.md	@fullstack-agent	Angular 21 + Laravel 12 end-to-end	Agent
ARCHITECTURE-AGENT.md	@architecture-agent	Diseño de arquitectura	Agent
ANGULAR-AGENT.md	@angular-agent	Angular 21 componentes y servicios	Subagent
LARAVEL-AGENT.md	@laravel-agent	Laravel 12 APIs y backend	Subagent
TESTING-AGENT.md	@testing-agent	Tests y QA	Subagent
DEVOPS-AGENT.md	@devops-agent	CI/CD e infraestructura	Subagent

Jerarquía de Agentes

AGENTES PRINCIPALES (Orquestadores)
├── @fullstack-agent      → Completa features end-to-end
└── @architecture-agent   → Diseña arquitecturas

SUBAGENTES (Especializados)
├── @angular-agent        → Frontend especializado
├── @laravel-agent        → Backend especializado
├── @testing-agent        → Tests y QA
└── @devops-agent         → CI/CD e infraestructura

🚀 Cómo Usar

Menciona el agente en tu request:

@fullstack-agent Build complete shopping cart feature
@architecture-agent Design authentication system
@angular-agent crea un componente de login con validación
@laravel-agent crea un endpoint GET /api/users con búsqueda
@testing-agent escribe tests para LoginComponent (80%+ coverage)
@devops-agent configura CI/CD con GitHub Actions

📚 Ejemplos de Llamadas

✅ OPCIÓN 1: Feature Completa (Recomendado)

Usa @fullstack-agent para construir features end-to-end. Automáticamente orquesta:

• Diseño con @architecture-agent
• Frontend con @angular-agent
• Backend con @laravel-agent
• Tests con @testing-agent
• Deploy con @devops-agent

@fullstack-agent Build complete shopping cart feature:
- Users can add/remove products
- Real-time price calculation
- Checkout with payment processing
- Store orders in database with items
- Handle errors (out of stock, payment failed)
- Load orders list with pagination
- Deploy with CI/CD
- Full test coverage (>85%)
- Loading states and error messages

Resultado: Sistema completo, testeado y deployado ✅

---

✅ OPCIÓN 2: Solo Validar Arquitectura

Cuando no sabes cómo diseñar algo:

@architecture-agent Design authentication system:
- Support multiple providers (email, Google, GitHub)
- JWT tokens for API authentication
- Refresh token rotation
- Session management
- Security considerations
- Scaling to millions of users

Provide:
1. Entity design
2. API endpoints
3. Token strategy
4. Authorization patterns
5. Security checklist

---

✅ OPCIÓN 3: Solo Frontend

Cuando necesitas solo Angular:

@angular-agent Build user dashboard component:
- Display users list with pagination
- Filter and search functionality
- Delete user with confirmation
- Optimized for 10k+ users with virtual scrolling
- OnPush change detection, Signals for state
- Full tests (>80% coverage)

---

✅ OPCIÓN 4: Solo Backend

Cuando necesitas solo Laravel:

@laravel-agent Build user management API:
- GET /api/users (with filtering, pagination)
- POST /api/users (create with validation)
- PUT /api/users/{id} (update)
- DELETE /api/users/{id}
- Authorization (users see only their data)
- Feature tests (>80% coverage)
- Query optimization with eager loading

---

✅ OPCIÓN 5: Solo Tests

Cuando necesitas mejorar cobertura:

@testing-agent Improve test coverage for PaymentService:
- Current coverage: 42%
- Target: 85% coverage
- Missing: error scenarios, edge cases, concurrency

Analyze:
1. What's not tested?
2. What are the risks?
3. Write additional tests
4. Report coverage improvement

---

✅ OPCIÓN 6: Solo Deployment

Cuando necesitas CI/CD:

@devops-agent Set up complete CI/CD:
- GitHub Actions workflow
- Docker images for frontend and backend
- Deploy to staging on merge
- Manual approval for production
- Health checks and rollback
- Monitoring with Prometheus
- Alerts to Slack

---

📊 Comparación: Cuándo Usar Cada Agente

Necesidad	Agente	Razón
Feature completa (UI + API + DB)	@fullstack-agent	Coordina todos los aspectos
No sabes cómo diseñar	@architecture-agent	Valida decisiones
Solo componentes Angular	@angular-agent	Especialista en frontend
Solo endpoints Laravel	@laravel-agent	Especialista en backend
Mejorar coverage de tests	@testing-agent	Especialista en QA
Configurar deployment	@devops-agent	Especialista en infraestructura

📁 Estructura

Cada archivo es un agente independiente con:

• Frontmatter YAML: Configuración (descripción, modo, temperature, permisos)
• Prompt: Instrucciones de cómo la IA programa
• Patrones: Cómo el agente trabaja
• Checklist: Validación antes de entregar
• Cuándo usar: Casos de uso específicos

Ejemplo formato:

---
description: Descripción del agente
mode: subagent
temperature: 0.3
tools:
  bash: true
  edit: true
  write: true
---

You are a [specialist]. Your role is to...

## How you program in [technology]

### Step 1: ...
### Step 2: ...

✅ Estándares Globales

Código

• TypeScript: Strict mode, sin any
• PHP: 8.3+, tipos completos
• Clean code: Máximo 50 líneas por método
• Testing: Mínimo 80% coverage

Performance

• API responses: < 200ms
• Bundle Angular: < 500KB
• Queries: Sin N+1
• Tests: < 30 segundos

Seguridad

• Input validation: SIEMPRE
• Authorization: Explícita
• CSRF protection: Activada
• HTTPS: Siempre en prod

🎯 Workflow Típico

Workflow 1: Feature Completa (Recomendado)

@fullstack-agent Build [feature]:
- Automáticamente valida arquitectura
- Implementa frontend con @angular-agent
- Implementa backend con @laravel-agent
- Escribe tests con @testing-agent
- Configura deploy con @devops-agent

Workflow 2: Problemas Específicos

Problema en frontend:
@angular-agent Fix memory leaks in UserComponent

Problema en backend:
@laravel-agent Optimize slow /api/orders endpoint

Baja cobertura de tests:
@testing-agent Improve coverage from 42% to 85%

Configurar deployment:
@devops-agent Setup GitHub Actions CI/CD

Workflow 3: Diseño + Implementación

Paso 1: Validar diseño
@architecture-agent Design notification system

Paso 2: Implementar basado en diseño
@fullstack-agent Build notification system [paste architecture]

🔍 Cómo Cada Agente Programa

Agentes Principales (Orquestadores)

@fullstack-agent (mode: agent)

• Coordina features completas end-to-end
• Automáticamente llama subagentes especializados
• Valida arquitectura con @architecture-agent
• Implementa frontend con @angular-agent
• Implementa backend con @laravel-agent
• Integra tests con @testing-agent
• Configura deploy con @devops-agent

@architecture-agent (mode: agent)

• Diseña sistemas con SOLID principles
• Usa ADR (Architecture Decision Record) format
• Evalúa trade-offs entre opciones
• Proporciona guías de implementación
• Transversal a todos los agentes

Subagentes Especializados

@angular-agent: ChangeDetectionStrategy.OnPush, takeUntilDestroyed, Signals, validation en dos niveles, tests 80%+

@laravel-agent: PHP 8.3 typing, Eloquent eager loading, FormRequest validation, database transactions, tests 80%+

@testing-agent: Arrange-Act-Assert, mocking, edge cases, coverage analysis, all testing strategies

@devops-agent: GitHub Actions, Docker multi-stage, health checks, monitoring, rollback strategies

---

Ver más ejemplos detallados en: AGENT-CALLS-EXAMPLES.md

---

Cada agente es completamente independiente. Úsalos según tus necesidades.