Un sistema modular de agentes IA especializados para desarrollo full-stack.
Cada stack (combinación de tecnologías frontend + backend) tiene sus propios agentes personalizados que entienden sus patrones, mejores prácticas y herramientas específicas.
| Documento | Propósito |
|---|---|
| VISION.md | Visión general del proyecto, filosofía y casos de uso |
| STACKS-ROADMAP.md | Plan de stacks actuales y futuros con timeline |
| NEW-STACK-TEMPLATE.md | Guía paso a paso para agregar nuevos stacks |
| Este README | Guía rápida de uso y estructura del proyecto |
agents/
├── README.md ← Guía rápida (este archivo)
├── VISION.md ← Visión general y filosofía
├── STACKS-ROADMAP.md ← Plan de stacks futuros
├── NEW-STACK-TEMPLATE.md ← Cómo agregar nuevos stacks
│
├── php+angular/ ← Stack: PHP (Laravel) + Angular ✅
│ ├── README.md (Guía específica del stack)
│ ├── FULLSTACK-AGENT.md (Orquestador principal)
│ ├── ARCHITECTURE-AGENT.md (Orquestador de diseño)
│ ├── ANGULAR-AGENT.md (Especialista frontend)
│ ├── LARAVEL-AGENT.md (Especialista backend)
│ ├── TESTING-AGENT.md (Especialista en QA)
│ ├── DEVOPS-AGENT.md (Especialista en DevOps)
│ └── AGENT-CALLS-EXAMPLES.md (6 ejemplos de uso)
│
├── python+react/ ← Stack: Python + React (Próximo 📋)
├── nodejs+vue/ ← Stack: Node.js + Vue (Próximo 📋)
└── [más stacks futuros...]
┌─────────────────────────────────────┐
│ AGENTES PRINCIPALES (2) │
├─────────────────────────────────────┤
│ @fullstack-agent → Features end-to-end
│ @architecture-agent → Diseño de sistemas
├─────────────────────────────────────┤
│ SUBAGENTES ESPECIALIZADOS (4) │
├─────────────────────────────────────┤
│ @[frontend]-agent → Especialista UI
│ @[backend]-agent → Especialista API
│ @testing-agent → Especialista QA
│ @devops-agent → Especialista CI/CD
└─────────────────────────────────────┘
Usuario solicita feature
↓
@fullstack-agent ORQUESTA
├─ @architecture-agent VALIDA diseño
├─ @[frontend]-agent IMPLEMENTA UI
├─ @[backend]-agent IMPLEMENTA API
├─ @testing-agent ESCRIBE tests
└─ @devops-agent CONFIGURA deploy
↓
Feature completa: código + tests + deploy
| Stack | Frontend | Backend | Status | Ubicación |
|---|---|---|---|---|
| PHP + Angular | Angular 21 | Laravel 12 | ✅ Completo | php+angular/ |
| Python + React | React 19 | Django 5.0 | 📋 Próximo | - |
| Node.js + Vue | Vue 3 | Express.js | 📋 Próximo | - |
| Go + Svelte | Svelte 4 | Go Fiber | 📋 Futuro | - |
| Ruby + Next.js | Next.js 14 | Rails 7 | 📋 Futuro | - |
Ver todas las especificaciones: STACKS-ROADMAP.md
# 1. Navega al stack
cd php+angular
# 2. Lee la guía del stack
cat README.md
# 3. Usa los agentes
@fullstack-agent Build shopping cart feature# 1. Lee la guía de contribución
cat NEW-STACK-TEMPLATE.md
# 2. Copia un stack existente
mkdir nodejs+vue
cp php+angular/*.md nodejs+vue/
# 3. Personaliza para tu stack
# (Renombra archivos, actualiza ejemplos, etc.)
# 4. ¡Listo!Guía detallada: NEW-STACK-TEMPLATE.md
@fullstack-agent Build user authentication:
- Login/signup forms with validation
- JWT token management
- User profile page
- Database storage
- API endpoints
- Tests (>85% coverage)
- CI/CD deployment
Resultado: Feature completa en minutos ✅
@angular-agent Build dashboard component:
- Real-time data updates
- Virtual scrolling
- Error handling
- Tests >80%
@laravel-agent Build user API:
- GET/POST/PUT/DELETE endpoints
- Input validation
- Authorization checks
- Feature tests
@architecture-agent Design e-commerce system:
- Entity relationships
- API contracts
- Database design
- Scaling strategy
@testing-agent Improve coverage from 45% to 85%:
- Analyze gaps
- Write missing tests
- Coverage report
@devops-agent Setup CI/CD:
- GitHub Actions
- Docker images
- Health checks
- Monitoring
Ver 7 ejemplos completos: php+angular/AGENT-CALLS-EXAMPLES.md
Cada stack proporciona:
Calidad
- ✅ Tests > 80% coverage
- ✅ Patrones SOLID
- ✅ Código limpio y mantenible
Performance
- ✅ API responses < 200ms
- ✅ Bundle optimizado
- ✅ Sin N+1 queries
Seguridad
- ✅ Input validation
- ✅ Authorization checks
- ✅ HTTPS en prod
DevOps
- ✅ Dockerfile
- ✅ GitHub Actions
- ✅ Health checks
- VISION.md: Entiende la filosofía del proyecto
- STACKS-ROADMAP.md: Qué stacks vienen próximo
- php+angular/README.md: Guía de uso del stack
- php+angular/AGENT-CALLS-EXAMPLES.md: 7 ejemplos
- NEW-STACK-TEMPLATE.md: Cómo agregar stacks
- STACKS-ROADMAP.md: Stacks solicitados
- Modularidad: Cada stack independiente
- Consistencia: Misma estructura en todos
- Especialización: Agentes expertos en su tech
- Escalabilidad: Fácil agregar nuevos stacks
- Documentación: Guías claras y ejemplos
¿Quieres agregar un nuevo stack?
- Lee NEW-STACK-TEMPLATE.md
- Sigue el template paso a paso
- Asegúrate de documentar bien
- ¡Contribuye!
Stacks Completados: 1/8 (12.5%)
├─ ✅ PHP + Angular
Stacks en Progreso: 0
├─ (Ninguno actualmente)
Próximos Stacks: 2
├─ 📋 Python + React
├─ 📋 Node.js + Vue
Futuros Stacks: 5
├─ 📋 Go + Svelte
├─ 📋 Ruby + Next.js
├─ 📋 Java + Angular
├─ 📋 C# + Blazor
└─ 📋 Rust + TypeScript
Timeline completo: STACKS-ROADMAP.md
Cada stack es una oportunidad de escribir mejor código, más rápido, con confianza.