don-cheli-sdd 1.21.0 → 1.22.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 (200) hide show
  1. package/.agent/skills/doncheli-prd/SKILL.md +117 -0
  2. package/CHANGELOG.md +16 -0
  3. package/README.es.md +1 -1
  4. package/README.md +1 -1
  5. package/README.pt.md +1 -1
  6. package/VERSION +1 -1
  7. package/comandos/dc/actualizar.md +266 -0
  8. package/comandos/dc/agente.md +43 -0
  9. package/comandos/dc/analizar-sesiones.md +158 -0
  10. package/comandos/dc/aplicar.md +73 -0
  11. package/comandos/dc/archivar.md +69 -0
  12. package/comandos/dc/audit-trail.md +135 -0
  13. package/comandos/dc/auditar-seguridad.md +234 -0
  14. package/comandos/dc/auditar.md +15 -0
  15. package/comandos/dc/avance-rapido.md +64 -0
  16. package/comandos/dc/capturar.md +61 -0
  17. package/comandos/dc/cerrar-sesion.md +88 -0
  18. package/comandos/dc/changelog-auto.md +81 -0
  19. package/comandos/dc/clarificar.md +98 -0
  20. package/comandos/dc/comenzar.md +105 -0
  21. package/comandos/dc/completo.md +49 -0
  22. package/comandos/dc/context-health.md +226 -0
  23. package/comandos/dc/continuar.md +59 -0
  24. package/comandos/dc/contrato-api.md +223 -0
  25. package/comandos/dc/contrato-ui.md +245 -0
  26. package/comandos/dc/crear-skill.md +148 -0
  27. package/comandos/dc/dashboard.md +52 -0
  28. package/comandos/dc/data-policy.md +222 -0
  29. package/comandos/dc/debate.md +119 -0
  30. package/comandos/dc/desglosar.md +172 -0
  31. package/comandos/dc/destilar.md +211 -0
  32. package/comandos/dc/detectar-ambiguedad.md +81 -0
  33. package/comandos/dc/diagnostico.md +92 -0
  34. package/comandos/dc/diagram.md +71 -0
  35. package/comandos/dc/dise/303/261ar.md +74 -0
  36. package/comandos/dc/doctor.md +78 -0
  37. package/comandos/dc/donde-estoy.md +32 -0
  38. package/comandos/dc/drift.md +161 -0
  39. package/comandos/dc/especificar.md +189 -0
  40. package/comandos/dc/estado.md +46 -0
  41. package/comandos/dc/estimar.md +141 -0
  42. package/comandos/dc/explorar.md +175 -0
  43. package/comandos/dc/gate.md +62 -0
  44. package/comandos/dc/guardian.md +99 -0
  45. package/comandos/dc/historial.md +14 -0
  46. package/comandos/dc/implementar.md +227 -0
  47. package/comandos/dc/incorporar.md +71 -0
  48. package/comandos/dc/iniciar.md +82 -0
  49. package/comandos/dc/limpiar-slop.md +88 -0
  50. package/comandos/dc/marketplace.md +109 -0
  51. package/comandos/dc/memorizar.md +31 -0
  52. package/comandos/dc/mesa-redonda.md +60 -0
  53. package/comandos/dc/mesa-tecnica.md +144 -0
  54. package/comandos/dc/metricas.md +42 -0
  55. package/comandos/dc/migrar.md +237 -0
  56. package/comandos/dc/minar-referencias.md +214 -0
  57. package/comandos/dc/planificar-tecnico.md +186 -0
  58. package/comandos/dc/planning.md +264 -0
  59. package/comandos/dc/poc.md +302 -0
  60. package/comandos/dc/pr-review.md +211 -0
  61. package/comandos/dc/prd.md +148 -0
  62. package/comandos/dc/preflight.md +142 -0
  63. package/comandos/dc/presentar.md +75 -0
  64. package/comandos/dc/proponer.md +69 -0
  65. package/comandos/dc/pseudocodigo.md +49 -0
  66. package/comandos/dc/rapido.md +69 -0
  67. package/comandos/dc/reflexionar.md +53 -0
  68. package/comandos/dc/retro.md +14 -0
  69. package/comandos/dc/reversa.md +155 -0
  70. package/comandos/dc/revisar.md +231 -0
  71. package/comandos/dc/spec-score.md +189 -0
  72. package/comandos/dc/tea.md +190 -0
  73. package/comandos/dc/tech-debt.md +228 -0
  74. package/comandos/dc/time-travel.md +142 -0
  75. package/comandos/dc/traspasar.md +76 -0
  76. package/comandos/dc/traspaso.md +43 -0
  77. package/comandos/dc/uat.md +84 -0
  78. package/comandos/dc/validar-spec.md +58 -0
  79. package/comandos/dc/validar.md +40 -0
  80. package/comandos/dc/visual-test.md +177 -0
  81. package/comandos/dc/voice.md +62 -0
  82. package/comandos/dc/webhook.md +202 -0
  83. package/package.json +1 -1
  84. package/scripts/.claude/commands/dc/actualizar.md +200 -0
  85. package/scripts/.claude/commands/dc/agente.md +43 -0
  86. package/scripts/.claude/commands/dc/analizar-sesiones.md +158 -0
  87. package/scripts/.claude/commands/dc/aplicar.md +73 -0
  88. package/scripts/.claude/commands/dc/archivar.md +69 -0
  89. package/scripts/.claude/commands/dc/audit-trail.md +135 -0
  90. package/scripts/.claude/commands/dc/auditar-seguridad.md +234 -0
  91. package/scripts/.claude/commands/dc/auditar.md +15 -0
  92. package/scripts/.claude/commands/dc/avance-rapido.md +64 -0
  93. package/scripts/.claude/commands/dc/capturar.md +61 -0
  94. package/scripts/.claude/commands/dc/cerrar-sesion.md +88 -0
  95. package/scripts/.claude/commands/dc/changelog-auto.md +81 -0
  96. package/scripts/.claude/commands/dc/clarificar.md +98 -0
  97. package/scripts/.claude/commands/dc/comenzar.md +77 -0
  98. package/scripts/.claude/commands/dc/completo.md +49 -0
  99. package/scripts/.claude/commands/dc/context-health.md +226 -0
  100. package/scripts/.claude/commands/dc/continuar.md +59 -0
  101. package/scripts/.claude/commands/dc/contrato-api.md +223 -0
  102. package/scripts/.claude/commands/dc/contrato-ui.md +245 -0
  103. package/scripts/.claude/commands/dc/crear-skill.md +148 -0
  104. package/scripts/.claude/commands/dc/dashboard.md +52 -0
  105. package/scripts/.claude/commands/dc/data-policy.md +222 -0
  106. package/scripts/.claude/commands/dc/debate.md +119 -0
  107. package/scripts/.claude/commands/dc/desglosar.md +172 -0
  108. package/scripts/.claude/commands/dc/destilar.md +211 -0
  109. package/scripts/.claude/commands/dc/detectar-ambiguedad.md +81 -0
  110. package/scripts/.claude/commands/dc/diagnostico.md +92 -0
  111. package/scripts/.claude/commands/dc/diagram.md +71 -0
  112. package/scripts/.claude/commands/dc/dise/303/261ar.md +74 -0
  113. package/scripts/.claude/commands/dc/doctor.md +78 -0
  114. package/scripts/.claude/commands/dc/donde-estoy.md +32 -0
  115. package/scripts/.claude/commands/dc/drift.md +161 -0
  116. package/scripts/.claude/commands/dc/especificar.md +189 -0
  117. package/scripts/.claude/commands/dc/estado.md +46 -0
  118. package/scripts/.claude/commands/dc/estimar.md +141 -0
  119. package/scripts/.claude/commands/dc/explorar.md +175 -0
  120. package/scripts/.claude/commands/dc/gate.md +62 -0
  121. package/scripts/.claude/commands/dc/guardian.md +99 -0
  122. package/scripts/.claude/commands/dc/historial.md +14 -0
  123. package/scripts/.claude/commands/dc/implementar.md +227 -0
  124. package/scripts/.claude/commands/dc/incorporar.md +71 -0
  125. package/scripts/.claude/commands/dc/iniciar.md +82 -0
  126. package/scripts/.claude/commands/dc/limpiar-slop.md +88 -0
  127. package/scripts/.claude/commands/dc/marketplace.md +109 -0
  128. package/scripts/.claude/commands/dc/memorizar.md +31 -0
  129. package/scripts/.claude/commands/dc/mesa-redonda.md +60 -0
  130. package/scripts/.claude/commands/dc/mesa-tecnica.md +144 -0
  131. package/scripts/.claude/commands/dc/metricas.md +42 -0
  132. package/scripts/.claude/commands/dc/migrar.md +237 -0
  133. package/scripts/.claude/commands/dc/minar-referencias.md +214 -0
  134. package/scripts/.claude/commands/dc/planificar-tecnico.md +186 -0
  135. package/scripts/.claude/commands/dc/planning.md +264 -0
  136. package/scripts/.claude/commands/dc/poc.md +302 -0
  137. package/scripts/.claude/commands/dc/pr-review.md +211 -0
  138. package/scripts/.claude/commands/dc/prd.md +148 -0
  139. package/scripts/.claude/commands/dc/preflight.md +142 -0
  140. package/scripts/.claude/commands/dc/presentar.md +75 -0
  141. package/scripts/.claude/commands/dc/proponer.md +69 -0
  142. package/scripts/.claude/commands/dc/pseudocodigo.md +49 -0
  143. package/scripts/.claude/commands/dc/rapido.md +69 -0
  144. package/scripts/.claude/commands/dc/reflexionar.md +53 -0
  145. package/scripts/.claude/commands/dc/retro.md +14 -0
  146. package/scripts/.claude/commands/dc/reversa.md +155 -0
  147. package/scripts/.claude/commands/dc/revisar.md +221 -0
  148. package/scripts/.claude/commands/dc/spec-score.md +189 -0
  149. package/scripts/.claude/commands/dc/tea.md +190 -0
  150. package/scripts/.claude/commands/dc/tech-debt.md +228 -0
  151. package/scripts/.claude/commands/dc/time-travel.md +142 -0
  152. package/scripts/.claude/commands/dc/traspasar.md +76 -0
  153. package/scripts/.claude/commands/dc/traspaso.md +43 -0
  154. package/scripts/.claude/commands/dc/uat.md +84 -0
  155. package/scripts/.claude/commands/dc/validar-spec.md +58 -0
  156. package/scripts/.claude/commands/dc/validar.md +40 -0
  157. package/scripts/.claude/commands/dc/visual-test.md +177 -0
  158. package/scripts/.claude/commands/dc/voice.md +62 -0
  159. package/scripts/.claude/commands/dc/webhook.md +202 -0
  160. package/scripts/.claude/commands/especdev/audit-trail.md +135 -0
  161. package/scripts/.claude/commands/especdev/capturar.md +61 -0
  162. package/scripts/.claude/commands/especdev/changelog-auto.md +81 -0
  163. package/scripts/.claude/commands/especdev/context-health.md +226 -0
  164. package/scripts/.claude/commands/especdev/crear-skill.md +148 -0
  165. package/scripts/.claude/commands/especdev/dashboard.md +52 -0
  166. package/scripts/.claude/commands/especdev/data-policy.md +222 -0
  167. package/scripts/.claude/commands/especdev/debate.md +119 -0
  168. package/scripts/.claude/commands/especdev/diagram.md +71 -0
  169. package/scripts/.claude/commands/especdev/doctor.md +78 -0
  170. package/scripts/.claude/commands/especdev/drift.md +161 -0
  171. package/scripts/.claude/commands/especdev/gate.md +62 -0
  172. package/scripts/.claude/commands/especdev/marketplace.md +109 -0
  173. package/scripts/.claude/commands/especdev/metricas.md +42 -0
  174. package/scripts/.claude/commands/especdev/pr-review.md +211 -0
  175. package/scripts/.claude/commands/especdev/prd.md +148 -0
  176. package/scripts/.claude/commands/especdev/preflight.md +142 -0
  177. package/scripts/.claude/commands/especdev/presentar.md +75 -0
  178. package/scripts/.claude/commands/especdev/pseudocodigo.md +49 -0
  179. package/scripts/.claude/commands/especdev/spec-score.md +189 -0
  180. package/scripts/.claude/commands/especdev/tea.md +190 -0
  181. package/scripts/.claude/commands/especdev/tech-debt.md +228 -0
  182. package/scripts/.claude/commands/especdev/time-travel.md +142 -0
  183. package/scripts/.claude/commands/especdev/uat.md +84 -0
  184. package/scripts/.claude/commands/especdev/validar-spec.md +58 -0
  185. package/scripts/.claude/commands/especdev/visual-test.md +177 -0
  186. package/scripts/.claude/commands/especdev/voice.md +62 -0
  187. package/scripts/.claude/commands/especdev/webhook.md +202 -0
  188. package/scripts/.claude/don-cheli/VERSION +1 -1
  189. package/scripts/.claude/don-cheli/habilidades/custom-gates/HABILIDAD.md +51 -0
  190. package/scripts/.claude/don-cheli/habilidades/generador-prd/HABILIDAD.md +295 -0
  191. package/scripts/.claude/don-cheli/habilidades/metricas-sesion/HABILIDAD.md +72 -0
  192. package/scripts/.claude/don-cheli/habilidades/planning-equipo/HABILIDAD.md +169 -0
  193. package/scripts/.claude/don-cheli/habilidades/preflight/HABILIDAD.md +41 -0
  194. package/scripts/.claude/don-cheli/habilidades/proyecciones-costo/HABILIDAD.md +54 -0
  195. package/scripts/.claude/don-cheli/habilidades/routing-modelos/HABILIDAD.md +79 -0
  196. package/scripts/.claude/don-cheli/habilidades/salud-habilidades/HABILIDAD.md +63 -0
  197. package/scripts/.claude/don-cheli/habilidades/time-travel/HABILIDAD.md +41 -0
  198. package/scripts/.claude/don-cheli/scripts/instalar.sh +16 -8
  199. package/scripts/generar-config.sh +1 -1
  200. package/scripts/instalar.sh +16 -8
@@ -0,0 +1,117 @@
1
+ ---
2
+ name: doncheli-prd
3
+ description: Generate professional Product Requirement Documents (PRD) from multiple sources — Figma designs, briefs, user research, existing code. Includes risk analysis, RICE prioritization, Gherkin stories and launch plan. Activate when user mentions "PRD", "product requirements", "requirement document", "product spec", "figma to PRD", "generate PRD".
4
+ ---
5
+
6
+ # Don Cheli: PRD Generator
7
+
8
+ ## Instructions
9
+
10
+ 1. **Discover sources** — Identify all available inputs:
11
+ - Figma links: analyze screens, flows, components, missing states
12
+ - Brief documents: extract objectives, audience, problems
13
+ - User research: identify personas, JTBD, pain points
14
+ - Existing code: detect technical constraints
15
+ - Conversation context: extract requirements mentioned by the user
16
+
17
+ 2. **Analyze Figma** (if provided):
18
+ - Count screens/frames and map navigation flow
19
+ - Extract texts, labels, form fields, interactions
20
+ - Detect missing UI states: loading, empty, error, success, offline
21
+ - Identify gaps: flows not designed, edge cases missing
22
+ - Convert each screen → user stories → acceptance criteria
23
+
24
+ 3. **Risk analysis** — For each feature, evaluate 7 risk categories:
25
+ - Technical (complexity, integrations, tech debt)
26
+ - Product (market fit, adoption, competition)
27
+ - UX (usability, accessibility, learning curve)
28
+ - Business (revenue, cost, time-to-market)
29
+ - Legal (GDPR, compliance, ToS)
30
+ - Security (OWASP, sensitive data, auth)
31
+ - Operational (support, scalability, monitoring)
32
+ - Assign probability (Low/Medium/High) and impact (Low/Medium/High/Critical)
33
+ - Propose mitigation for each risk
34
+
35
+ 4. **Prioritize features** using MoSCoW + RICE:
36
+ - MoSCoW: Must / Should / Could / Won't
37
+ - RICE: (Reach × Impact × Confidence) / Effort
38
+ - Rank features by RICE score
39
+
40
+ 5. **Generate PRD** with 13 sections:
41
+ 1. Executive Summary
42
+ 2. Problem (context, pain points, evidence)
43
+ 3. Objectives & Success Metrics (KPIs, North Star)
44
+ 4. Target Audience (personas, JTBD, user journey)
45
+ 5. Proposed Solution (overview, main flow, features by priority)
46
+ 6. Detailed Requirements (functional with Gherkin, non-functional, integrations, data model)
47
+ 7. Design & UX (Figma analysis, UI states, responsive, accessibility)
48
+ 8. Risk Analysis (matrix, mitigations, dependencies)
49
+ 9. Scope (in scope, out of scope, future iterations)
50
+ 10. Timeline & Milestones
51
+ 11. Competitive Analysis
52
+ 12. Launch Plan (rollout, monitoring, rollback)
53
+ 13. Appendices (glossary, references, change history)
54
+
55
+ 6. **Validate PRD quality**:
56
+ - Every requirement must be verifiable/testable
57
+ - Success metrics must be defined with baseline and target
58
+ - Every risk must have a mitigation
59
+ - Scope must be realistic for the timeline
60
+ - Anti-scope (out of scope) must be explicit
61
+
62
+ ## Output Format
63
+
64
+ ```markdown
65
+ # PRD: [Product/Feature Name]
66
+
67
+ ## Metadata
68
+ | Field | Value |
69
+ |-------|-------|
70
+ | Version | 1.0 |
71
+ | Author | [name] |
72
+ | Status | Draft / In Review / Approved |
73
+ | Date | [date] |
74
+
75
+ ## 1. Executive Summary
76
+ ...
77
+ (continue with all 13 sections)
78
+ ```
79
+
80
+ Save output to:
81
+ - `.dc/prd/prd-v1.0.md` — Full PRD
82
+ - `.dc/prd/prd-risks.md` — Expanded risk matrix
83
+ - `.dc/prd/prd-figma-analysis.md` — Figma analysis (if applicable)
84
+
85
+ ## Integration with SDD Pipeline
86
+
87
+ After generating the PRD, suggest:
88
+ ```
89
+ /dc:specify → Convert user stories into Gherkin specs
90
+ /dc:tech-plan → Generate blueprint from the PRD
91
+ /dc:breakdown → Create TDD tasks from the stories
92
+ ```
93
+
94
+ ## Templates
95
+
96
+ Select based on product type:
97
+ - `saas` — B2B platforms, dashboards, multi-tenant
98
+ - `mobile` — Native iOS/Android, PWA
99
+ - `ecommerce` — Online stores, marketplaces
100
+ - `api` — Public APIs, SDKs, developer platforms
101
+ - `internal` — Internal team tools
102
+ - `landing` — Landing pages, conversion funnels
103
+
104
+ ## Quality Gate
105
+
106
+ - Never generate a PRD without at least 1 verifiable success metric
107
+ - Never omit the risk section — if no risks are visible, dig deeper
108
+ - Never leave scope ambiguous — mark unclear items as `[NEEDS CLARIFICATION]`
109
+ - Always include explicit anti-scope (what will NOT be built)
110
+ - Always generate user stories in Gherkin format for SDD integration
111
+ - Always version the PRD (v1.0, v1.1) with change history
112
+
113
+ ## Do not use this skill when
114
+
115
+ - The task is a simple bug fix or hotfix — use `/dc:quick` instead
116
+ - The user only needs technical specs — use `/dc:specify` directly
117
+ - The requirement is already well-defined in Gherkin — skip PRD, go to plan
package/CHANGELOG.md CHANGED
@@ -4,6 +4,22 @@ Todos los cambios notables en Don Cheli SDD Framework.
4
4
 
5
5
  Formato basado en [Conventional Commits](https://www.conventionalcommits.org/).
6
6
 
7
+ ## [1.22.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.21.1...v1.22.0) (2026-04-07)
8
+
9
+ ### Nuevas Funcionalidades
10
+
11
+ * dc/ como prefijo principal, especdev/ como retrocompatible ([521a93c](https://github.com/doncheli/don-cheli-sdd/commit/521a93cc87c40d8a74e81bbe29ff2c4996ed4eab))
12
+
13
+ ## [1.21.1](https://github.com/doncheli/don-cheli-sdd/compare/v1.21.0...v1.21.1) (2026-04-07)
14
+
15
+ ### Correcciones
16
+
17
+ * sincronizar 27 comandos y 8 habilidades faltantes al mirror de instalación ([ac27440](https://github.com/doncheli/don-cheli-sdd/commit/ac274400362172d960f1da8c1698d1e1090afd62))
18
+
19
+ ### Documentación
20
+
21
+ * completar documentación PRD skill en 3 idiomas + mirrors ([59beb53](https://github.com/doncheli/don-cheli-sdd/commit/59beb53853811564b9360e1b56357732d1036f89))
22
+
7
23
  ## [1.21.0](https://github.com/doncheli/don-cheli-sdd/compare/v1.20.0...v1.21.0) (2026-04-07)
8
24
 
9
25
  ### Nuevas Funcionalidades
package/README.es.md CHANGED
@@ -12,7 +12,7 @@
12
12
  </p>
13
13
  <p align="center">
14
14
  <a href="#-instalación"><img src="https://img.shields.io/badge/instalación-2_minutos-brightgreen" alt="Install"></a>
15
- <img src="https://img.shields.io/badge/versión-1.21.0-blue" alt="Version">
15
+ <img src="https://img.shields.io/badge/versión-1.22.0-blue" alt="Version">
16
16
  <img src="https://img.shields.io/badge/licencia-Apache%202.0-green" alt="License">
17
17
  <img src="https://img.shields.io/badge/idiomas-ES%20|%20EN%20|%20PT-red" alt="Languages">
18
18
  <img src="https://img.shields.io/badge/comandos-85+-purple" alt="Commands">
package/README.md CHANGED
@@ -12,7 +12,7 @@
12
12
  </p>
13
13
  <p align="center">
14
14
  <a href="#-installation"><img src="https://img.shields.io/badge/install-2_minutes-brightgreen" alt="Install"></a>
15
- <img src="https://img.shields.io/badge/version-1.21.0-blue" alt="Version">
15
+ <img src="https://img.shields.io/badge/version-1.22.0-blue" alt="Version">
16
16
  <img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License">
17
17
  <img src="https://img.shields.io/badge/languages-ES%20|%20EN%20|%20PT-red" alt="Languages">
18
18
  <img src="https://img.shields.io/badge/commands-85+-purple" alt="Commands">
package/README.pt.md CHANGED
@@ -12,7 +12,7 @@
12
12
  </p>
13
13
  <p align="center">
14
14
  <a href="#-instalação"><img src="https://img.shields.io/badge/instalação-2_minutos-brightgreen" alt="Install"></a>
15
- <img src="https://img.shields.io/badge/versão-1.21.0-blue" alt="Version">
15
+ <img src="https://img.shields.io/badge/versão-1.22.0-blue" alt="Version">
16
16
  <img src="https://img.shields.io/badge/licença-Apache%202.0-green" alt="License">
17
17
  <img src="https://img.shields.io/badge/idiomas-ES%20|%20EN%20|%20PT-red" alt="Languages">
18
18
  <img src="https://img.shields.io/badge/comandos-85+-purple" alt="Commands">
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.21.0
1
+ 1.22.0
@@ -0,0 +1,266 @@
1
+ ---
2
+ description: Detectar y aplicar actualizaciones del framework Don Cheli. Usa cuando el usuario dice "actualizar Don Cheli", "update framework", "nueva versión", "upgrade". Aplica updates con auditoría de seguridad sobre archivos cambiados. POST-INVOCATION: solo se invoca manualmente.
3
+ i18n: true
4
+ ---
5
+
6
+ # /dc:actualizar
7
+
8
+ ## Objetivo
9
+
10
+ Verificar si hay actualizaciones disponibles en el repositorio de Don Cheli y ofrecer aplicarlas.
11
+
12
+ ## Uso
13
+
14
+ ```
15
+ /dc:actualizar
16
+ /dc:actualizar --verificar # Solo verificar, no aplicar
17
+ /dc:actualizar --forzar # Aplicar sin confirmar
18
+ /dc:actualizar --auto # Auto-actualizar con auditoría de seguridad (usado por auto-check de sesión)
19
+ ```
20
+
21
+ ## Proceso
22
+
23
+ ### 1. Detectar instalación
24
+
25
+ ```bash
26
+ # Verificar dónde está instalado
27
+ GLOBAL="$HOME/.claude/don-cheli"
28
+ LOCAL="./.claude/don-cheli"
29
+
30
+ if [ -f "$GLOBAL/VERSION" ]; then
31
+ INSTALACION="$GLOBAL"
32
+ elif [ -f "$LOCAL/VERSION" ]; then
33
+ INSTALACION="$LOCAL"
34
+ else
35
+ echo "Don Cheli no está instalado"
36
+ exit 1
37
+ fi
38
+
39
+ VERSION_LOCAL=$(cat "$INSTALACION/VERSION")
40
+ ```
41
+
42
+ ### 2. Verificar versión remota
43
+
44
+ ```bash
45
+ VERSION_REMOTA=$(curl -s https://raw.githubusercontent.com/doncheli/don-cheli-sdd/main/VERSION)
46
+ ```
47
+
48
+ ### 3. Comparar
49
+
50
+ ```
51
+ === Verificación de Actualización ===
52
+
53
+ Versión instalada: 1.6.0
54
+ Versión disponible: 1.7.0
55
+
56
+ Estado: ⚠️ Actualización disponible
57
+ ```
58
+
59
+ ### 4. Mostrar cambios
60
+
61
+ Obtener el changelog entre versiones:
62
+
63
+ ```bash
64
+ # Mostrar commits entre versiones
65
+ curl -s "https://api.github.com/repos/doncheli/don-cheli-sdd/compare/v${VERSION_LOCAL}...v${VERSION_REMOTA}" \
66
+ | jq '.commits[].commit.message'
67
+ ```
68
+
69
+ ### 5. Auditoría de seguridad pre-actualización
70
+
71
+ Antes de aplicar cualquier actualización, ejecutar auditoría de seguridad sobre los cambios:
72
+
73
+ ```
74
+ 1. DIFF — Obtener archivos cambiados entre versiones
75
+ curl -s "https://api.github.com/repos/doncheli/don-cheli-sdd/compare/v${VERSION_LOCAL}...v${VERSION_REMOTA}" \
76
+ | jq '.files[].filename'
77
+
78
+ 2. CLONAR — Descargar versión nueva en temporal
79
+ TEMP=$(mktemp -d)
80
+ git clone --depth 1 https://github.com/doncheli/don-cheli-sdd.git "$TEMP"
81
+
82
+ 3. AUDITAR — Análisis de seguridad sobre archivos cambiados
83
+ Ejecutar /dc:auditar-seguridad sobre $TEMP con:
84
+ - Buscar secretos hardcoded (API keys, tokens, passwords)
85
+ - Buscar inyección de comandos en scripts (exec, eval, spawn)
86
+ - Verificar que scripts de instalación no ejecuten código arbitrario
87
+ - Verificar integridad de dependencias (package.json, lockfile)
88
+ - Buscar URLs/endpoints sospechosos nuevos
89
+ - Verificar que no se introduzcan permisos excesivos
90
+
91
+ 4. CLASIFICAR — Severidad de hallazgos
92
+ 🔴 Crítico → BLOQUEAR actualización, notificar al usuario
93
+ 🟠 Alto → ADVERTIR, aplicar con nota de riesgo
94
+ 🟡 Medio/🔵 Bajo → Registrar, no bloquear
95
+ ```
96
+
97
+ #### Output de auditoría pre-actualización
98
+
99
+ ```markdown
100
+ === Auditoría de Seguridad Pre-Actualización ===
101
+
102
+ Versión: v{local} → v{remota}
103
+ Archivos cambiados: {N}
104
+ Archivos auditados: {N} (scripts, configs, código ejecutable)
105
+
106
+ Resultado: ✅ LIMPIO | ⚠️ ADVERTENCIAS | 🛑 BLOQUEADO
107
+
108
+ Hallazgos:
109
+ (lista de hallazgos si los hay)
110
+ ```
111
+
112
+ ### 6. Preguntar al usuario (modo interactivo)
113
+
114
+ En modo interactivo (sin `--auto` ni `--forzar`):
115
+ ```
116
+ ¿Deseas actualizar Don Cheli de v1.6.0 a v1.7.0? (s/n)
117
+ ```
118
+
119
+ En modo `--auto`: aplicar directamente si la auditoría pasa. Bloquear si hay hallazgos críticos.
120
+
121
+ ### 7. Aplicar actualización
122
+
123
+ ```bash
124
+ # Usar el temporal ya clonado en paso 5.2
125
+ cd "$TEMP" && bash scripts/instalar.sh --global
126
+
127
+ # Limpiar
128
+ rm -rf "$TEMP"
129
+ ```
130
+
131
+ ## Output
132
+
133
+ ```
134
+ === Actualización Completada ===
135
+
136
+ ✅ Don Cheli actualizado: v1.6.0 → v1.7.0
137
+
138
+ Cambios aplicados:
139
+ - 3 habilidades nuevas
140
+ - 2 comandos nuevos
141
+ - 5 archivos actualizados
142
+
143
+ Reinicia Claude Code para aplicar los cambios.
144
+ ```
145
+
146
+ ## Verificación de Anthropic Skills 2.0
147
+
148
+ Además de actualizar el framework, este comando verifica la conformidad con el estándar Anthropic Agent Skills.
149
+
150
+ ### Proceso de verificación
151
+
152
+ ```
153
+ 1. FETCH — Obtener spec y template desde el repo oficial
154
+ ├── https://github.com/anthropics/skills/blob/main/spec/agent-skills-spec.md
155
+ ├── https://github.com/anthropics/skills/blob/main/template/SKILL.md
156
+ └── https://agentskills.io/specification (spec completa)
157
+
158
+ 2. COMPARE — Comparar con el formato actual del framework
159
+ ├── Campos requeridos en frontmatter (name, description)
160
+ ├── Campos nuevos agregados al spec
161
+ ├── Convenciones de naming (lowercase, hyphens, max 64 chars)
162
+ ├── Estructura de directorios (skill-name/SKILL.md)
163
+ └── Features nuevas (hooks, allowed-tools, model, effort, etc.)
164
+
165
+ 3. AUDIT — Validar archivos del framework
166
+ ├── Comandos en comandos/especdev/*.md → frontmatter válido
167
+ ├── Comandos en comandos/razonar/*.md → frontmatter válido
168
+ ├── Skills en .agent/skills/*/SKILL.md → conformidad Anthropic
169
+ ├── Habilidades en habilidades/*/HABILIDAD.md → formato extendido
170
+ └── Naming conventions en todos los archivos
171
+
172
+ 4. REPORT — Generar reporte de conformidad
173
+ ```
174
+
175
+ ### Output de verificación Skills 2.0
176
+
177
+ ```
178
+ === Anthropic Skills 2.0 — Verificación de Conformidad ===
179
+
180
+ Spec source: https://agentskills.io/specification
181
+ Template source: https://github.com/anthropics/skills/blob/main/template/SKILL.md
182
+ Last check: 2026-03-24
183
+
184
+ Campos requeridos:
185
+ ✅ name — presente en todos los skills
186
+ ✅ description — presente en todos los skills y comandos
187
+
188
+ Campos opcionales detectados en spec:
189
+ ✅ allowed-tools — soportado
190
+ ✅ model — soportado
191
+ ✅ effort — soportado
192
+ ⚠️ hooks — no implementado en habilidades Don Cheli (solo en .agent/skills)
193
+ ⚠️ context: fork — no implementado
194
+
195
+ Naming:
196
+ ✅ 125/125 archivos siguen convención lowercase-hyphens
197
+
198
+ Novedades en el spec (si las hay):
199
+ ℹ️ Nuevo campo "argument-hint" detectado — considerar agregar
200
+ ℹ️ Nuevo campo "disable-model-invocation" — considerar agregar
201
+
202
+ Resumen: 98% conformidad | 2 campos opcionales pendientes
203
+ ```
204
+
205
+ ### Qué se verifica contra el spec oficial
206
+
207
+ | Check | Fuente | Qué valida |
208
+ |-------|--------|------------|
209
+ | Frontmatter YAML | Template oficial | `---` delimiters, campos `name` + `description` |
210
+ | Naming | Spec | Solo lowercase, números, hyphens (max 64 chars) |
211
+ | Estructura | Spec | `skill-name/SKILL.md` dentro del directorio de skills |
212
+ | Campos opcionales | Spec en agentskills.io | Nuevos campos agregados al estándar |
213
+ | Plugin format | `.claude-plugin` | Compatibilidad con marketplace oficial |
214
+ | Description length | Spec | Max 1024 chars recomendado |
215
+
216
+ ### Comando combinado
217
+
218
+ ```bash
219
+ /dc:actualizar # Actualiza framework + verifica Skills 2.0
220
+ /dc:actualizar --solo-skills # Solo verificar conformidad Skills 2.0
221
+ /dc:actualizar --verificar # Solo verificar, no aplicar nada
222
+ /dc:actualizar --forzar # Aplicar sin confirmar
223
+ ```
224
+
225
+ ## Configuración de Auto-Actualización
226
+
227
+ En `.dc/config.yaml`:
228
+
229
+ ```yaml
230
+ actualizaciones:
231
+ verificar_al_iniciar: true
232
+ auto_actualizar: true # Aplicar actualizaciones automáticamente (requiere auditoría limpia)
233
+ auditoria_pre_update: true # Auditoría de seguridad obligatoria antes de aplicar
234
+ frecuencia: siempre # siempre | diario | semanal | nunca
235
+ verificar_skills_spec: true # Verificar conformidad Anthropic Skills 2.0
236
+ bloquear_en_critico: true # Detener actualización si hay hallazgos 🔴
237
+ ```
238
+
239
+ ### Comportamiento al inicio de sesión
240
+
241
+ Cada vez que un cliente inicia sesión con Don Cheli:
242
+ 1. Verificar versión remota vs local
243
+ 2. Si hay actualización → ejecutar `/dc:actualizar --auto` en background
244
+ 3. El proceso no bloquea la interacción del usuario
245
+ 4. El usuario recibe notificación al completar (éxito o bloqueo)
246
+
247
+ ### Flujo `--auto`
248
+
249
+ ```
250
+ Inicio de sesión
251
+ → Detectar versión remota
252
+ → Si nueva versión disponible:
253
+ → Clonar en temporal
254
+ → Auditoría de seguridad (--severidad critica)
255
+ → Si 🔴 Crítico → BLOQUEAR + notificar
256
+ → Si limpio → instalar + notificar éxito
257
+ → Verificar Skills 2.0 (si habilitado)
258
+ → Limpiar temporal
259
+ ```
260
+
261
+ ## Fuentes oficiales
262
+
263
+ - Spec: https://agentskills.io/specification
264
+ - Repo: https://github.com/anthropics/skills
265
+ - Template: https://github.com/anthropics/skills/blob/main/template/SKILL.md
266
+ - Docs: https://support.claude.com/en/articles/12512198-creating-custom-skills
@@ -0,0 +1,43 @@
1
+ ---
2
+ description: Cargar un agente especializado para una tarea específica. Usa cuando el usuario dice "cargar agente", "usar agente", "specialist agent", "spawn agent", "subagent", "agente especializado", "run agent", "delegar a agente". Detecta el tipo de agente necesario (Explore, Plan, general-purpose) y spawnea el subagent apropiado.
3
+ i18n: true
4
+ ---
5
+
6
+ # /dc:agente
7
+
8
+ ## Objetivo
9
+
10
+ Cargar un agente especializado con el modelo óptimo para una tarea específica.
11
+
12
+ ## Uso
13
+
14
+ ```
15
+ /dc:agente <nombre>
16
+ /dc:agente restablecer
17
+ ```
18
+
19
+ ## Agentes Disponibles
20
+
21
+ | Agente | Modelo | Rol |
22
+ |--------|--------|-----|
23
+ | `planificador` | opus | Planificación, descomposición de tareas |
24
+ | `arquitecto` | opus | Diseño de sistemas, decisiones técnicas |
25
+ | `ejecutor` | sonnet | Implementación, escritura de código |
26
+ | `revisor` | opus | Revisión de código, validación de calidad |
27
+ | `tester` | sonnet | Escritura y ejecución de tests |
28
+ | `documentador` | haiku | Actualización de documentación |
29
+ | `estimador` | opus | Estimados de desarrollo y esfuerzo |
30
+
31
+ ## Flujo de Trabajo
32
+
33
+ ```
34
+ Modo Completo: planificador → arquitecto → ejecutor ↔ tester → revisor → documentador
35
+ Modo Rápido: ejecutor → tester → documentador
36
+ ```
37
+
38
+ ## Ahorro de Costos
39
+
40
+ | Modo | Distribución | Ahorro vs Opus-solo |
41
+ |------|--------------|---------------------|
42
+ | Rápido | 80% sonnet, 20% haiku | ~60% |
43
+ | Completo | 50% sonnet, 30% opus, 20% haiku | ~40% |
@@ -0,0 +1,158 @@
1
+ ---
2
+ description: Analizar sesiones de Claude en el equipo para extraer patrones de uso y generar recomendaciones. Usa cuando el usuario dice "analizar sesiones", "session analysis", "patrones de uso", "usage patterns", "recommendations", "analizar cómo uso Claude". Extrae patterns y genera recomendaciones de skills, plugins, agentes y rules.
3
+ i18n: true
4
+ ---
5
+
6
+ # /dc:analizar-sesiones
7
+
8
+ ## Objetivo
9
+
10
+ Escanear todas las sesiones de Claude en el equipo local, analizar patrones de uso, y generar recomendaciones concretas sobre qué debería convertirse en habilidades reutilizables, plugins, agentes autónomos o instrucciones de proyecto.
11
+
12
+ ## Uso
13
+
14
+ ```
15
+ /dc:analizar-sesiones
16
+ /dc:analizar-sesiones --periodo <dias>
17
+ /dc:analizar-sesiones --formato <resumen|detallado|ejecutivo>
18
+ ```
19
+
20
+ ## Comportamiento
21
+
22
+ 1. **Escanear** todas las sesiones de Claude en el equipo
23
+ - Ubicación típica: `~/.claude/projects/` y sesiones en ficheros JSONL
24
+ - Incluye: prompts del usuario, respuestas del agente, herramientas usadas, archivos editados
25
+
26
+ 2. **Clasificar** cada interacción por tipo:
27
+ - Generación de código
28
+ - Debugging / corrección de bugs
29
+ - Refactoring
30
+ - Code review
31
+ - Documentación
32
+ - Pregunta / Q&A
33
+ - Configuración / DevOps
34
+ - Diseño / Arquitectura
35
+ - Testing
36
+ - Scripting / Automatización
37
+
38
+ 3. **Analizar** patrones de frecuencia:
39
+ - ¿Qué tipo de tareas se repiten más?
40
+ - ¿Qué archivos se editan con más frecuencia?
41
+ - ¿Qué comandos/herramientas se usan más?
42
+ - ¿Qué patrones de prompt se repiten?
43
+ - ¿Cuántos tokens se consumen por tipo de tarea?
44
+
45
+ 4. **Generar** recomendaciones en 5 categorías
46
+
47
+ ## Output
48
+
49
+ ```markdown
50
+ # Análisis de Sesiones de Claude
51
+
52
+ ## 📊 Resumen de Uso
53
+
54
+ | Métrica | Valor |
55
+ |---------|-------|
56
+ | Sesiones analizadas | 47 |
57
+ | Período | Últimos 30 días |
58
+ | Tokens consumidos | ~2.4M |
59
+ | Tipo más frecuente | Generación de código (38%) |
60
+
61
+ ## 🔁 Lo que Hago Más Frecuentemente
62
+
63
+ | # | Actividad | Frecuencia | Tokens/Sesión |
64
+ |---|----------|------------|---------------|
65
+ | 1 | Crear componentes React | 23 veces | ~8K |
66
+ | 2 | Corregir tests fallidos | 18 veces | ~5K |
67
+ | 3 | Escribir endpoints API | 15 veces | ~12K |
68
+ | 4 | Refactorizar funciones | 12 veces | ~6K |
69
+ | 5 | Generar documentación | 9 veces | ~3K |
70
+
71
+ ## 🧠 Debería Convertirse en HABILIDAD (Skill)
72
+
73
+ Flujos de trabajo reutilizables que repito constantemente:
74
+
75
+ | Skill Propuesta | Basada en | Ahorro Estimado |
76
+ |----------------|-----------|-----------------|
77
+ | `crear-componente-react` | 23 sesiones de creación de componentes | ~40% tokens |
78
+ | `fix-test-pattern` | 18 sesiones de debugging de tests | ~30% tokens |
79
+ | `api-endpoint-scaffold` | 15 sesiones de creación de APIs | ~50% tokens |
80
+
81
+ **Formato de skill:**
82
+ ```yaml
83
+ # habilidades/crear-componente-react/HABILIDAD.md
84
+ Patrón detectado: El usuario siempre pide...
85
+ 1. Crear componente funcional con TypeScript
86
+ 2. Agregar tests unitarios con testing-library
87
+ 3. Agregar storybook story
88
+ 4. Exportar desde index.ts
89
+ ```
90
+
91
+ ## 🔌 Debería Convertirse en PLUGIN (Herramienta Standalone)
92
+
93
+ Herramientas que uso repetidamente que podrían automatizarse:
94
+
95
+ | Plugin Propuesto | Basado en | Tipo |
96
+ |-----------------|-----------|------|
97
+ | `scaffold-feature` | Creación repetitiva de estructura feature/ | CLI tool |
98
+ | `test-coverage-checker` | Verificación manual de cobertura | Script |
99
+ | `pr-description-gen` | Redacción manual de descripciones de PR | Automatización |
100
+
101
+ ## 🤖 Debería Convertirse en AGENTE (Subagente Autónomo)
102
+
103
+ Tareas que delego completas y que podrían ejecutarse autónomamente:
104
+
105
+ | Agente Propuesto | Basado en | Modelo Recomendado |
106
+ |-----------------|-----------|-------------------|
107
+ | `code-reviewer` | Revisiones de código frecuentes | Sonnet |
108
+ | `test-generator` | Generación repetitiva de tests | Haiku |
109
+ | `doc-updater` | Actualización de docs tras cambios | Haiku |
110
+
111
+ ## 📋 Debería Ir en CLAUDE.md (Instrucciones de Proyecto)
112
+
113
+ Reglas que repito en cada sesión y deberían ser instrucciones permanentes:
114
+
115
+ | Regla | Veces Repetida |
116
+ |-------|---------------|
117
+ | "Usa TypeScript estricto" | 34 veces |
118
+ | "Tests con testing-library, no enzyme" | 22 veces |
119
+ | "No uses any" | 19 veces |
120
+ | "Imports ordenados: react primero" | 15 veces |
121
+
122
+ **CLAUDE.md sugerido:**
123
+ ```markdown
124
+ ## Convenciones
125
+ - TypeScript estricto (no `any`)
126
+ - Tests con @testing-library/react
127
+ - Imports: React > libs externas > internos > tipos
128
+ - Componentes funcionales, no clases
129
+ ```
130
+
131
+ ## 💡 Recomendaciones de Optimización
132
+
133
+ 1. **Tokenización:** ~40% de tus tokens se gastan en repetir contexto
134
+ → Crear skills reduciría consumo en ~35%
135
+ 2. **Modelo:** Usas Opus para tareas que Haiku podría resolver
136
+ → Usar la matriz de selección de modelos ahorraría ~60% costo
137
+ 3. **Sesiones largas:** El 30% de tus sesiones exceden 50K tokens
138
+ → Implementar context folding (RLM) mejoraría calidad
139
+ ```
140
+
141
+ ## Cómo Mejora el Framework
142
+
143
+ | Aspecto | Sin Análisis | Con Análisis |
144
+ |---------|-------------|-------------|
145
+ | **Skills** | Genéricas, predefinidas | Personalizadas según tu uso real |
146
+ | **Plugins** | No existen | Auto-generados desde patrones |
147
+ | **Agentes** | Configuración manual | Asignación automática por patrón |
148
+ | **CLAUDE.md** | Escribir manualmente | Auto-generado desde repeticiones |
149
+ | **Costos** | Sin control | Optimizado por matriz de modelos |
150
+
151
+ ## Integración con Don Cheli
152
+
153
+ Este comando se integra con:
154
+ - `/dc:iniciar` → Las skills detectadas se sugieren al crear un proyecto nuevo
155
+ - `/dc:agente` → Los agentes detectados se agregan al sistema de agentes
156
+ - `/dc:estimar` → Los datos históricos alimentan estimados más precisos
157
+ - **Reglas de Trabajo Globales** → Las reglas detectadas se incorporan automáticamente
158
+ - **Optimización de Tokens** → Los patrones de consumo optimizan uso de modelos