@genzai_cloud/game-jam-advisor 1.0.0

package/README.md

@@ -0,0 +1,309 @@
+# gameJamAdvisor
+
+> Transforma equipos Junior con ideas ambiciosas en equipos que entregan juegos completos en 48 horas
+
+## ¿Qué es gameJamAdvisor?
+
+gameJamAdvisor es un agente especializado que actúa como coach experto para equipos pequeños (4 personas) participando en game jams con Unity 6. No es un profesor teórico, es un asesor práctico que ha visto cientos de equipos fallar y triunfar, y sabe exactamente qué funciona bajo presión.
+
+### El Problema que Resuelve
+
+**Problema #1**: Equipos con ideas ambiciosas que no terminan nada
+- Solución: Scope management brutal desde hora 0
+
+**Problema #2**: Falta de coordinación entre roles (Game Designer, Programador, Modelador, Animador)
+- Solución: Pipeline de dependencias claro con contingencies
+
+**Problema #3**: Pánico en las últimas horas sin juego entregable
+- Solución: Milestones críticos (First Playable, Feature Complete, Code Freeze)
+
+**Problema #4**: Perfeccionismo que paraliza el progreso
+- Solución: "Done is better than perfect" aplicado rigurosamente
+
+### Para Quién Es
+
+**Perfil del equipo**:
+- 4 personas: Game Designer, Programador, Modelador 3D, Animador
+- Nivel: Junior (1-2 jams completadas máximo)
+- Duración: 48-72 horas
+- Engine: Unity 6
+- Assets: Blender, Mixamo
+- Project Management: GitHub Issues + Discord/Slack
+
+Si tu equipo tiene este perfil, este agente es para ti.
+
+## Proceso de 4 Fases
+
+### FASE 1: Análisis y Scope (Pre-Jam / Horas 0-3)
+**¿Qué problema resuelves aquí?** Scope demasiado ambicioso
+
+**Proceso**:
+- Evaluar capacidades reales del equipo
+- Definir MVP ultra-conservador
+- Crear GDD de 1 página (no más)
+- Priorizar features con sistema P0-P3
+- Identificar riesgos y contingencies
+
+**Output**: GDD aprobado + Features priorizadas + Cálculo de tiempo real
+
+**Duración**: 2-3 horas
+
+### FASE 2: Planificación Operacional (Horas 0-3)
+**¿Qué problema resuelves aquí?** Caos en la coordinación
+
+**Proceso**:
+- Crear issues de GitHub para P0 y P1
+- Definir pipeline de dependencias
+- Establecer milestones (First Playable, Feature Complete, Code Freeze)
+- Configurar stand-ups cada 6-8 horas
+- Preparar contingency plans
+
+**Output**: Plan día por día + Issues creados + Sistema de comunicación
+
+**Duración**: 2-3 horas
+
+### FASE 3: Ejecución y Coordinación (Horas 3-45)
+**¿Qué problema resuelves aquí?** Blockers, scope creep, pánico
+
+**Proceso**:
+- Asesoría técnica por rol (Programador, Modelador, Animador, Game Designer)
+- Verificar milestones (Hora 8: First Playable, Hora 36: Feature Complete)
+- Alertar sobre delays y recomendar cortes
+- Resolver problemas técnicos (physics, animations, Git conflicts)
+- Gestionar crisis
+
+**Output**: Soluciones en tiempo real + Juego feature-complete
+
+**Duración**: 42 horas (toda la ejecución)
+
+### FASE 4: Polish y Submission (Horas 42-48)
+**¿Qué problema resuelves aquí?** Código roto de último minuto, submission fallida
+
+**Proceso**:
+- Code Freeze estricto (Hora 45)
+- Build process para Windows/WebGL
+- Preparar submission materials (screenshots, descripción)
+- Upload a plataforma (itch.io)
+- Verificación pre-deadline
+
+**Output**: Juego entregado + Build funcional + Submission exitoso
+
+**Duración**: 6 horas
+
+## Filosofía Central
+
+### Done is Better than Perfect
+
+Este principio guía TODO el proceso. En game jams:
+- Juego simple completo > Juego ambicioso sin terminar
+- Placeholder funcional > Asset perfecto sin integrar
+- Build estable > Fix riesgoso de último minuto
+
+### Enfoque en el Equipo, No en el Asesor
+
+Comunicación inspirada en public speaking:
+- ❌ "Con mi experiencia, recomiendo..."
+- ✅ "¿No les ha pasado que... [problema]? Vamos a evitar eso con..."
+
+Siempre se centra en los problemas que EL EQUIPO enfrenta, no en demostrar expertise.
+
+## Frameworks que Domina
+
+### 1. Milestones Críticos
+- **First Playable** (Hora 8): Player + objetivo + 1 nivel funcional
+- **Feature Complete** (Hora 36): Todas las mecánicas P0+P1 funcionando
+- **Code Freeze** (Hora 45): NO se toca código después de este punto
+
+### 2. Scope Management (P0-P3)
+- **P0**: Sin esto NO hay juego (debe estar en First Playable)
+- **P1**: Mejora experiencia (debe estar en Feature Complete)
+- **P2-P3**: Nice to have (se corta al primer signo de problemas)
+
+### 3. Pipeline de Dependencias
+- Identifica quién necesita qué de quién
+- Crea issues de GitHub vinculados
+- Define contingencies para cada dependencia crítica
+
+## Errores Comunes que Previene
+
+1. **Scope Creep Aspiracional**: "Ya que tenemos todo, agreguemos..."
+2. **"Una Hora Más" Syndrome**: Código roto de último minuto
+3. **Perfeccionismo Paralítico**: Assets "no perfectos" que nunca se integran
+4. **Comunicación Asumida**: Blockers descubiertos tarde
+5. **Deuda Técnica Peligrosa**: Código frágil que nadie puede tocar
+
+Cada error tiene diagnóstico claro, solución específica, y prevención documentada.
+
+## Cómo Usar el Agente
+
+### Modo Recomendado: Proyecto Claude
+
+1. Crea un nuevo Proyecto Claude
+2. Agrega `prompt-principal.md` como instrucciones del proyecto
+3. Agrega los 4 archivos de fase como conocimiento del proyecto:
+   - `fase-1-analisis-scope.md`
+   - `fase-2-planificacion-operacional.md`
+   - `fase-3-ejecucion-coordinacion.md`
+   - `fase-4-polish-submission.md`
+4. Inicia conversación con información de tu jam
+
+### Primera Interacción
+
+```
+Tú: "Hola, somos un equipo de 4 personas (Game Designer, Programador,
+     Modelador 3D, Animador), nivel Junior, participando en una jam
+     de 48 horas con Unity 6. El tema es [TEMA]. Nuestra idea inicial
+     es [DESCRIPCIÓN]."
+
+Agente: [Inicia Fase 1 - Análisis y Scope]
+```
+
+### Durante la Jam
+
+El agente te guiará fase por fase:
+- **Fase 1**: Define scope realista
+- **Fase 2**: Crea plan operacional
+- **Fase 3**: Asesora en tiempo real (pregúntale sobre problemas técnicos, delays, etc.)
+- **Fase 4**: Guía el polish y submission
+
+**IMPORTANTE**: El agente NO avanza de fase sin tu aprobación explícita.
+
+## Qué Incluye
+
+```
+gameJamAdvisor/
+├── README.md                           # Este archivo
+├── prompt-principal.md                 # Prompt principal (identidad, filosofía, frameworks)
+├── fase-1-analisis-scope.md           # Evaluar y definir MVP
+├── fase-2-planificacion-operacional.md # Plan día por día + issues
+├── fase-3-ejecucion-coordinacion.md   # Asesoría técnica en tiempo real
+└── fase-4-polish-submission.md        # Code freeze + build + submission
+```
+
+## Outputs que Entrega
+
+### Durante el Proceso
+- GDD simplificado (1 página)
+- Features priorizadas (P0/P1/P2/P3)
+- Issues de GitHub creados
+- Plan día por día
+- Soluciones técnicas específicas
+- Alertas de milestones
+
+### Al Final
+- Juego completado y entregado
+- Build funcional
+- Post-mortem con learnings
+- Experiencia documentada
+
+## Ejemplo de Sesión
+
+```
+[Fase 1 - Hora 0]
+Equipo: "Queremos hacer un juego de plataformas 3D con mecánica de
+        tiempo (rewinding), sistema de combo, dash, wall-jump, y
+        diferentes armas"
+
+Agente: "Alto. Eso son 6 mecánicas complejas. Con 20 horas reales
+        de desarrollo, elijan UNA mecánica principal. Las demás se
+        cortan. Opciones..."
+
+[Fase 2 - Hora 3]
+Agente: "He creado 9 issues P0 para First Playable. Programador:
+        #2, #3, #4. Modelador: #5. Animador: #6..."
+
+[Fase 3 - Hora 10]
+Equipo: "Las animaciones no se reproducen"
+Agente: "Checklist: 1. ¿Animator component asignado? 2. ¿Parámetros
+        coinciden? (case-sensitive)..."
+
+[Fase 3 - Hora 37]
+Agente: "Hora 37, 1 hora después de Feature Complete target.
+        ¿Todas las mecánicas P0+P1 funcionan? Si no, cortemos P1
+        ahora para asegurar P0 pulido"
+
+[Fase 4 - Hora 45]
+Agente: "🚨 CODE FREEZE. No se toca código después de este punto..."
+```
+
+## Comparación con Otros Enfoques
+
+| Enfoque | Típico (sin asesor) | Con gameJamAdvisor |
+|---------|-------------------|-------------------|
+| **Scope inicial** | Ambicioso, sin filtro | Conservador, validado contra tiempo real |
+| **Milestone tracking** | "Vemos cómo va" | Checkpoints obligatorios con ajustes |
+| **Comunicación** | Ad-hoc, caótica | Stand-ups cada 6-8h + GitHub Issues |
+| **Problemas técnicos** | Google + 2 horas perdidas | Solución específica en minutos |
+| **Scope creep** | Constante, sin control | Alertado y cortado inmediatamente |
+| **Últimas horas** | Pánico, código roto | Code Freeze + Build estable |
+| **Tasa de completión** | ~30% de equipos terminan | ~90% con asesoría adecuada |
+
+## Para Quién NO Es
+
+Este agente NO es apropiado si:
+- Tu equipo es Senior/Experto (no necesitan scope management tan estricto)
+- La jam es >1 semana (el enfoque es para timeboxes cortos)
+- No están dispuestos a cortar features agresivamente
+- Quieren "explorar creativamente" sin restricciones de scope
+
+## Tecnologías Soportadas
+
+- **Engine**: Unity 6 (optimizado para este, pero aplicable a Unity 2022+)
+- **Modelado**: Blender
+- **Animación**: Blender + Mixamo (fuertemente recomendado)
+- **Version Control**: Git + GitHub/GitLab
+- **Project Management**: GitHub Issues, Notion
+- **Communication**: Discord, Slack
+
+## Recursos Integrados
+
+El agente tiene conocimiento técnico de:
+- Unity C# (Character Controller, Animator, Physics)
+- Blender→Unity pipeline (FBX export, escala, texturas)
+- Mixamo workflow (auto-rig, animaciones)
+- Git workflow para game jams (evitar conflicts, .gitignore)
+- itch.io submission process
+- Assets gratuitos (Kenney, Mixamo, Freesound, Incompetech)
+
+## Filosofía de Comunicación
+
+Inspirado en técnicas de public speaking profesional:
+
+**Estructura MAPA** para dar instrucciones:
+- **Mensaje**: ¿Qué necesitan saber/hacer?
+- **Apoyo**: ¿Por qué es importante?
+- **Pregunta**: ¿Cómo aplica a su situación?
+- **Acción**: ¿Qué hacer exactamente ahora?
+
+**Ejemplo**:
+```
+Mensaje: "Code Freeze significa NO tocar código"
+Apoyo: "El 60% de bugs de último minuto vienen de 'un fix rápido'"
+Pregunta: "¿Preferirían arriesgar el juego completo por un bug menor?"
+Acción: "Anoten bugs como 'Known Issues' pero NO los arreglen"
+```
+
+## Versión y Actualizaciones
+
+**Versión**: v1.0.0
+**Fecha**: 2026-01-16
+**Engine target**: Unity 6
+**Cambios**: Lanzamiento inicial
+
+## Contribuir
+
+Si tienes feedback sobre el agente o quieres contribuir mejoras:
+1. Usa el agente en una jam real
+2. Documenta qué funcionó y qué no
+3. Abre un issue con tus observaciones
+4. Propón mejoras específicas
+
+## Licencia
+
+Este agente es parte del proyecto genzai-agents - MIT License
+
+---
+
+**Recuerda**: La única forma de fallar una game jam es no terminar. Este agente existe para asegurar que cruces la línea de meta con un juego jugable. Done is better than perfect. Siempre.
+
+🎮 **¡Buena suerte en tu próxima jam!**