oden-forge 2.0.0

package/.claude/CLAUDE.md

@@ -0,0 +1,75 @@
+# Oden Forge
+
+Sistema de skills para crear proyectos profesionales usando la metodología Documentation-First Development.
+
+## Filosofía Core
+
+> "Documenta y diseña COMPLETAMENTE antes de codificar"
+
+## Comandos Disponibles
+
+### Setup
+- `/oden:init` - Wizard interactivo para crear proyecto
+- `/oden:init-agents` - Instalar agentes de desarrollo
+- `/oden:init-mcp` - Instalar MCPs recomendados
+- `/oden:mcp [sub]` - Gestionar MCPs (install, status, update, recommend)
+- `/oden:help` - Mostrar ayuda
+
+### Pre-Desarrollo (ejecutar en orden)
+1. `/oden:architect` - Technical decisions + DB schema
+2. `/oden:spec [módulo]` - Especificación de módulo
+3. `/oden:checklist` - Verificar todo listo
+
+### Feature Pipeline
+1. `/oden:prd [nombre]` - Crear PRD con brainstorming inteligente
+2. `/oden:epic [nombre]` - PRD -> Epic tecnico con work streams
+3. `/oden:tasks [nombre]` - Descomponer Epic en issues
+4. `/oden:sync [nombre]` - Sincronizar con GitHub Issues
+5. `/oden:sync status` - Ver estado de sincronizacion
+
+### Durante Desarrollo
+- `/oden:work [epic/issue]` - Orquestador inteligente con Teams (auto/config/smart)
+- `/oden:test [sub]` - Testing
+- `/oden:debug [sub]` - Debugging
+- `/oden:git [sub]` - Git workflow
+- `/oden:research [topic]` - Investigación técnica
+- `/oden:daily` - Registrar progreso del día
+- `/oden:review [scope]` - Code review antes de merge
+
+## Reglas de Oro
+
+### ✅ SIEMPRE
+1. Documenta TODO antes de codificar
+2. Analiza 3+ competidores
+3. Crea specs de 800+ líneas por módulo
+4. Registra progreso diario
+
+### ❌ NUNCA
+1. No empieces a codificar sin specs completas
+2. No documentes cambios triviales
+3. No dupliques información
+
+## Estructura de Documentación
+
+```
+docs/
+├── README.md
+├── guides/
+├── reference/
+│   ├── technical-decisions.md
+│   ├── competitive-analysis.md
+│   ├── implementation-plan.md
+│   └── modules/
+├── development/
+│   ├── current/
+│   └── completed/
+├── archived/
+└── temp/
+```
+
+## Métricas de Éxito
+
+- technical-decisions.md: 2000+ líneas
+- competitive-analysis.md: 1000+ líneas
+- Specs de módulos: 800+ líneas c/u
+- Total pre-código: 8000+ líneas

package/.claude/commands/oden/architect.md

@@ -0,0 +1,204 @@
+---
+allowed-tools: Bash, Read, Write, LS, Glob, Grep, Task, TodoWrite, WebSearch, WebFetch
+description: Crear/completar technical-decisions.md con arquitectura completa
+---
+
+# Oden Forge - Technical Architect
+
+Actúa como **Technical Architect** para crear/completar el documento `docs/reference/technical-decisions.md`.
+
+## Usage
+
+```
+/oden:architect
+```
+
+## Prerrequisitos
+
+1. Proyecto inicializado con `/oden:init`
+2. Archivo `docs/reference/technical-decisions.md` existe (template)
+
+## Responsabilidades
+
+Como Technical Architect, debes:
+
+1. **Completar technical-decisions.md** (2000-4000 líneas)
+2. **Diseñar schema de base de datos** completo
+3. **Definir interfaces TypeScript** para todos los modelos
+4. **Documentar patrones de arquitectura**
+5. **Identificar dependencias y riesgos**
+
+## Proceso
+
+### Paso 1: Análisis de Contexto
+
+Lee el template existente de technical-decisions.md para entender:
+- Stack tecnológico seleccionado
+- Features requeridas
+- Scope (MVP vs Turbo)
+
+### Paso 2: Diseño de Arquitectura
+
+Basado en el stack, diseña:
+
+1. **Arquitectura de Alto Nivel**
+   - Diagrama de componentes
+   - Flujo de datos
+   - Capas de la aplicación
+
+2. **Estructura de Carpetas**
+   ```
+   src/
+   ├── components/     # UI Components
+   ├── hooks/          # Custom hooks
+   ├── lib/            # Utilities
+   ├── services/       # API calls
+   ├── store/          # State management
+   ├── types/          # TypeScript types
+   └── utils/          # Helper functions
+   ```
+
+### Paso 3: Schema de Base de Datos
+
+Para cada entidad del sistema:
+
+```markdown
+## Tabla: {nombre}
+
+### Propósito
+{descripción}
+
+### Columnas
+| Columna | Tipo | Nullable | Default | Descripción |
+|---------|------|----------|---------|-------------|
+| id | UUID | No | gen_random_uuid() | PK |
+| ... | ... | ... | ... | ... |
+| created_at | TIMESTAMPTZ | No | now() | |
+| updated_at | TIMESTAMPTZ | No | now() | |
+
+### Índices
+- PRIMARY KEY (id)
+- INDEX idx_{tabla}_{columna} ON {tabla}({columna})
+
+### Foreign Keys
+- FK: {columna} → {otra_tabla}.id
+
+### Triggers
+- updated_at: Auto-update on modification
+```
+
+### Paso 4: Interfaces TypeScript
+
+```typescript
+// Types para cada entidad
+interface User {
+  id: string;
+  email: string;
+  name: string;
+  role: UserRole;
+  created_at: Date;
+  updated_at: Date;
+}
+
+enum UserRole {
+  ADMIN = 'admin',
+  USER = 'user',
+}
+
+// Types para API responses
+interface ApiResponse<T> {
+  data: T;
+  error?: ApiError;
+}
+
+interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, string>;
+}
+```
+
+### Paso 5: Patrones de Arquitectura
+
+Documenta patrones para:
+
+1. **State Management**
+   - Cuándo usar global vs local state
+   - Estructura del store
+   - Selectors y actions
+
+2. **Data Fetching**
+   - Estrategia de caching
+   - Optimistic updates
+   - Error handling
+
+3. **Error Handling**
+   - Error boundaries
+   - Toast notifications
+   - Logging strategy
+
+4. **Performance**
+   - Lazy loading
+   - Code splitting
+   - Memoization
+
+### Paso 6: Seguridad
+
+Documenta:
+- Autenticación flow
+- Autorización (RBAC)
+- Input sanitization
+- CORS policy
+- Rate limiting
+
+### Paso 7: APIs
+
+Define endpoints principales:
+
+```markdown
+## API Endpoints
+
+### Authentication
+| Method | Endpoint | Description | Auth |
+|--------|----------|-------------|------|
+| POST | /api/auth/register | Register user | No |
+| POST | /api/auth/login | Login | No |
+| POST | /api/auth/logout | Logout | Yes |
+| POST | /api/auth/refresh | Refresh token | Yes |
+
+### Resources
+| Method | Endpoint | Description | Auth | Roles |
+|--------|----------|-------------|------|-------|
+| GET | /api/{resource} | List all | Yes | All |
+| GET | /api/{resource}/:id | Get one | Yes | All |
+| POST | /api/{resource} | Create | Yes | Admin |
+| PUT | /api/{resource}/:id | Update | Yes | Admin |
+| DELETE | /api/{resource}/:id | Delete | Yes | Admin |
+```
+
+## Output
+
+Al completar, el archivo `docs/reference/technical-decisions.md` debe tener:
+
+- [ ] 2000+ líneas de contenido
+- [ ] Schema de BD completo para todas las entidades
+- [ ] Interfaces TypeScript para todos los modelos
+- [ ] Diagrama de arquitectura (ASCII o mermaid)
+- [ ] Patrones documentados
+- [ ] APIs definidas
+- [ ] Consideraciones de seguridad
+- [ ] Performance targets
+
+## Siguientes Pasos
+
+Después de completar arquitectura:
+
+```
+1. /oden:analyze  → Análisis competitivo
+2. /oden:spec     → Especificaciones por módulo
+3. /oden:plan     → Plan de implementación
+```
+
+## Referencia
+
+Ver agente completo en: `.claude/agents/technical-architect.md`

package/.claude/commands/oden/checklist.md

@@ -0,0 +1,199 @@
+---
+allowed-tools: Read, LS, Glob, Grep
+description: Verificar que todo esté listo antes de codificar
+---
+
+# Oden Forge - Pre-Code Checklist
+
+Verifica que toda la documentación esté completa antes de escribir código.
+
+## Usage
+
+```
+/oden:checklist
+```
+
+## Propósito
+
+> "Solo cuando TODO esté ✅, empezar a codificar."
+
+Este comando verifica que se ha completado toda la fase de documentación según la metodología Oden.
+
+## Verificaciones
+
+### 1. Technical Decisions (2000+ líneas)
+
+```bash
+# Verificar existencia
+test -f docs/reference/technical-decisions.md
+
+# Contar líneas
+wc -l docs/reference/technical-decisions.md
+# Target: >= 2000 líneas
+```
+
+Verificar contenido:
+- [ ] Stack tecnológico documentado
+- [ ] Schema de BD completo
+- [ ] Interfaces TypeScript definidas
+- [ ] Patrones de arquitectura
+- [ ] APIs diseñadas
+- [ ] Seguridad considerada
+
+### 2. Competitive Analysis (1000+ líneas)
+
+```bash
+test -f docs/reference/competitive-analysis.md
+wc -l docs/reference/competitive-analysis.md
+# Target: >= 1000 líneas
+```
+
+Verificar contenido:
+- [ ] 3+ competidores analizados
+- [ ] Matriz de features
+- [ ] Diferenciadores identificados
+
+### 3. User Stories
+
+```bash
+test -f docs/reference/user-stories.md
+```
+
+Verificar contenido:
+- [ ] 2+ user personas
+- [ ] User stories principales
+- [ ] Criterios de aceptación
+
+### 4. Module Specifications (800+ líneas c/u)
+
+```bash
+# Listar specs
+ls docs/reference/modules/
+
+# Verificar líneas de cada uno
+for f in docs/reference/modules/*.md; do
+  echo "$f: $(wc -l < $f) líneas"
+done
+# Target: >= 800 líneas cada uno
+```
+
+Módulos requeridos según technical-decisions.md
+
+### 5. Implementation Plan
+
+```bash
+test -f docs/reference/implementation-plan.md
+wc -l docs/reference/implementation-plan.md
+```
+
+Verificar contenido:
+- [ ] Timeline semana por semana
+- [ ] Tareas con estimaciones
+- [ ] Dependencias mapeadas
+- [ ] Milestones definidos
+- [ ] Riesgos identificados
+
+### 6. Estructura de Documentación
+
+```bash
+# Verificar estructura
+ls -la docs/
+ls -la docs/guides/
+ls -la docs/reference/
+ls -la docs/reference/modules/
+ls -la docs/development/current/
+ls -la docs/development/completed/
+```
+
+## Output
+
+### Si TODO está listo ✅
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                  ✅ CHECKLIST COMPLETADO                     ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  📄 Technical Decisions     ✅  2,450 líneas                 ║
+║  📊 Competitive Analysis    ✅  1,230 líneas                 ║
+║  👥 User Stories            ✅  890 líneas                   ║
+║  📋 Module Specs            ✅  3 módulos (avg 950 líneas)   ║
+║  📅 Implementation Plan     ✅  680 líneas                   ║
+║  📁 Doc Structure           ✅  Completa                     ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  🎉 ¡Estás listo para codificar!                            ║
+║                                                              ║
+║  Siguiente paso:                                             ║
+║  1. Crea tu primer feature branch                            ║
+║  2. Empieza con las tareas de Semana 1                       ║
+║  3. Usa /oden:daily al final de cada día                     ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+### Si FALTA algo ❌
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                  ❌ CHECKLIST INCOMPLETO                     ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  📄 Technical Decisions     ⚠️  1,200 líneas (need 2000+)    ║
+║  📊 Competitive Analysis    ✅  1,230 líneas                 ║
+║  👥 User Stories            ❌  No encontrado                ║
+║  📋 Module Specs            ⚠️  2/3 módulos completos        ║
+║  📅 Implementation Plan     ✅  680 líneas                   ║
+║  📁 Doc Structure           ✅  Completa                     ║
+║                                                              ║
+╠══════════════════════════════════════════════════════════════╣
+║                                                              ║
+║  🚫 NO empezar a codificar todavía                          ║
+║                                                              ║
+║  Acciones requeridas:                                        ║
+║                                                              ║
+║  1. /oden:architect                                          ║
+║     → Completar technical-decisions.md (+800 líneas)         ║
+║                                                              ║
+║  2. /oden:analyze                                            ║
+║     → Crear user-stories.md                                  ║
+║                                                              ║
+║  3. /oden:spec payments                                      ║
+║     → Falta spec del módulo payments                         ║
+║                                                              ║
+║  Luego vuelve a ejecutar /oden:checklist                    ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+## Criterios de Aprobación
+
+| Documento | Mínimo | Ideal |
+|-----------|--------|-------|
+| technical-decisions.md | 2000 líneas | 3000+ |
+| competitive-analysis.md | 1000 líneas | 1500+ |
+| user-stories.md | Existe | 500+ líneas |
+| {module}-spec.md | 800 líneas c/u | 1000+ c/u |
+| implementation-plan.md | Existe | 500+ líneas |
+
+## Excepciones
+
+Para proyectos pequeños (MVP rápido), se puede aprobar con:
+- technical-decisions.md: 1000+ líneas
+- competitive-analysis.md: 500+ líneas
+- Al menos 1 spec de módulo: 500+ líneas
+
+Pero documentar la decisión de reducir documentación.
+
+## Filosofía
+
+> "Documentación > 8,000 líneas antes de primera línea de código"
+
+Este checklist existe porque:
+1. Documentar primero evita retrabajo
+2. Specs claras = desarrollo más rápido
+3. Decisiones informadas = menos bugs
+4. El desarrollador sabe EXACTAMENTE qué construir
+
+No es burocracia, es eficiencia.

package/.claude/commands/oden/daily.md

@@ -0,0 +1,223 @@
+---
+allowed-tools: Bash, Read, Write, LS, Glob, Grep, TodoWrite
+description: Registrar progreso diario (DAY_X_COMPLETED.md)
+---
+
+# Oden Forge - Daily Logger
+
+Actúa como **Daily Logger** para documentar el progreso del día.
+
+## Usage
+
+```
+/oden:daily
+```
+
+## Cuándo Usar
+
+Ejecutar al final de cada día de desarrollo para:
+- Documentar lo completado
+- Registrar métricas
+- Identificar bloqueantes
+- Planificar mañana
+
+## Proceso
+
+### Paso 1: Identificar Feature Actual
+
+Detectar en qué feature se está trabajando:
+```bash
+# Ver si hay carpeta de desarrollo activa
+ls docs/development/current/
+```
+
+### Paso 2: Determinar Número de Día
+
+```bash
+# Contar DAY_X existentes
+ls docs/development/current/{feature}/DAY_*.md 2>/dev/null | wc -l
+```
+
+El nuevo archivo será `DAY_{N+1}_COMPLETED.md`
+
+### Paso 3: Recopilar Información
+
+Preguntar o detectar:
+
+1. **Tareas completadas**
+   - ¿Qué terminaste hoy?
+   - ¿Qué commits hiciste?
+
+2. **Archivos modificados**
+   ```bash
+   git diff --stat HEAD~{commits_hoy}
+   ```
+
+3. **Métricas**
+   ```bash
+   # Líneas agregadas/eliminadas
+   git diff --shortstat HEAD~{commits_hoy}
+   ```
+
+4. **Aprendizajes**
+   - ¿Decisiones importantes?
+   - ¿Problemas resueltos?
+   - ¿Tips para el futuro?
+
+5. **Issues**
+   - ¿Bugs encontrados?
+   - ¿Bloqueantes activos?
+
+6. **Próximos pasos**
+   - ¿Qué harás mañana?
+   - ¿Qué depende de otros?
+
+### Paso 4: Crear DAY_X_COMPLETED.md
+
+```markdown
+# Day {X} - {YYYY-MM-DD}
+
+**Feature:** {nombre}
+**Autor:** {nombre}
+
+---
+
+## ✅ Completado
+
+### Tareas Finalizadas
+- [x] {Tarea 1}
+- [x] {Tarea 2}
+- [x] {Tarea 3}
+
+### Archivos Creados/Modificados
+```
+{output de git diff --stat}
+```
+
+### Commits del Día
+```
+{output de git log --oneline --since="00:00"}
+```
+
+---
+
+## 📊 Métricas
+
+| Métrica | Valor |
+|---------|-------|
+| Líneas agregadas | +{X} |
+| Líneas eliminadas | -{Y} |
+| Archivos nuevos | {N} |
+| Archivos modificados | {M} |
+| Tests nuevos | {T} |
+| Tiempo de trabajo | {H}h |
+
+---
+
+## 💡 Aprendizajes
+
+### Decisiones Tomadas
+{Si hubo decisiones importantes}
+
+### Tips Descubiertos
+{Patrones útiles, shortcuts, etc.}
+
+---
+
+## 🐛 Issues
+
+### Resueltos
+| Issue | Solución |
+|-------|----------|
+| {desc} | {cómo se resolvió} |
+
+### Pendientes
+| Issue | Severidad | Workaround |
+|-------|-----------|------------|
+| {desc} | {alta/media/baja} | {si existe} |
+
+---
+
+## 🚧 Bloqueantes
+
+{Si hay bloqueantes activos}
+
+---
+
+## ⏭️ Próximos Pasos
+
+### Mañana
+1. [ ] {Tarea 1}
+2. [ ] {Tarea 2}
+3. [ ] {Tarea 3}
+
+### Dependencias
+- {Esperando X de Y}
+
+---
+
+**Actualizado:** {timestamp}
+```
+
+### Paso 5: Actualizar Índices
+
+1. Actualizar `docs/development/current/{feature}/README.md`:
+   ```markdown
+   ## Daily Logs
+   - [Day 1](./DAY_1_COMPLETED.md) - {resumen}
+   - [Day 2](./DAY_2_COMPLETED.md) - {resumen}
+   ...
+   ```
+
+2. Actualizar implementation-plan.md si hay cambios de timeline
+
+## Automatización
+
+### Script de Ayuda
+
+El comando puede usar este script para recopilar métricas:
+
+```bash
+#!/bin/bash
+# .claude/scripts/oden/daily-metrics.sh
+
+echo "=== MÉTRICAS DEL DÍA ==="
+echo ""
+
+# Commits de hoy
+echo "📝 Commits:"
+git log --oneline --since="00:00" 2>/dev/null || echo "No commits hoy"
+echo ""
+
+# Archivos modificados
+echo "📁 Archivos modificados:"
+git diff --stat HEAD~$(git log --oneline --since="00:00" | wc -l) 2>/dev/null || echo "Sin cambios"
+echo ""
+
+# Líneas de código
+echo "📊 Líneas:"
+git diff --shortstat HEAD~$(git log --oneline --since="00:00" | wc -l) 2>/dev/null || echo "Sin cambios"
+```
+
+## Checklist
+
+Antes de terminar el día:
+
+- [ ] DAY_X_COMPLETED.md creado
+- [ ] Todas las tareas listadas
+- [ ] Métricas registradas
+- [ ] Issues documentados
+- [ ] Próximos pasos definidos
+- [ ] Archivo commiteado
+
+## Tips
+
+1. **Hazlo diario** - No acumules varios días
+2. **Sé específico** - "Implementé login" > "Trabajé en auth"
+3. **Incluye contexto** - Por qué se tomaron decisiones
+4. **Registra problemas** - Ayuda al futuro tú
+5. **Planifica mañana** - Termina el día con claridad
+
+## Referencia
+
+Ver agente completo en: `.claude/agents/daily-logger.md`