elsabro 2.0.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.
Files changed (58) hide show
  1. package/README.md +268 -0
  2. package/agents/elsabro-analyst.md +176 -0
  3. package/agents/elsabro-debugger.md +293 -0
  4. package/agents/elsabro-executor.md +477 -0
  5. package/agents/elsabro-orchestrator.md +426 -0
  6. package/agents/elsabro-planner.md +278 -0
  7. package/agents/elsabro-qa.md +273 -0
  8. package/agents/elsabro-quick-dev.md +309 -0
  9. package/agents/elsabro-scrum-master.md +217 -0
  10. package/agents/elsabro-tech-writer.md +347 -0
  11. package/agents/elsabro-ux-designer.md +278 -0
  12. package/agents/elsabro-verifier.md +295 -0
  13. package/agents/elsabro-yolo-dev.md +322 -0
  14. package/bin/install.js +497 -0
  15. package/commands/elsabro/add-phase.md +114 -0
  16. package/commands/elsabro/add-todo.md +158 -0
  17. package/commands/elsabro/audit-milestone.md +147 -0
  18. package/commands/elsabro/check-todos.md +192 -0
  19. package/commands/elsabro/complete-milestone.md +138 -0
  20. package/commands/elsabro/debug.md +153 -0
  21. package/commands/elsabro/discuss-phase.md +160 -0
  22. package/commands/elsabro/execute.md +299 -0
  23. package/commands/elsabro/help.md +102 -0
  24. package/commands/elsabro/insert-phase.md +117 -0
  25. package/commands/elsabro/list-phase-assumptions.md +129 -0
  26. package/commands/elsabro/map-codebase.md +108 -0
  27. package/commands/elsabro/new-milestone.md +128 -0
  28. package/commands/elsabro/new.md +230 -0
  29. package/commands/elsabro/pause-work.md +261 -0
  30. package/commands/elsabro/plan-milestone-gaps.md +129 -0
  31. package/commands/elsabro/plan.md +272 -0
  32. package/commands/elsabro/progress.md +187 -0
  33. package/commands/elsabro/quick.md +99 -0
  34. package/commands/elsabro/remove-phase.md +136 -0
  35. package/commands/elsabro/research-phase.md +174 -0
  36. package/commands/elsabro/resume-work.md +288 -0
  37. package/commands/elsabro/set-profile.md +216 -0
  38. package/commands/elsabro/settings.md +185 -0
  39. package/commands/elsabro/start.md +204 -0
  40. package/commands/elsabro/update.md +71 -0
  41. package/commands/elsabro/verify-work.md +269 -0
  42. package/commands/elsabro/verify.md +207 -0
  43. package/hooks/dist/.gitkeep +2 -0
  44. package/package.json +45 -0
  45. package/references/error-handling-instructions.md +312 -0
  46. package/references/source-hierarchy.md +150 -0
  47. package/references/token-optimization.md +225 -0
  48. package/skills/api-setup.md +315 -0
  49. package/skills/auth-setup.md +180 -0
  50. package/skills/database-setup.md +238 -0
  51. package/skills/expo-app.md +261 -0
  52. package/skills/nextjs-app.md +206 -0
  53. package/skills/payments-setup.md +421 -0
  54. package/skills/sentry-setup.md +295 -0
  55. package/templates/error-handling-config.json +138 -0
  56. package/templates/session-state.json +69 -0
  57. package/templates/starters/.gitkeep +2 -0
  58. package/workflows/.gitkeep +2 -0
@@ -0,0 +1,158 @@
1
+ ---
2
+ name: add-todo
3
+ description: Agregar un item al todo list del proyecto actual
4
+ ---
5
+
6
+ # /elsabro:add-todo
7
+
8
+ <command-name>add-todo</command-name>
9
+
10
+ ## Propósito
11
+
12
+ Agregar tareas rápidas al todo list del proyecto. Para items que no merecen ser una fase o story completa.
13
+
14
+ ## Cuándo Usar
15
+
16
+ ```
17
+ ✅ Ideal para:
18
+ - Recordatorios rápidos
19
+ - Bugs menores que encontraste
20
+ - Ideas para después
21
+ - Deuda técnica pequeña
22
+ - Tareas de mantenimiento
23
+
24
+ ❌ NO usar para:
25
+ - Features completas (usa /elsabro:plan)
26
+ - Bugs críticos (usa /elsabro:debug)
27
+ - Work items del sprint actual
28
+ ```
29
+
30
+ ## Uso
31
+
32
+ ```bash
33
+ # Agregar todo simple
34
+ /elsabro:add-todo "Fix typo in README"
35
+
36
+ # Agregar con prioridad
37
+ /elsabro:add-todo "Update dependencies" --priority=high
38
+
39
+ # Agregar con categoría
40
+ /elsabro:add-todo "Add error boundary" --category=tech-debt
41
+
42
+ # Agregar con deadline
43
+ /elsabro:add-todo "Submit report" --due=2024-01-25
44
+ ```
45
+
46
+ ## Categorías Predefinidas
47
+
48
+ | Categoría | Descripción |
49
+ |-----------|-------------|
50
+ | `bug` | Bugs menores |
51
+ | `tech-debt` | Deuda técnica |
52
+ | `docs` | Documentación |
53
+ | `chore` | Mantenimiento |
54
+ | `idea` | Ideas para después |
55
+ | `question` | Preguntas por resolver |
56
+
57
+ ## Prioridades
58
+
59
+ | Prioridad | Descripción |
60
+ |-----------|-------------|
61
+ | `critical` | Bloquea otras cosas |
62
+ | `high` | Importante, hacer pronto |
63
+ | `medium` | Normal (default) |
64
+ | `low` | Cuando haya tiempo |
65
+
66
+ ## Almacenamiento
67
+
68
+ Todos se guardan en `.planning/TODOS.md`:
69
+
70
+ ```markdown
71
+ # Project TODOs
72
+
73
+ ## Critical 🔴
74
+ - [ ] Fix authentication token refresh (#123)
75
+
76
+ ## High Priority 🟠
77
+ - [ ] Update React to v18.3 (tech-debt)
78
+ - [ ] Add loading states to dashboard (ux)
79
+
80
+ ## Medium Priority 🟡
81
+ - [ ] Fix typo in README (docs) - Added 2024-01-20
82
+ - [ ] Add error boundary (tech-debt)
83
+ - [ ] Document API endpoints (docs)
84
+
85
+ ## Low Priority ⬜
86
+ - [ ] Investigate dark mode (idea)
87
+ - [ ] Consider adding PWA support (idea)
88
+
89
+ ## Completed ✅
90
+ - [x] Set up CI pipeline (2024-01-18)
91
+ - [x] Add basic tests (2024-01-19)
92
+ ```
93
+
94
+ ## Interactivo
95
+
96
+ ```bash
97
+ /elsabro:add-todo
98
+ ```
99
+
100
+ ```
101
+ Add new TODO:
102
+
103
+ Description: Update error messages
104
+ Priority (critical/high/medium/low): high
105
+ Category (bug/tech-debt/docs/chore/idea/question): ux
106
+ Due date (optional):
107
+
108
+ Added: "Update error messages" [high/ux]
109
+ ```
110
+
111
+ ## Opciones
112
+
113
+ ```bash
114
+ --priority, -p # critical/high/medium/low
115
+ --category, -c # Category tag
116
+ --due, -d # Due date
117
+ --milestone, -m # Link to milestone
118
+ --phase # Link to phase
119
+ ```
120
+
121
+ ## Quick Add
122
+
123
+ Para agregar múltiples todos rápidamente:
124
+
125
+ ```bash
126
+ /elsabro:add-todo --batch
127
+ ```
128
+
129
+ ```
130
+ Enter TODOs (one per line, empty to finish):
131
+ > Fix button alignment
132
+ > Add form validation
133
+ > Update user docs
134
+ >
135
+
136
+ Added 3 TODOs (all medium priority)
137
+ ```
138
+
139
+ ## Output
140
+
141
+ ```
142
+ ✓ TODO added
143
+
144
+ Description: Fix typo in README
145
+ Priority: medium
146
+ Category: docs
147
+ Due: -
148
+
149
+ Total TODOs: 8 (2 high, 4 medium, 2 low)
150
+
151
+ View all: /elsabro:check-todos
152
+ ```
153
+
154
+ ## Integración
155
+
156
+ - View with `/elsabro:check-todos`
157
+ - Referenced in `/elsabro:progress`
158
+ - Can be promoted to phase task with `/elsabro:add-phase`
@@ -0,0 +1,147 @@
1
+ ---
2
+ name: audit-milestone
3
+ description: Auditar el estado actual de un milestone - progreso, riesgos y recomendaciones
4
+ ---
5
+
6
+ # /elsabro:audit-milestone
7
+
8
+ <command-name>audit-milestone</command-name>
9
+
10
+ ## Propósito
11
+
12
+ Evaluar el estado real de un milestone en progreso, identificar riesgos y generar recomendaciones actionables.
13
+
14
+ ## Proceso de Auditoría
15
+
16
+ ### Paso 1: Recopilar Datos
17
+
18
+ Usa agentes en paralelo para análisis:
19
+
20
+ ```
21
+ Agent 1: Progress Check
22
+ └─ Estado de cada fase
23
+ └─ Tasks completados vs pendientes
24
+ └─ Tiempo transcurrido vs estimado
25
+
26
+ Agent 2: Code Analysis
27
+ └─ Commits relacionados
28
+ └─ Test coverage
29
+ └─ Build status
30
+
31
+ Agent 3: Risk Assessment
32
+ └─ Blockers identificados
33
+ └─ Dependencias externas
34
+ └─ Technical debt acumulado
35
+ ```
36
+
37
+ ### Paso 2: Generar Reporte
38
+
39
+ ```bash
40
+ /elsabro:audit-milestone M001
41
+ ```
42
+
43
+ Genera `.planning/milestones/M001-xxx/AUDIT-2024-01-20.md`:
44
+
45
+ ```markdown
46
+ # Milestone Audit: M001
47
+
48
+ ## Audit Date: 2024-01-20
49
+ ## Auditor: ELSABRO
50
+
51
+ ## Executive Summary
52
+ 🟡 **Status: AT RISK** - Behind schedule by ~1 week
53
+
54
+ ## Progress Analysis
55
+
56
+ ### By Phase
57
+ | Phase | Progress | Health |
58
+ |-------|----------|--------|
59
+ | P1: Design | 100% | ✅ |
60
+ | P2: Backend | 75% | 🟡 |
61
+ | P3: Frontend | 30% | 🔴 |
62
+ | P4: Testing | 0% | ⬜ |
63
+
64
+ ### By Objective
65
+ | Objective | Status | Notes |
66
+ |-----------|--------|-------|
67
+ | User auth | ✅ Done | - |
68
+ | Dashboard | 🟡 WIP | 2 days left |
69
+ | API v1 | 🔴 Blocked | External dep |
70
+
71
+ ## Risk Assessment
72
+
73
+ ### High Priority 🔴
74
+ 1. **External API delay**
75
+ - Impact: P3 blocked
76
+ - Mitigation: Use mock API
77
+ - Owner: [Name]
78
+
79
+ ### Medium Priority 🟡
80
+ 1. **Test coverage low**
81
+ - Current: 45%
82
+ - Target: 80%
83
+ - Action: Add tests in P4
84
+
85
+ ## Velocity Analysis
86
+ - **Planned:** 10 story points/week
87
+ - **Actual:** 7 story points/week
88
+ - **Trend:** Declining ↓
89
+
90
+ ## Recommendations
91
+
92
+ ### Immediate (This Week)
93
+ 1. Resolve external API blocker
94
+ 2. Parallelize P2 and P3 work
95
+
96
+ ### Short-term (This Sprint)
97
+ 1. Add 2 more resources to P3
98
+ 2. Reduce scope of dashboard MVP
99
+
100
+ ### Long-term
101
+ 1. Improve estimation process
102
+ 2. Build API mock system
103
+
104
+ ## Confidence Level
105
+ - **On-time delivery:** 40% → 60% with recommendations
106
+ - **Full scope:** 70%
107
+ - **Quality target:** 85%
108
+ ```
109
+
110
+ ## Opciones
111
+
112
+ ```bash
113
+ # Audit milestone específico
114
+ /elsabro:audit-milestone M001
115
+
116
+ # Audit todos los milestones activos
117
+ /elsabro:audit-milestone --all
118
+
119
+ # Audit con foco en área
120
+ /elsabro:audit-milestone M001 --focus=velocity
121
+ /elsabro:audit-milestone M001 --focus=risks
122
+ /elsabro:audit-milestone M001 --focus=quality
123
+
124
+ # Export formato específico
125
+ /elsabro:audit-milestone M001 --format=json
126
+ ```
127
+
128
+ ## Métricas Tracked
129
+
130
+ ```
131
+ ┌─────────────────────────────────────────┐
132
+ │ KEY METRICS │
133
+ ├─────────────────────────────────────────┤
134
+ │ 📊 Progress: 45% (target: 60%) │
135
+ │ ⏱️ Schedule: -5 days behind │
136
+ │ 🎯 Scope: 90% original │
137
+ │ 🧪 Quality: 78% coverage │
138
+ │ ⚠️ Risks: 2 high, 3 medium │
139
+ │ 🚫 Blockers: 1 active │
140
+ └─────────────────────────────────────────┘
141
+ ```
142
+
143
+ ## Integración
144
+
145
+ - Puede ser parte de weekly review
146
+ - Alimenta `/elsabro:progress`
147
+ - Dispara alertas si status es crítico
@@ -0,0 +1,192 @@
1
+ ---
2
+ name: check-todos
3
+ description: Ver y gestionar el todo list del proyecto
4
+ ---
5
+
6
+ # /elsabro:check-todos
7
+
8
+ <command-name>check-todos</command-name>
9
+
10
+ ## Propósito
11
+
12
+ Revisar, filtrar y gestionar los TODOs del proyecto. Vista completa de tareas pendientes.
13
+
14
+ ## Cuándo Usar
15
+
16
+ ```
17
+ ✅ Ideal para:
18
+ - Revisión diaria de pendientes
19
+ - Planificar qué hacer después
20
+ - Limpiar todos completados
21
+ - Priorizar trabajo pendiente
22
+ - Antes de terminar el día
23
+
24
+ ❌ NO usar para:
25
+ - Ver progreso de milestone (/elsabro:progress)
26
+ - Planning de sprint (/elsabro:plan)
27
+ ```
28
+
29
+ ## Uso
30
+
31
+ ```bash
32
+ # Ver todos los TODOs
33
+ /elsabro:check-todos
34
+
35
+ # Filtrar por prioridad
36
+ /elsabro:check-todos --priority=high
37
+
38
+ # Filtrar por categoría
39
+ /elsabro:check-todos --category=tech-debt
40
+
41
+ # Ver solo pendientes
42
+ /elsabro:check-todos --pending
43
+
44
+ # Ver completados
45
+ /elsabro:check-todos --completed
46
+ ```
47
+
48
+ ## Vista Principal
49
+
50
+ ```
51
+ ╔══════════════════════════════════════════════════╗
52
+ ║ PROJECT TODOs ║
53
+ ╠══════════════════════════════════════════════════╣
54
+ ║ ║
55
+ ║ 🔴 CRITICAL (1) ║
56
+ ║ #1 Fix auth token refresh [bug] ║
57
+ ║ ║
58
+ ║ 🟠 HIGH (3) ║
59
+ ║ #2 Update React to v18.3 [tech-debt] ║
60
+ ║ #3 Add loading states [ux] ║
61
+ ║ #4 Update error messages [ux] ║
62
+ ║ ║
63
+ ║ 🟡 MEDIUM (4) ║
64
+ ║ #5 Fix typo in README [docs] ║
65
+ ║ #6 Add error boundary [tech-debt] ║
66
+ ║ #7 Document API endpoints [docs] ║
67
+ ║ #8 Add unit tests for utils [test] ║
68
+ ║ ║
69
+ ║ ⬜ LOW (2) ║
70
+ ║ #9 Investigate dark mode [idea] ║
71
+ ║ #10 Consider PWA support [idea] ║
72
+ ║ ║
73
+ ╠══════════════════════════════════════════════════╣
74
+ ║ Total: 10 | Completed today: 2 ║
75
+ ╚══════════════════════════════════════════════════╝
76
+ ```
77
+
78
+ ## Gestión de TODOs
79
+
80
+ ### Marcar como completado
81
+
82
+ ```bash
83
+ /elsabro:check-todos --complete=5
84
+ ```
85
+
86
+ ```
87
+ ✓ Completed: #5 "Fix typo in README"
88
+ ```
89
+
90
+ ### Cambiar prioridad
91
+
92
+ ```bash
93
+ /elsabro:check-todos --prioritize=6 --to=high
94
+ ```
95
+
96
+ ```
97
+ ✓ #6 "Add error boundary" priority: medium → high
98
+ ```
99
+
100
+ ### Eliminar TODO
101
+
102
+ ```bash
103
+ /elsabro:check-todos --delete=9
104
+ ```
105
+
106
+ ```
107
+ Delete #9 "Investigate dark mode"? (y/n)
108
+ > y
109
+ ✓ Deleted
110
+ ```
111
+
112
+ ### Editar TODO
113
+
114
+ ```bash
115
+ /elsabro:check-todos --edit=3
116
+ ```
117
+
118
+ ```
119
+ Current: "Add loading states"
120
+ New description (or Enter to keep):
121
+ > Add loading states to all API calls
122
+
123
+ ✓ Updated #3
124
+ ```
125
+
126
+ ## Filtros
127
+
128
+ ```bash
129
+ # Por prioridad
130
+ --priority=critical|high|medium|low
131
+
132
+ # Por categoría
133
+ --category=bug|tech-debt|docs|chore|idea|question
134
+
135
+ # Por estado
136
+ --pending # Solo pendientes
137
+ --completed # Solo completados
138
+ --overdue # Con fecha vencida
139
+
140
+ # Por fecha
141
+ --due-today # Vencen hoy
142
+ --due-week # Vencen esta semana
143
+
144
+ # Por milestone
145
+ --milestone=M001
146
+ ```
147
+
148
+ ## Estadísticas
149
+
150
+ ```bash
151
+ /elsabro:check-todos --stats
152
+ ```
153
+
154
+ ```
155
+ ╔══════════════════════════════════════════════════╗
156
+ ║ TODO STATISTICS ║
157
+ ╠══════════════════════════════════════════════════╣
158
+ ║ ║
159
+ ║ By Priority: ║
160
+ ║ Critical: ██░░░░░░░░ 1 (10%) ║
161
+ ║ High: ████░░░░░░ 3 (30%) ║
162
+ ║ Medium: ████████░░ 4 (40%) ║
163
+ ║ Low: ████░░░░░░ 2 (20%) ║
164
+ ║ ║
165
+ ║ By Category: ║
166
+ ║ tech-debt: 3 docs: 2 bug: 1 ║
167
+ ║ ux: 2 idea: 2 ║
168
+ ║ ║
169
+ ║ Completion Rate (7 days): 85% ║
170
+ ║ Avg Time to Complete: 2.3 days ║
171
+ ║ ║
172
+ ╚══════════════════════════════════════════════════╝
173
+ ```
174
+
175
+ ## Output Formatos
176
+
177
+ ```bash
178
+ # Markdown
179
+ /elsabro:check-todos --format=md
180
+
181
+ # JSON (para integración)
182
+ /elsabro:check-todos --format=json
183
+
184
+ # Minimal (solo IDs y títulos)
185
+ /elsabro:check-todos --format=minimal
186
+ ```
187
+
188
+ ## Integración
189
+
190
+ - Add with `/elsabro:add-todo`
191
+ - Syncs with `.planning/TODOS.md`
192
+ - Can promote to phase with actions
@@ -0,0 +1,138 @@
1
+ ---
2
+ name: complete-milestone
3
+ description: Cerrar un milestone completado con retrospectiva y documentación de logros
4
+ ---
5
+
6
+ # /elsabro:complete-milestone
7
+
8
+ <command-name>complete-milestone</command-name>
9
+
10
+ ## Propósito
11
+
12
+ Cerrar formalmente un milestone, documentar lo logrado, y capturar aprendizajes para futuros milestones.
13
+
14
+ ## Proceso de Cierre
15
+
16
+ ### Paso 1: Verificación de Completitud
17
+
18
+ ```
19
+ /elsabro:complete-milestone M001
20
+ ```
21
+
22
+ ELSABRO verifica automáticamente:
23
+ - [ ] Todos los success criteria cumplidos
24
+ - [ ] Todas las fases completadas
25
+ - [ ] Tests pasando
26
+ - [ ] Documentación actualizada
27
+
28
+ ### Paso 2: Generar Retrospectiva
29
+
30
+ Si todas las verificaciones pasan, genera `.planning/milestones/M001-xxx/RETROSPECTIVE.md`:
31
+
32
+ ```markdown
33
+ # Retrospective: M001 - MVP Launch
34
+
35
+ ## Completed: 2024-03-01
36
+
37
+ ## Summary
38
+ - **Planned Duration:** 6 weeks
39
+ - **Actual Duration:** 7 weeks
40
+ - **Objectives Met:** 5/5
41
+
42
+ ## What Went Well
43
+ - [Item 1]
44
+ - [Item 2]
45
+ - [Item 3]
46
+
47
+ ## What Could Improve
48
+ - [Item 1]
49
+ - [Item 2]
50
+
51
+ ## Key Learnings
52
+ - [Learning 1]
53
+ - [Learning 2]
54
+
55
+ ## Metrics
56
+ | Metric | Target | Actual |
57
+ |--------|--------|--------|
58
+ | Completion | 100% | 100% |
59
+ | On Time | Yes | No (+1 week) |
60
+ | Quality | High | High |
61
+
62
+ ## Artifacts Produced
63
+ - [List of deliverables]
64
+
65
+ ## Team Recognition
66
+ - [Shoutouts]
67
+ ```
68
+
69
+ ### Paso 3: Actualizar Status
70
+
71
+ Actualiza `MILESTONE.md`:
72
+ ```markdown
73
+ ## Overview
74
+ - **Status:** ✅ Completed
75
+ - **Completed:** 2024-03-01
76
+ ```
77
+
78
+ ### Paso 4: Archive
79
+
80
+ Opcionalmente mueve a `.planning/milestones/completed/`
81
+
82
+ ## Opciones
83
+
84
+ ```bash
85
+ # Completar milestone específico
86
+ /elsabro:complete-milestone M001
87
+
88
+ # Completar con notas
89
+ /elsabro:complete-milestone M001 --notes="Delayed by API changes"
90
+
91
+ # Completar sin retrospectiva (quick)
92
+ /elsabro:complete-milestone M001 --skip-retro
93
+
94
+ # Force complete (skip verifications)
95
+ /elsabro:complete-milestone M001 --force
96
+ ```
97
+
98
+ ## Verificaciones Automáticas
99
+
100
+ ```
101
+ ┌────────────────────────────────────────┐
102
+ │ PRE-COMPLETION CHECKS │
103
+ ├────────────────────────────────────────┤
104
+ │ ✓ All phases marked complete │
105
+ │ ✓ Success criteria met │
106
+ │ ✓ No open blockers │
107
+ │ ✓ Tests passing │
108
+ │ ✗ README not updated ← BLOCKER │
109
+ └────────────────────────────────────────┘
110
+
111
+ Cannot complete milestone. Fix blocker:
112
+ - Update README with new features
113
+
114
+ Options:
115
+ 1. Fix and retry
116
+ 2. --force to skip (not recommended)
117
+ ```
118
+
119
+ ## Output
120
+
121
+ ```
122
+ ╔══════════════════════════════════════════╗
123
+ ║ MILESTONE COMPLETED ║
124
+ ╠══════════════════════════════════════════╣
125
+ ║ M001: MVP Launch ║
126
+ ║ Duration: 7 weeks (planned: 6) ║
127
+ ║ Objectives: 5/5 ✓ ║
128
+ ╠══════════════════════════════════════════╣
129
+ ║ Retrospective: .planning/milestones/ ║
130
+ ║ M001-mvp/RETROSPECTIVE.md║
131
+ ╚══════════════════════════════════════════╝
132
+ ```
133
+
134
+ ## Integración
135
+
136
+ - Dispara notificación de milestone completado
137
+ - Actualiza `/elsabro:progress` automáticamente
138
+ - Linked con próximo milestone si existe