GitHub - Programmercito/agents: Programmercito/agents es un sistema de agentes de IA para desarrollo full‑stack. Cada stack integra frontend y backend con seis agentes especializados que automatizan diseño, implementación, pruebas y despliegue de features de forma extensible y consistente.
🤖 Sistema Modular de Agentes por Stack
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.
📚 Documentación Principal
| 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 |
📁 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...]
🎯 Concepto Rápido
Un Stack = 6 Agentes Especializados
┌─────────────────────────────────────┐
│ 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
└─────────────────────────────────────┘
Ciclo de Una Feature
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
📊 Stacks Disponibles
| 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
🚀 Inicio Rápido
Usar un Stack Existente
# 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
Agregar un Nuevo Stack
# 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
🎓 Ejemplos de Uso
Caso 1: Feature Completa (Recomendado)
@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 ✅
Caso 2: Solo Frontend
@angular-agent Build dashboard component:
- Real-time data updates
- Virtual scrolling
- Error handling
- Tests >80%
Caso 3: Solo Backend
@laravel-agent Build user API:
- GET/POST/PUT/DELETE endpoints
- Input validation
- Authorization checks
- Feature tests
Caso 4: Validar Diseño
@architecture-agent Design e-commerce system:
- Entity relationships
- API contracts
- Database design
- Scaling strategy
Caso 5: Mejorar Tests
@testing-agent Improve coverage from 45% to 85%:
- Analyze gaps
- Write missing tests
- Coverage report
Caso 6: Configurar Deploy
@devops-agent Setup CI/CD:
- GitHub Actions
- Docker images
- Health checks
- Monitoring
Ver 7 ejemplos completos: php+angular/AGENT-CALLS-EXAMPLES.md
✅ Características Garantizadas
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
📖 Documentación Adicional
Para Usuarios
- 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
Para Contribuidores
- NEW-STACK-TEMPLATE.md: Cómo agregar stacks
- STACKS-ROADMAP.md: Stacks solicitados
🎨 Filosofía del Sistema
- 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
🤝 Contribuir
¿Quieres agregar un nuevo stack?
- Lee NEW-STACK-TEMPLATE.md
- Sigue el template paso a paso
- Asegúrate de documentar bien
- ¡Contribuye!
📊 Progreso del Proyecto
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
🔗 Links Rápidos
Cada stack es una oportunidad de escribir mejor código, más rápido, con confianza.