Template de planificación arquitectónica avanzada
Componentes Principales:
- Objetivo y formato - Instrucciones para la IA
- Template de salida completo - Estructura exacta que debe generar la IA
- Sección de input - Lo que la persona debe completar
- Directrices finales - Reglas adicionales para la IA
¿Cómo usarlo?
Paso 1: Completar la sección de contexto
La persona completa la sección <contexto_input> con información específica del proyecto:
**Visión General del Proyecto**:
Plataforma de e-learning para cursos de programación donde instructores suben videos y estudiantes obtienen certificados...
**Objetivos de Negocio**:
1000 usuarios en 6 meses, $10k MRR primer año, 80% tasa completación...
**Usuarios Objetivo**:
Instructores de programación, estudiantes autodidactas, bootcamps...
**Restricciones Técnicas**:
Stack preferido: Next.js, NestJS, PostgreSQL...
[etc...]
Paso 2: Enviar todo el template como prompt
- Copia TODO el template completo
- Incluye las instrucciones + el contexto completado
- Envía a Claude/ChatGPT o cualquier otro LLM con que quieras crear la planificación
Paso 3: La IA devuelve SOLO la estructura markdown
La IA generará únicamente la estructura planificada, siguiendo exactamente el formato definido:
## Visión Estratégica del Proyecto
**Nombre**: Plataforma CodeLearn
**Declaración de Visión**: Democratizar la educación en programación...
### Usuarios Objetivo
* **Usuario Primario**: Instructores de programación con 2-5 años experiencia...
* **Usuario Secundario**: Estudiantes autodidactas entre 18-35 años...
[etc... siguiendo exactamente la estructura definida]
Template
<objetivo>
Eres un Arquitecto de Software Senior con 15+ años de experiencia diseñando aplicaciones web y móviles a gran escala. Te especializas en metodologías de desarrollo impulsado por IA y stacks tecnológicos modernos.
Crea un plan arquitectónico completo y listo para implementación que servirá como base para desarrollo asistido por IA. Debe ser suficientemente detallado para eliminar ambigüedades para desarrolladores humanos y asistentes de IA.
Analiza el proyecto considerando:
- **QUÉ**: Definición del producto y alcance técnico
- **QUIÉN**: Usuarios objetivo, stakeholders, equipo de desarrollo
- **POR QUÉ**: Valor de negocio, diferenciación del mercado
- **CÓMO**: Diferenciación técnica y ventajas competitivas
- **CUÁNDO**: Timeline de desarrollo y prioridades
- **DÓNDE**: Targets de deployment y escalabilidad
</objetivo>
<formato>
Devuelve **únicamente** esta estructura Markdown—sin preámbulos o despedidas adicionales.
## Visión Estratégica del Proyecto
**Nombre**: [Nombre específico del proyecto]
**Declaración de Visión**: [1-2 oraciones del objetivo final]
**Problema a Resolver**: [Problema específico con impacto cuantificable]
**Propuesta de Valor Única**: [Diferenciación clara vs competencia]
### Usuarios Objetivo
* **Usuario Primario**: [Persona detallada con características específicas]
* **Usuario Secundario**: [Grupos adicionales y sus necesidades]
* **Administradores**: [Roles administrativos y de gestión]
### Métricas de Éxito
* **KPIs Técnicos**: [Performance, disponibilidad, escalabilidad - números específicos]
* **KPIs de Negocio**: [Adopción, ingresos, engagement - números específicos]
* **KPIs de Timeline**: [Hitos de desarrollo y fechas específicas]
---
## Stack Tecnológico
### Frontend
* **Framework**: [Tecnología específica + versión + justificación]
* **Gestión de Estado**: [Librería y patrón arquitectónico]
* **UI Components**: [Sistema de diseño y approach]
* **Build Tools**: [Bundlers, compiladores, optimizadores]
* **Testing**: [Unit, integration, e2e frameworks]
### Backend
* **Runtime**: [Lenguaje + versión + framework]
* **Base de Datos**: [Primaria y secundaria con justificación]
* **Autenticación**: [Estrategia específica de auth]
* **API**: [REST/GraphQL/gRPC + versionado]
* **Cache**: [Redis, CDN, application-level]
### Infraestructura
* **Cloud Provider**: [AWS/GCP/Azure + servicios específicos]
* **Containerización**: [Docker/Kubernetes/Serverless]
* **CI/CD**: [Herramientas y estrategia de deployment]
* **Monitoreo**: [Logging, métricas, alertas]
* **CDN**: [Estrategia de distribución de contenido]
---
## Flujo MVP Principal
Descripción paso a paso del proceso mínimo viable principal:
1. **[Paso 1]**: [Acción específica del usuario y respuesta del sistema]
2. **[Paso 2]**: [Acción específica del usuario y respuesta del sistema]
3. **[Paso 3]**: [Acción específica del usuario y respuesta del sistema]
4. **[Paso 4]**: [Acción específica del usuario y respuesta del sistema]
5. **[Paso 5]**: [Acción específica del usuario y respuesta del sistema]
---
## Características de Lanzamiento (MVP)
### [Nombre de Característica 1]
*Resumen de 2-3 oraciones de qué hace esta característica*
**Requisitos Funcionales**:
* [Capacidad específica 1 con criterios de aceptación]
* [Capacidad específica 2 con criterios de aceptación]
* [Capacidad específica 3 con criterios de aceptación]
**Modelo de Datos**:
```
[Esquema específico de entidades, relaciones, tipos de datos]
```
**Endpoints de API**:
```
POST /api/[recurso] - [Descripción específica]
GET /api/[recurso] - [Descripción específica]
PUT /api/[recurso]/:id - [Descripción específica]
DELETE /api/[recurso]/:id - [Descripción específica]
```
**Componentes UI**:
* [Componente específico con estados definidos]
* [Componente específico con estados definidos]
* [Componente específico con estados definidos]
**Tech Stack Involucrado**:
* [Tecnología específica 1]
* [Tecnología específica 2]
* [Servicio de terceros específico]
**Criterios de Aceptación**:
* [Criterio medible específico 1]
* [Criterio medible específico 2]
* [Criterio medible específico 3]
---
### [Nombre de Característica 2]
*[Mismo formato detallado que la característica anterior]*
---
## Características Futuras (Post-MVP)
### [Nombre de Característica Futura 1]
**Prioridad**: [Alta/Media/Baja + justificación]
**Timeline Estimado**: [Esfuerzo de desarrollo y dependencias]
**Requisitos Principales**:
* [Requisito principal 1]
* [Requisito principal 2]
* [Requisito principal 3]
**Tech Stack Involucrado**:
* [Tecnología o servicio 1]
* [Tecnología o servicio 2]
**Dependencias**:
* [Dependencia específica 1]
* [Dependencia específica 2]
---
## Arquitectura del Sistema
### Diagrama de Contexto (C1)
```
[Descripción detallada para generar diagrama SVG que muestre]:
- Sistema principal en el centro
- Usuarios externos (roles específicos)
- Sistemas externos (APIs, servicios de terceros)
- Flujos de datos principales entre elementos
- Colores: [Sistema principal: azul, Usuarios: verde, Sistemas externos: naranja]
```
### Diagrama de Contenedores (C2)
```
[Descripción detallada para generar diagrama SVG que muestre]:
- Aplicación Web Frontend [React + versión]
- Aplicación Móvil [si aplica - tecnología específica]
- API Gateway [tecnología específica]
- Servicios Backend [tecnología + responsabilidades]
- Bases de Datos [tecnología + propósito]
- Cache [Redis + uso específico]
- Storage [S3/similar + contenido]
- Flujos de comunicación entre contenedores
- Protocolos específicos (HTTP, WebSocket, etc.)
- Colores: [Frontend: azul claro, Backend: azul oscuro, Datos: verde, Infraestructura: gris]
```
### Diagrama de Componentes (C3) - [Servicio Principal]
```
[Descripción detallada para generar diagrama SVG que muestre]:
- Controllers [endpoints específicos]
- Services [lógica de negocio específica]
- Repositories [acceso a datos específico]
- Models [entidades específicas]
- Middlewares [autenticación, validación, logging]
- External Clients [integraciones de terceros]
- Relaciones y dependencias entre componentes
- Colores: [Controllers: púrpura, Services: azul, Data: verde, External: naranja]
```
### Consideraciones de Arquitectura
**Performance**:
* [Objetivo específico de latencia - ej: <200ms API response]
* [Objetivo específico de throughput - ej: 1000 req/sec]
* [Estrategia de cache específica]
* [Optimizaciones de base de datos específicas]
**Escalabilidad**:
* [Triggers de auto-scaling específicos]
* [Estrategia de microservicios y límites]
* [Estrategia de CDN y distribución global]
* [Plan de scaling de base de datos]
**Seguridad**:
* [Estrategia de autenticación específica]
* [Estrategia de autorización específica]
* [Cifrado de datos específico]
* [Compliance requerido - GDPR, HIPAA, etc.]
**Reliability**:
* [Target de uptime específico - ej: 99.9%]
* [Estrategias de fault tolerance específicas]
* [Backup y recovery específicos]
* [Health checks y monitoring específicos]
---
## Plan de Implementación
### Fase 1: Fundamentos (Semanas 1-4)
**Entregables**:
* [Entregable específico 1 con criterios]
* [Entregable específico 2 con criterios]
* [Entregable específico 3 con criterios]
**Hitos Clave**:
* [Hito específico con fecha]
* [Hito específico con fecha]
### Fase 2: MVP Core (Semanas 5-12)
**Entregables**:
* [Entregable específico 1 con criterios]
* [Entregable específico 2 con criterios]
* [Entregable específico 3 con criterios]
**Hitos Clave**:
* [Hito específico con fecha]
* [Hito específico con fecha]
### Fase 3: Testing y Lanzamiento (Semanas 13-16)
**Entregables**:
* [Entregable específico 1 con criterios]
* [Entregable específico 2 con criterios]
**Hitos Clave**:
* [Hito específico con fecha]
* [Hito específico con fecha]
---
## Estrategia de Testing
### Testing Automatizado
**Unit Tests**:
* [Cobertura objetivo específica - ej: 85%]
* [Casos críticos a cubrir específicos]
* [Herramientas específicas a usar]
**Integration Tests**:
* [Escenarios de API específicos]
* [Integraciones de terceros específicas]
* [Flujos end-to-end críticos]
**Performance Tests**:
* [Load testing específico - usuarios concurrentes]
* [Stress testing específico - límites del sistema]
* [Benchmarking específico - métricas objetivo]
### Testing Manual
* [Escenarios de user acceptance específicos]
* [Testing de dispositivos específico]
* [Testing de navegadores específico]
---
## Estrategia de Deployment
### Ambientes
**Development**: [Configuración específica y propósito]
**Staging**: [Configuración específica y propósito]
**Production**: [Configuración específica y propósito]
### CI/CD Pipeline
**Build Stage**:
* [Pasos específicos de build]
* [Validaciones automáticas]
* [Artifacts generados]
**Test Stage**:
* [Tests automatizados ejecutados]
* [Gates de calidad específicos]
* [Reportes generados]
**Deploy Stage**:
* [Estrategia de deployment - blue/green, canary]
* [Rollback automático triggers]
* [Health checks post-deployment]
### Monitoreo Post-Launch
**Métricas de Aplicación**:
* [KPIs específicos a monitorear]
* [Alertas automáticas configuradas]
* [Dashboards principales]
**Métricas de Infraestructura**:
* [Recursos específicos a monitorear]
* [Thresholds de alertas]
* [Escalation procedures]
---
## Análisis de Riesgos
### Riesgos Técnicos
**[Riesgo Específico 1]**:
* **Probabilidad**: [Alta/Media/Baja]
* **Impacto**: [Alto/Medio/Bajo]
* **Mitigación**: [Estrategia específica]
* **Plan B**: [Alternativa específica]
**[Riesgo Específico 2]**:
* [Mismo formato]
### Riesgos de Negocio
**[Riesgo Específico 1]**:
* **Probabilidad**: [Alta/Media/Baja]
* **Impacto**: [Alto/Medio/Bajo]
* **Mitigación**: [Estrategia específica]
* **Indicadores**: [Métricas de early warning]
---
## Preguntas y Clarificaciones
### Decisiones Técnicas Pendientes
* [Pregunta específica que requiere decisión técnica]
* [Trade-off específico que requiere priorización]
* [Integración específica que requiere validación]
### Validaciones de Negocio Requeridas
* [Regla de negocio específica que necesita definición]
* [Flujo de usuario específico que requiere validación]
* [Métrica de éxito específica que necesita confirmación]
### Consideraciones de Compliance
* [Requirement legal específico que necesita revisión]
* [Estándar de seguridad específico que necesita implementación]
* [Política de datos específica que necesita definición]
---
## Próximos Pasos Inmediatos
1. [Acción específica con responsable y fecha]
2. [Acción específica con responsable y fecha]
3. [Acción específica con responsable y fecha]
4. [Validación específica requerida con stakeholder]
5. [Decisión específica pendiente con deadline]
</formato>
<contexto_input>
**LLENAR ESTA SECCIÓN CON LA INFORMACIÓN ESPECÍFICA DEL PROYECTO:**
**Visión General del Proyecto**:
[Descripción detallada de lo que estás construyendo - problema, solución, usuarios]
**Objetivos de Negocio**:
[KPIs específicos, métricas de éxito, timeline de lanzamiento]
**Usuarios Objetivo**:
[Personas específicas con características, necesidades, comportamientos]
**Restricciones Técnicas**:
[Stack preferido, sistemas existentes, limitaciones, compliance]
**Contexto del Equipo**:
[Tamaño, skills, timeline disponible, presupuesto, recursos]
**Diferenciación Competitiva**:
[Competencia existente, ventaja única, posicionamiento de mercado]
**Requisitos de Escala**:
[Usuarios esperados, volumen de datos, distribución geográfica, crecimiento]
</contexto_input>
<directrices>
- Ser específico y medible en todos los requisitos
- Incluir números concretos en métricas y objetivos
- Definir criterios de aceptación claros para cada feature
- Especificar tecnologías exactas con versiones cuando sea relevante
- Incluir consideraciones de seguridad, performance y escalabilidad
- Abordar manejo de errores y casos edge específicos
- Considerar mobile-first y responsive design
- Documentar decisiones arquitectónicas y trade-offs
- Incluir estrategias de testing y deployment específicas
- Proporcionar estimaciones realistas de timeline y recursos
</directrices>````