oden-forge 2.0.2 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -222,3 +222,55 @@ Next: /oden:tasks $ARGUMENTS
222
222
  - Keep task count to 10 or fewer
223
223
  - Focus on practical implementation, not theory
224
224
  - Reference existing code patterns when available
225
+
226
+
227
+ ---
228
+
229
+ ## TASKS MODE: /oden:epic tasks [nombre]
230
+
231
+ Descompone Epic en tasks/issues individuales listos para implementación.
232
+
233
+ ### Features:
234
+ - **Análisis inteligente** del Epic existente
235
+ - **Descomposición automática** en tasks parallelizables
236
+ - **Dependencias detectadas** automáticamente
237
+ - **Estimaciones** de complejidad
238
+ - **Work streams** optimizados para Teams
239
+
240
+ ### Usage:
241
+ ```bash
242
+ /oden:epic tasks auth # Tasks para Epic de auth
243
+ /oden:epic tasks orders # Tasks para Epic de orders
244
+ ```
245
+
246
+ ### Output:
247
+ - `.claude/epics/[nombre]/tasks/` directory
248
+ - Task files individuales con criterios de aceptación
249
+ - Dependency mapping para Teams
250
+ - Ready para `/oden:sync`
251
+
252
+ ### Example Output:
253
+ ```
254
+ 📋 TASKS GENERATED FOR: auth
255
+
256
+ ✅ 8 tasks created:
257
+ ├── 001-database-schema.md (Backend, 2 days)
258
+ ├── 002-auth-models.md (Backend, 1 day)
259
+ ├── 003-login-api.md (Backend, 2 days)
260
+ ├── 004-registration-api.md (Backend, 2 days)
261
+ ├── 005-jwt-middleware.md (Backend, 1 day)
262
+ ├── 006-login-ui.md (Frontend, 2 days)
263
+ ├── 007-registration-ui.md (Frontend, 2 days)
264
+ └── 008-integration-tests.md (QA, 1 day)
265
+
266
+ 📊 WORK STREAMS:
267
+ Stream A (Backend): Tasks 1-5 (8 days)
268
+ Stream B (Frontend): Tasks 6-7 (4 days)
269
+ Stream C (QA): Task 8 (1 day)
270
+
271
+ 🔄 DEPENDENCIES:
272
+ Tasks 6-7 depend on tasks 1-5
273
+ Task 8 depends on all tasks
274
+
275
+ NEXT: /oden:sync auth # Push to GitHub Issues
276
+ ```
@@ -11,6 +11,8 @@ Wizard interactivo que guía al usuario a crear un proyecto profesional siguiend
11
11
 
12
12
  ```
13
13
  /oden:init [nombre-proyecto]
14
+ /oden:init agents [category] # Instalar agentes especializados
15
+ /oden:init mcp [category] # Instalar MCPs recomendados
14
16
  ```
15
17
 
16
18
  ## Filosofía Core
@@ -493,3 +495,52 @@ Solo mostrar la recomendación y justificación breve, sin explicaciones básica
493
495
 
494
496
  ### Si el usuario rechaza la recomendación:
495
497
  Preguntar qué stack prefiere y por qué, luego adaptar el flujo.
498
+
499
+ ---
500
+
501
+ ## AGENTS MODE: /oden:init agents [category]
502
+
503
+ Instala agentes especializados para desarrollo.
504
+
505
+ ### Categories Disponibles:
506
+ - `core` - Agentes esenciales (fullstack-developer, code-reviewer, debugger)
507
+ - `frontend` - Frontend/UI (frontend-developer, ui-ux-designer)
508
+ - `backend` - Backend/APIs (backend-architect, database-architect)
509
+ - `mobile` - Mobile (mobile-developer, ios-developer)
510
+ - `devops` - DevOps (devops-engineer, deployment-engineer)
511
+ - `data` - Data (data-scientist, data-engineer)
512
+ - (vacío) - Mostrar todas las categorías
513
+
514
+ ### Usage:
515
+ ```bash
516
+ /oden:init agents core # Solo esenciales
517
+ /oden:init agents # Ver todas las opciones
518
+ ```
519
+
520
+ ---
521
+
522
+ ## MCP MODE: /oden:init mcp [category]
523
+
524
+ Instala MCPs (Model Context Protocol servers) recomendados.
525
+
526
+ ### Categories Disponibles:
527
+ - `essential` - MCPs básicos (memory, context7)
528
+ - `design` - Diseño (pencil, figma)
529
+ - `backend` - Backend (supabase, postgres)
530
+ - `testing` - Testing (chrome-devtools, playwright)
531
+ - `mobile` - Mobile (ios-simulator)
532
+ - `productivity` - Productivity (notion, linear)
533
+ - (vacío) - Mostrar todas las categorías
534
+
535
+ ### Usage:
536
+ ```bash
537
+ /oden:init mcp essential # MCPs básicos
538
+ /oden:init mcp # Ver todas las opciones
539
+ ```
540
+
541
+ ### Auto-Detection:
542
+ Basado en tu stack, se recomiendan automáticamente:
543
+ - **React/Next.js** → chrome-devtools, memory
544
+ - **Mobile** → ios-simulator, chrome-devtools
545
+ - **Supabase** → supabase MCP
546
+ - **Notion** → notion MCP
@@ -789,3 +789,157 @@ Resuelve manualmente y luego ejecuta: /oden:work epic/payments --resume
789
789
  - Follow `/rules/datetime.md` for timestamps
790
790
  - Maximum parallel agents: 5 (to avoid resource exhaustion)
791
791
  - Always verify remote origin before GitHub write operations
792
+
793
+
794
+ ---
795
+
796
+ ## 🔥 CONSOLIDATED MODES - Todo en Uno
797
+
798
+ ### DEBUG MODE: /oden:work debug [error/issue]
799
+ Debugging especializado integrado en el workflow.
800
+
801
+ **Funcionalidad completa de /oden:debug:**
802
+ - Análisis automático de stack traces
803
+ - Detección de patterns en logs
804
+ - Sugerencias de fixes específicas
805
+ - Integration con Teams para debugging paralelo
806
+
807
+ **Usage:**
808
+ ```bash
809
+ /oden:work debug "TypeError: Cannot read property"
810
+ /oden:work debug logs error.log
811
+ /oden:work debug performance api/slow-endpoint
812
+ ```
813
+
814
+ ---
815
+
816
+ ### TEST MODE: /oden:work test [target]
817
+ Testing completo integrado en el desarrollo.
818
+
819
+ **Funcionalidad completa de /oden:test:**
820
+ - Estrategia de testing automática
821
+ - Ejecución con análisis de fallos
822
+ - Coverage reports con insights
823
+ - Test generation desde specs
824
+
825
+ **Usage:**
826
+ ```bash
827
+ /oden:work test strategy # Crear estrategia
828
+ /oden:work test run # Ejecutar todos
829
+ /oden:work test coverage # Analizar cobertura
830
+ /oden:work test generate auth # Tests desde specs
831
+ ```
832
+
833
+ ---
834
+
835
+ ### REVIEW MODE: /oden:work review [scope]
836
+ Code review antes de PRs y merges.
837
+
838
+ **Funcionalidad completa de /oden:review:**
839
+ - Review automático con checklist
840
+ - Security scan integrado
841
+ - Performance analysis
842
+ - Best practices validation
843
+
844
+ **Usage:**
845
+ ```bash
846
+ /oden:work review # Review completo
847
+ /oden:work review security # Focus en seguridad
848
+ /oden:work review performance # Focus en performance
849
+ ```
850
+
851
+ ---
852
+
853
+ ### RESEARCH MODE: /oden:work research [topic]
854
+ Investigación técnica durante desarrollo.
855
+
856
+ **Funcionalidad completa de /oden:research:**
857
+ - Búsqueda de soluciones técnicas
858
+ - Comparación de librerías/approaches
859
+ - Best practices research
860
+ - Documentation lookup
861
+
862
+ **Usage:**
863
+ ```bash
864
+ /oden:work research "rate limiting approaches"
865
+ /oden:work research library axios vs fetch
866
+ /oden:work research best-practice "error handling React"
867
+ ```
868
+
869
+ ---
870
+
871
+ ### GIT MODE: /oden:work git [operation]
872
+ Git workflow integrado en el desarrollo.
873
+
874
+ **Funcionalidad completa de /oden:git:**
875
+ - Branch management automático
876
+ - Smart commits con context
877
+ - PR creation con análisis
878
+ - Merge strategy optimization
879
+
880
+ **Usage:**
881
+ ```bash
882
+ /oden:work git start feature-auth # Nueva feature branch
883
+ /oden:work git commit "Add auth" # Smart commit
884
+ /oden:work git pr # Create PR con análisis
885
+ /oden:work git sync # Sync con main
886
+ ```
887
+
888
+ ---
889
+
890
+ ### DAILY MODE: /oden:work daily
891
+ Registro de progreso diario automático.
892
+
893
+ **Funcionalidad completa de /oden:daily:**
894
+ - Auto-tracking de archivos modificados
895
+ - Progress analysis con metrics
896
+ - Blockers detection
897
+ - Daily summary generation
898
+
899
+ **Usage:**
900
+ ```bash
901
+ /oden:work daily # Registro completo del día
902
+ ```
903
+
904
+ **Output Example:**
905
+ ```
906
+ 📅 DAY_3_COMPLETED.md
907
+
908
+ ## Progreso del Día
909
+ - ✅ API authentication endpoints (3h)
910
+ - ✅ JWT middleware integration (2h)
911
+ - 🔄 Frontend login form (in progress)
912
+
913
+ ## Archivos Modificados
914
+ - src/api/auth.ts (new)
915
+ - src/middleware/jwt.ts (updated)
916
+ - src/types/user.ts (updated)
917
+
918
+ ## Blockers
919
+ - None
920
+
921
+ ## Siguiente Día
922
+ - Completar frontend login
923
+ - Add registration flow
924
+ ```
925
+
926
+ ---
927
+
928
+ ## 🎯 Smart Mode Selection
929
+
930
+ El comando `/oden:work` selecciona automáticamente el mejor approach:
931
+
932
+ - **1-2 archivos** → Single agent
933
+ - **3-5 archivos** → Parallel agents
934
+ - **6+ archivos** → Full Teams orchestration
935
+ - **Error detection** → Auto-trigger debug mode
936
+ - **Test failures** → Auto-trigger test mode
937
+ - **PR ready** → Auto-trigger review mode
938
+
939
+ **Example:**
940
+ ```bash
941
+ /oden:work auth-epic
942
+ # → Detecta 8 archivos → Teams mode
943
+ # → 2 test failures → Auto-trigger test mode
944
+ # → Security concerns → Auto-trigger review mode
945
+ ```
package/README.md CHANGED
@@ -77,48 +77,18 @@ source ~/.zshrc
77
77
  oden-forge status # Ahora debería funcionar
78
78
  ```
79
79
 
80
- ## Comandos Disponibles
81
-
82
- ### Inicialización y Setup
83
- | Comando | Descripción |
84
- |---------|-------------|
85
- | `/oden:init` | Wizard interactivo para crear un proyecto desde cero |
86
- | `/oden:init-agents [cat]` | Instalar agentes de desarrollo (core, frontend, backend, mobile, devops, data) |
87
- | `/oden:init-mcp [cat]` | Instalar MCPs recomendados (essential, design, backend, testing, mobile, devops) |
88
- | `/oden:help` | Mostrar ayuda y guías |
89
-
90
- ### Fase Pre-Desarrollo
91
- | Comando | Descripción |
92
- |---------|-------------|
93
- | `/oden:architect` | Crear technical-decisions.md (arquitectura, DB schema, stack) |
94
- | `/oden:analyze` | Análisis competitivo y requisitos de negocio |
95
- | `/oden:spec [módulo]` | Crear especificaciones detalladas por módulo (800+ líneas) |
96
- | `/oden:plan` | Plan de implementación semana por semana |
97
- | `/oden:checklist` | Verificar que todo esté listo antes de codificar |
98
-
99
- ### Fase Desarrollo
100
- | Comando | Descripción |
101
- |---------|-------------|
102
- | `/oden:daily` | Registrar progreso diario (DAY_X_COMPLETED.md) |
103
- | `/oden:dev [agent]` | Invocar agentes de desarrollo (ver abajo) |
104
- | `/oden:review` | Code review automático antes de PR |
105
- | `/oden:test [sub]` | Testing - estrategia, ejecución, análisis |
106
- | `/oden:debug [sub]` | Debugging - analizar errores y soluciones |
107
- | `/oden:research [topic]` | Investigación técnica |
108
- | `/oden:git [sub]` | Git workflow - branches, PRs, gestión |
109
-
110
- ### Sincronización con GitHub (integración CCPM)
111
- | Comando | Descripción |
112
- |---------|-------------|
113
- | `/oden:sync setup` | Configurar proyecto para sync con GitHub |
114
- | `/oden:sync prd [nombre]` | Crear PRD (Product Requirement Document) |
115
- | `/oden:sync epic [nombre]` | Convertir PRD a Epic técnico |
116
- | `/oden:sync tasks [nombre]` | Descomponer Epic en tasks |
117
- | `/oden:sync github [nombre]` | Push Epic y tasks a GitHub como issues |
118
- | `/oden:sync start [nombre]` | Iniciar desarrollo en epic (worktree) |
119
- | `/oden:sync issue [#]` | Trabajar en un issue específico |
120
- | `/oden:sync close [#]` | Cerrar issue completado |
121
- | `/oden:sync status` | Ver estado de sincronización |
80
+ ## 🚀 Comandos Esenciales (Solo 8)
81
+
82
+ | Comando | Descripción | Funcionalidad |
83
+ |---------|-------------|---------------|
84
+ | `/oden:init` | **Wizard completo** | Setup + agentes + MCPs + configuración |
85
+ | `/oden:architect` | **Decisiones técnicas** | Architecture + specs + DB schema + checklist |
86
+ | `/oden:prd` | **PRD inteligente** | Product requirements con brainstorming |
87
+ | `/oden:epic` | **Epic + Tasks** | Work streams + descomposición automática |
88
+ | `/oden:work` | **🔥 Orquestador** | Desarrollo con Teams + debug + test + research |
89
+ | `/oden:sync` | **GitHub nativo** | Issues + branches + PRs (sin CCPM) |
90
+ | `/oden:mcp` | **Gestión MCPs** | Install + recommend + manage |
91
+ | `/oden:help` | **Ayuda completa** | Guías + docs + troubleshooting |
122
92
 
123
93
  ---
124
94
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oden-forge",
3
- "version": "2.0.2",
3
+ "version": "2.2.0",
4
4
  "description": "Documentation-First Development Toolkit for Claude Code - Create professional projects with built-in methodology, Teams orchestration, and MCP management",
5
5
  "keywords": [
6
6
  "claude-code",
@@ -1,199 +0,0 @@
1
- ---
2
- allowed-tools: Read, LS, Glob, Grep
3
- description: Verificar que todo esté listo antes de codificar
4
- ---
5
-
6
- # Oden Forge - Pre-Code Checklist
7
-
8
- Verifica que toda la documentación esté completa antes de escribir código.
9
-
10
- ## Usage
11
-
12
- ```
13
- /oden:checklist
14
- ```
15
-
16
- ## Propósito
17
-
18
- > "Solo cuando TODO esté ✅, empezar a codificar."
19
-
20
- Este comando verifica que se ha completado toda la fase de documentación según la metodología Oden.
21
-
22
- ## Verificaciones
23
-
24
- ### 1. Technical Decisions (2000+ líneas)
25
-
26
- ```bash
27
- # Verificar existencia
28
- test -f docs/reference/technical-decisions.md
29
-
30
- # Contar líneas
31
- wc -l docs/reference/technical-decisions.md
32
- # Target: >= 2000 líneas
33
- ```
34
-
35
- Verificar contenido:
36
- - [ ] Stack tecnológico documentado
37
- - [ ] Schema de BD completo
38
- - [ ] Interfaces TypeScript definidas
39
- - [ ] Patrones de arquitectura
40
- - [ ] APIs diseñadas
41
- - [ ] Seguridad considerada
42
-
43
- ### 2. Competitive Analysis (1000+ líneas)
44
-
45
- ```bash
46
- test -f docs/reference/competitive-analysis.md
47
- wc -l docs/reference/competitive-analysis.md
48
- # Target: >= 1000 líneas
49
- ```
50
-
51
- Verificar contenido:
52
- - [ ] 3+ competidores analizados
53
- - [ ] Matriz de features
54
- - [ ] Diferenciadores identificados
55
-
56
- ### 3. User Stories
57
-
58
- ```bash
59
- test -f docs/reference/user-stories.md
60
- ```
61
-
62
- Verificar contenido:
63
- - [ ] 2+ user personas
64
- - [ ] User stories principales
65
- - [ ] Criterios de aceptación
66
-
67
- ### 4. Module Specifications (800+ líneas c/u)
68
-
69
- ```bash
70
- # Listar specs
71
- ls docs/reference/modules/
72
-
73
- # Verificar líneas de cada uno
74
- for f in docs/reference/modules/*.md; do
75
- echo "$f: $(wc -l < $f) líneas"
76
- done
77
- # Target: >= 800 líneas cada uno
78
- ```
79
-
80
- Módulos requeridos según technical-decisions.md
81
-
82
- ### 5. Implementation Plan
83
-
84
- ```bash
85
- test -f docs/reference/implementation-plan.md
86
- wc -l docs/reference/implementation-plan.md
87
- ```
88
-
89
- Verificar contenido:
90
- - [ ] Timeline semana por semana
91
- - [ ] Tareas con estimaciones
92
- - [ ] Dependencias mapeadas
93
- - [ ] Milestones definidos
94
- - [ ] Riesgos identificados
95
-
96
- ### 6. Estructura de Documentación
97
-
98
- ```bash
99
- # Verificar estructura
100
- ls -la docs/
101
- ls -la docs/guides/
102
- ls -la docs/reference/
103
- ls -la docs/reference/modules/
104
- ls -la docs/development/current/
105
- ls -la docs/development/completed/
106
- ```
107
-
108
- ## Output
109
-
110
- ### Si TODO está listo ✅
111
-
112
- ```
113
- ╔══════════════════════════════════════════════════════════════╗
114
- ║ ✅ CHECKLIST COMPLETADO ║
115
- ╠══════════════════════════════════════════════════════════════╣
116
- ║ ║
117
- ║ 📄 Technical Decisions ✅ 2,450 líneas ║
118
- ║ 📊 Competitive Analysis ✅ 1,230 líneas ║
119
- ║ 👥 User Stories ✅ 890 líneas ║
120
- ║ 📋 Module Specs ✅ 3 módulos (avg 950 líneas) ║
121
- ║ 📅 Implementation Plan ✅ 680 líneas ║
122
- ║ 📁 Doc Structure ✅ Completa ║
123
- ║ ║
124
- ╠══════════════════════════════════════════════════════════════╣
125
- ║ ║
126
- ║ 🎉 ¡Estás listo para codificar! ║
127
- ║ ║
128
- ║ Siguiente paso: ║
129
- ║ 1. Crea tu primer feature branch ║
130
- ║ 2. Empieza con las tareas de Semana 1 ║
131
- ║ 3. Usa /oden:daily al final de cada día ║
132
- ║ ║
133
- ╚══════════════════════════════════════════════════════════════╝
134
- ```
135
-
136
- ### Si FALTA algo ❌
137
-
138
- ```
139
- ╔══════════════════════════════════════════════════════════════╗
140
- ║ ❌ CHECKLIST INCOMPLETO ║
141
- ╠══════════════════════════════════════════════════════════════╣
142
- ║ ║
143
- ║ 📄 Technical Decisions ⚠️ 1,200 líneas (need 2000+) ║
144
- ║ 📊 Competitive Analysis ✅ 1,230 líneas ║
145
- ║ 👥 User Stories ❌ No encontrado ║
146
- ║ 📋 Module Specs ⚠️ 2/3 módulos completos ║
147
- ║ 📅 Implementation Plan ✅ 680 líneas ║
148
- ║ 📁 Doc Structure ✅ Completa ║
149
- ║ ║
150
- ╠══════════════════════════════════════════════════════════════╣
151
- ║ ║
152
- ║ 🚫 NO empezar a codificar todavía ║
153
- ║ ║
154
- ║ Acciones requeridas: ║
155
- ║ ║
156
- ║ 1. /oden:architect ║
157
- ║ → Completar technical-decisions.md (+800 líneas) ║
158
- ║ ║
159
- ║ 2. /oden:analyze ║
160
- ║ → Crear user-stories.md ║
161
- ║ ║
162
- ║ 3. /oden:spec payments ║
163
- ║ → Falta spec del módulo payments ║
164
- ║ ║
165
- ║ Luego vuelve a ejecutar /oden:checklist ║
166
- ║ ║
167
- ╚══════════════════════════════════════════════════════════════╝
168
- ```
169
-
170
- ## Criterios de Aprobación
171
-
172
- | Documento | Mínimo | Ideal |
173
- |-----------|--------|-------|
174
- | technical-decisions.md | 2000 líneas | 3000+ |
175
- | competitive-analysis.md | 1000 líneas | 1500+ |
176
- | user-stories.md | Existe | 500+ líneas |
177
- | {module}-spec.md | 800 líneas c/u | 1000+ c/u |
178
- | implementation-plan.md | Existe | 500+ líneas |
179
-
180
- ## Excepciones
181
-
182
- Para proyectos pequeños (MVP rápido), se puede aprobar con:
183
- - technical-decisions.md: 1000+ líneas
184
- - competitive-analysis.md: 500+ líneas
185
- - Al menos 1 spec de módulo: 500+ líneas
186
-
187
- Pero documentar la decisión de reducir documentación.
188
-
189
- ## Filosofía
190
-
191
- > "Documentación > 8,000 líneas antes de primera línea de código"
192
-
193
- Este checklist existe porque:
194
- 1. Documentar primero evita retrabajo
195
- 2. Specs claras = desarrollo más rápido
196
- 3. Decisiones informadas = menos bugs
197
- 4. El desarrollador sabe EXACTAMENTE qué construir
198
-
199
- No es burocracia, es eficiencia.