sdd-es 2.0.0 → 2.6.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 (127) hide show
  1. package/.claude/settings.json +29 -29
  2. package/.claude/settings.local.json +10 -0
  3. package/.claude-plugin/marketplace.json +10 -7
  4. package/.claude-plugin/plugin.json +59 -37
  5. package/.gitignore +20 -0
  6. package/.mcp.json +8 -0
  7. package/LICENSE +21 -0
  8. package/README.md +77 -40
  9. package/agents/architecture-designer.md +211 -0
  10. package/agents/arquitecto.md +16 -1
  11. package/agents/asesor-datos.md +15 -1
  12. package/agents/critico.md +37 -1
  13. package/agents/desarrollador-backend.md +3 -1
  14. package/agents/desarrollador-frontend.md +11 -16
  15. package/agents/disenador-api.md +13 -1
  16. package/agents/documentador.md +3 -1
  17. package/agents/investigador.md +3 -1
  18. package/agents/operaciones.md +3 -1
  19. package/agents/product-designer.md +268 -0
  20. package/agents/revisor.md +25 -1
  21. package/agents/seguridad.md +5 -1
  22. package/agents/tester.md +3 -1
  23. package/claude-hooks/agent-memory.js +288 -0
  24. package/claude-hooks/pre-tool-guard.js +61 -9
  25. package/cli/index.js +1 -2
  26. package/commands/sdd.adr.md +196 -0
  27. package/commands/sdd.analizar.md +23 -2
  28. package/commands/sdd.ayuda.md +13 -0
  29. package/commands/sdd.compliance.md +521 -0
  30. package/commands/sdd.configurar.md +34 -1
  31. package/commands/sdd.constitucion.md +198 -23
  32. package/commands/sdd.construir.md +210 -0
  33. package/commands/sdd.crear-mcp.md +2 -0
  34. package/commands/sdd.defect-report.md +134 -0
  35. package/commands/sdd.descubrir.md +19 -0
  36. package/commands/sdd.dise/303/261ar.md +188 -0
  37. package/commands/sdd.estado.md +120 -3
  38. package/commands/sdd.exportar.md +344 -0
  39. package/commands/sdd.implementar.md +272 -52
  40. package/commands/sdd.interpretar.md +239 -0
  41. package/commands/sdd.md +93 -4
  42. package/commands/sdd.optimizar-memoria.md +47 -0
  43. package/commands/sdd.optimizar.md +164 -0
  44. package/commands/sdd.planificar.md +64 -0
  45. package/commands/sdd.retro.md +74 -0
  46. package/commands/sdd.verificar.md +81 -0
  47. package/configuracion-ejemplo/.claude/CLAUDE.md +106 -0
  48. package/configuracion-ejemplo/sdd.config.yaml +10 -0
  49. package/craft/accessibility-baseline.md +216 -0
  50. package/craft/anti-ai-slop.md +158 -0
  51. package/craft/color.md +160 -0
  52. package/craft/typography.md +121 -0
  53. package/design-systems/bold-brutalist/DESIGN.md +239 -0
  54. package/design-systems/editorial-minimal/DESIGN.md +205 -0
  55. package/design-systems/neutral-modern/DESIGN.md +227 -0
  56. package/design-systems/vibrant-consumer/DESIGN.md +257 -0
  57. package/design-systems/warm-editorial/DESIGN.md +221 -0
  58. package/docs/AGENTES.md +4 -1
  59. package/docs/CASO-COMPLETO.md +206 -0
  60. package/docs/EJEMPLOS.md +61 -185
  61. package/docs/FABRICA.md +163 -115
  62. package/docs/INICIO-RAPIDO.md +27 -79
  63. package/docs/MEMORIA-Y-OBSERVABILIDAD.md +239 -0
  64. package/docs/MODELOS.md +3 -0
  65. package/docs/QUE-PASA-SI-FALLA.md +404 -0
  66. package/docs/README.md +43 -0
  67. package/docs/RELACION-CON-CLAUDE-CODE.md +38 -0
  68. package/docs/SEGURIDAD-PARA-NOTECNICOS.md +280 -0
  69. package/package.json +15 -10
  70. package/plantillas/job-story-mejorar-prompt.md +107 -0
  71. package/presets/enterprise.yaml +6 -0
  72. package/presets/lean.yaml +4 -0
  73. package/presets/startup.yaml +6 -0
  74. package/skills/adr-indexer/SKILL.md +181 -0
  75. package/skills/cache-audit/SKILL.md +163 -0
  76. package/skills/critica-diseno/SKILL.md +193 -0
  77. package/skills/descubrir-idea/SKILL.md +133 -0
  78. package/skills/effort-router/SKILL.md +128 -0
  79. package/skills/elegir-direccion/SKILL.md +184 -0
  80. package/skills/github-connect/IMPLEMENTATION-CHECKLIST.md +297 -0
  81. package/skills/github-connect/INDEX.md +223 -0
  82. package/skills/github-connect/INTEGRATION.md +361 -0
  83. package/skills/github-connect/QUICK-START.md +168 -0
  84. package/skills/github-connect/README.md +414 -0
  85. package/skills/github-connect/RESUMEN_IMPLEMENTACION.txt +374 -0
  86. package/skills/github-connect/SKILL.md +343 -0
  87. package/skills/github-connect/STRUCTURE.txt +252 -0
  88. package/skills/github-connect/example-config.yaml +41 -0
  89. package/skills/github-connect/github-connect.sh +419 -0
  90. package/skills/interpretar-idea/SKILL.md +254 -0
  91. package/skills/mejorar-prompt/SKILL.md +237 -0
  92. package/skills/memory-compactor/SKILL.md +68 -0
  93. package/skills/modo-guiado/SKILL.md +12 -2
  94. package/skills/mutation-detector/SKILL.md +134 -0
  95. package/skills/observabilidad-consumo/SKILL.md +164 -0
  96. package/skills/token-budget/SKILL.md +177 -0
  97. package/skills/vercel-deploy/00-START-HERE.txt +364 -0
  98. package/skills/vercel-deploy/CHECKLIST.md +205 -0
  99. package/skills/vercel-deploy/EXEC-SUMMARY.txt +322 -0
  100. package/skills/vercel-deploy/FLOW.txt +334 -0
  101. package/skills/vercel-deploy/INDEX.md +276 -0
  102. package/skills/vercel-deploy/INTEGRATION.md +328 -0
  103. package/skills/vercel-deploy/MANIFEST.md +310 -0
  104. package/skills/vercel-deploy/README.md +65 -0
  105. package/skills/vercel-deploy/SKILL.md +356 -0
  106. package/skills/vercel-deploy/deploy.sh +298 -0
  107. package/skills/vercel-deploy/estado.json.example +205 -0
  108. package/skills/vercel-deploy/skill.yaml +323 -0
  109. package/skills/vercel-deploy/vercel-deploy.sh +216 -0
  110. package/skills/wireframe-mvp/SKILL.md +157 -0
  111. package/docs/EJEMPLO-PRACTICA.md +0 -383
  112. package/mcp-figma/README.md +0 -158
  113. package/mcp-figma/package.json +0 -7
  114. package/mcp-figma/src/component-generator.js +0 -162
  115. package/mcp-figma/src/design-system-analyzer.js +0 -247
  116. package/mcp-figma/src/figma-client.js +0 -75
  117. package/mcp-figma/src/index.js +0 -114
  118. package/mcp-figma/src/mcp.js +0 -97
  119. package/mcp-figma/src/style-mapper.js +0 -85
  120. /package/skills/{compresion-tokens.md → compresion-tokens/SKILL.md} +0 -0
  121. /package/skills/{constitucion-constraint.md → constitucion-constraint/SKILL.md} +0 -0
  122. /package/skills/{deteccion-stack.md → deteccion-stack/SKILL.md} +0 -0
  123. /package/skills/{enrutador-agentes.md → enrutador-agentes/SKILL.md} +0 -0
  124. /package/skills/{gestion-estado.md → gestion-estado/SKILL.md} +0 -0
  125. /package/skills/{indexador.md → indexador/SKILL.md} +0 -0
  126. /package/skills/{validacion-spec.md → validacion-spec/SKILL.md} +0 -0
  127. /package/skills/{verificador-implementacion.md → verificador-implementacion/SKILL.md} +0 -0
@@ -1,51 +1,51 @@
1
1
  {
2
- "permissions": {
3
- "deny": [
4
- "Bash(git push --force*)",
5
- "Bash(git push -f*)",
6
- "Bash(git push* :*)",
7
- "Bash(git reset --hard*)",
8
- "Bash(git clean -f*)",
9
- "Bash(git clean -xfd*)",
10
- "Bash(rm -rf /*)",
11
- "Bash(rm -rf ~*)",
12
- "Bash(rm -rf .*)",
13
- "Bash(cat .env)",
14
- "Bash(cat .env.*)",
15
- "Bash(type .env*)",
16
- "Bash(DROP DATABASE*)",
17
- "Bash(DROP SCHEMA*)",
18
- "Bash(terraform destroy*)",
19
- "Bash(kubectl delete namespace*)",
20
- "Bash(npm publish*)",
21
- "Bash(cargo publish*)",
22
- "PowerShell(Get-Content .env*)",
23
- "PowerShell(Remove-Item -Recurse -Force C:\\*)",
24
- "PowerShell(Remove-Item -Recurse -Force /*)"
25
- ]
26
- },
27
2
  "hooks": {
28
3
  "PreToolUse": [
29
4
  {
30
- "matcher": "Bash|PowerShell",
5
+ "matcher": "",
31
6
  "hooks": [
32
7
  {
33
8
  "type": "command",
34
- "command": "node .claude/hooks/pre-tool-guard.js"
9
+ "command": "node claude-hooks/pre-tool-guard.js"
35
10
  }
36
11
  ]
37
12
  }
38
13
  ],
39
14
  "PostToolUse": [
40
15
  {
41
- "matcher": "Write|Edit|MultiEdit",
16
+ "matcher": "Write|Edit",
42
17
  "hooks": [
43
18
  {
44
19
  "type": "command",
45
- "command": "node .claude/hooks/post-write-conventions.js"
20
+ "command": "node claude-hooks/agent-memory.js"
46
21
  }
47
22
  ]
48
23
  }
49
24
  ]
25
+ },
26
+ "permissions": {
27
+ "allow": [
28
+ "PowerShell(New-Item -ItemType Directory -Path \"C:\\\\Users\\\\usuario\\\\sdd-lite\\\\sdd-lite\\\\tests\" -Force)",
29
+ "Bash(node --test tests/commands.test.js)",
30
+ "Bash(node --test --reporter=spec tests/commands.test.js tests/agents.test.js tests/presets.test.js tests/consistency.test.js)",
31
+ "Bash(node --test tests/commands.test.js tests/agents.test.js tests/presets.test.js tests/consistency.test.js)",
32
+ "WebSearch",
33
+ "WebFetch(domain:arxiv.org)",
34
+ "Read(//c/Users/usuario/.claude/**)",
35
+ "Bash(cp \"C:\\\\Users\\\\usuario\\\\.claude\\\\hooks\\\\pre-tool-guard.js\" \"c:\\\\Users\\\\usuario\\\\sdd-lite\\\\sdd-lite\\\\claude-hooks\\\\pre-tool-guard.js\")",
36
+ "Bash(cp \"C:\\\\Users\\\\usuario\\\\.claude\\\\hooks\\\\post-write-conventions.js\" \"c:\\\\Users\\\\usuario\\\\sdd-lite\\\\sdd-lite\\\\claude-hooks\\\\post-write-conventions.js\")",
37
+ "Bash(node -e \"JSON.parse\\(require\\('fs'\\).readFileSync\\('C:\\\\\\\\Users\\\\\\\\usuario\\\\\\\\.claude\\\\\\\\settings.json','utf8'\\)\\); console.log\\('JSON válido'\\)\")",
38
+ "Bash(node -e \"const fs=require\\('fs'\\); JSON.parse\\(fs.readFileSync\\(process.argv[1],'utf8'\\)\\); console.log\\('OK'\\)\" \"C:/Users/usuario/.claude/settings.json\")",
39
+ "Bash(node -e \"const fs=require\\('fs'\\); JSON.parse\\(fs.readFileSync\\(process.argv[1],'utf8'\\)\\); console.log\\('OK'\\)\" \"C:/Users/usuario/sdd-lite/sdd-lite/.claude/settings.json\")",
40
+ "Bash(node --test tests/)",
41
+ "Bash(git add *)",
42
+ "Bash(git commit *)",
43
+ "PowerShell(Get-ChildItem -Path \"C:\\\\Users\\\\usuario\\\\sdd-lite\" -Recurse -Name | Where-Object { $_ -notmatch \"\\\\.git\" } | Sort-Object)",
44
+ "Bash(git rm *)",
45
+ "Bash(rm .gitmodules)"
46
+ ],
47
+ "additionalDirectories": [
48
+ "C:\\Users\\usuario\\.claude"
49
+ ]
50
50
  }
51
51
  }
@@ -0,0 +1,10 @@
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "WebFetch(domain:claude.com)",
5
+ "Bash(npm install *)",
6
+ "Bash(node src/index.js)"
7
+ ],
8
+ "additionalDirectories": []
9
+ }
10
+ }
@@ -2,29 +2,32 @@
2
2
  "name": "sdd-es-marketplace",
3
3
  "owner": {
4
4
  "name": "SDD-ES",
5
- "url": "https://github.com/tu-usuario/sdd-es"
5
+ "url": "https://github.com/carlos060798/FORGE"
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Marketplace de SDD-ES — Spec-Driven Development en español para Claude Code.",
9
- "version": "2.0.0"
9
+ "version": "2.5.0"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "sdd-es",
14
14
  "source": "./",
15
- "description": "Fábrica de software agnóstica al stack: de la idea al despliegue, con 12 agentes especializados, mapas y compresión de tokens.",
16
- "version": "2.0.0",
15
+ "description": "Fábrica de software agnóstica al stack: de la idea al despliegue. 14 agentes especializados, mapas estáticos, compresión de tokens, routing inteligente de modelos (Haiku/Sonnet/Opus), memory persistente entre sesiones, observabilidad integrada, técnicas avanzadas de optimización (v2.5.0). Pipeline completo: Idea → IR → Spec → Plan → Tareas → Implementación → Verificación → Deploy.",
16
+ "version": "2.5.0",
17
17
  "author": {
18
- "name": "SDD-ES"
18
+ "name": "Danilo Angarita",
19
+ "email": "daniloangaritagarcia@gmail.com"
19
20
  },
20
- "homepage": "https://github.com/tu-usuario/sdd-es",
21
+ "homepage": "https://github.com/carlos060798/FORGE",
21
22
  "license": "MIT",
22
23
  "keywords": [
23
24
  "spec-driven-development",
24
25
  "español",
25
26
  "agentes",
26
27
  "mcp",
27
- "agnóstico-al-stack"
28
+ "agnóstico-al-stack",
29
+ "tokens-optimization",
30
+ "memory-persistence"
28
31
  ]
29
32
  }
30
33
  ]
@@ -1,17 +1,48 @@
1
1
  {
2
+ "$schema": "https://claude.ai/schemas/plugin/v1.json",
2
3
  "name": "sdd-es",
3
- "version": "2.0.0",
4
- "description": "Spec-Driven Development en español. Fábrica de software agnóstica al stack: de la idea al despliegue. Con mapas y compresión de tokens.",
5
- "homepage": "https://github.com/carlos060798/sdd-lite",
6
- "repository": "https://github.com/carlos060798/sdd-lite",
4
+ "version": "2.5.0",
5
+ "description": "Spec-Driven Development en español. Fábrica de software agnóstica al stack: de la idea al despliegue. Con 14 agentes especializados, mapas, compresión de tokens y técnicas avanzadas de optimización (v2.5.0).",
6
+ "homepage": "https://github.com/carlos060798/FORGE",
7
+ "repository": "https://github.com/carlos060798/FORGE",
7
8
  "license": "MIT",
8
- "instructions": "El usuario corre comandos /sdd.* para guiar el flujo SDD-ES. El plugin orquesta 12 agentes especializados.",
9
+ "author": {
10
+ "name": "Danilo Angarita",
11
+ "email": "daniloangaritagarcia@gmail.com",
12
+ "url": "https://github.com/carlos060798/FORGE"
13
+ },
14
+
15
+ "userConfig": {
16
+ "modelo_principal": {
17
+ "type": "select",
18
+ "label": "Modelo para agentes de decisión (arquitecto, crítico, seguridad, asesor-datos, revisor)",
19
+ "options": ["claude-opus-4-8", "claude-sonnet-4-6", "claude-haiku-4-5-20251001"],
20
+ "default": "claude-opus-4-8"
21
+ },
22
+ "perfil_default": {
23
+ "type": "select",
24
+ "label": "Perfil de interacción por defecto",
25
+ "options": ["experto", "guiado"],
26
+ "default": "experto"
27
+ },
28
+ "verbosidad": {
29
+ "type": "select",
30
+ "label": "Nivel de detalle en reportes de implementación",
31
+ "options": ["minimo", "normal", "detallado"],
32
+ "default": "normal"
33
+ }
34
+ },
9
35
 
10
36
  "commands": [
11
37
  "sdd",
12
38
  "sdd.constitucion",
13
39
  "sdd.configurar",
14
40
  "sdd.descubrir",
41
+ "sdd.interpretar",
42
+ "sdd.diseñar",
43
+ "sdd.construir",
44
+ "sdd.exportar",
45
+ "sdd.compliance",
15
46
  "sdd.especificar",
16
47
  "sdd.importar",
17
48
  "sdd.aclarar",
@@ -31,6 +62,10 @@
31
62
  "sdd.estado",
32
63
  "sdd.mapear",
33
64
  "sdd.comprimir",
65
+ "sdd.optimizar",
66
+ "sdd.optimizar-memoria",
67
+ "sdd.adr",
68
+ "sdd.defect-report",
34
69
  "sdd.ayuda",
35
70
  "sdd.crear-mcp",
36
71
  "sdd.crear-app"
@@ -48,7 +83,9 @@
48
83
  "critico",
49
84
  "seguridad",
50
85
  "investigador",
51
- "documentador"
86
+ "documentador",
87
+ "product-designer",
88
+ "architecture-designer"
52
89
  ],
53
90
 
54
91
  "skills": [
@@ -61,37 +98,22 @@
61
98
  "compresion-tokens",
62
99
  "constitucion-constraint",
63
100
  "modo-guiado",
64
- "orquestacion-ptc"
101
+ "orquestacion-ptc",
102
+ "descubrir-idea",
103
+ "interpretar-idea",
104
+ "elegir-direccion",
105
+ "wireframe-mvp",
106
+ "critica-diseno",
107
+ "github-connect",
108
+ "vercel-deploy",
109
+ "observabilidad-consumo",
110
+ "effort-router",
111
+ "memory-compactor",
112
+ "cache-audit",
113
+ "token-budget",
114
+ "adr-indexer",
115
+ "mutation-detector"
65
116
  ],
66
117
 
67
- "mcpServers": {
68
- "sdd-figma": {
69
- "description": "Integración con Figma para el agente desarrollador-frontend. Analiza el sistema de diseño local, trae componentes de Figma y genera código adaptado.",
70
- "command": "node",
71
- "args": ["{PLUGIN_DIR}/mcp-figma/dist/index.js"],
72
- "requiredBy": ["desarrollador-frontend"],
73
- "activatesOn": ["ui", "componente", "interfaz", "diseño", "vista", "figma", "layout"]
74
- },
75
- "navegador": {
76
- "description": "Navegador real (Playwright) para QA E2E del comando /sdd.qa: ejecuta casos generados desde los Criterios de Aceptación en un navegador de verdad. Se usa un MCP existente, no se mantiene uno propio.",
77
- "command": "npx",
78
- "args": ["-y", "@playwright/mcp@latest"],
79
- "requiredBy": ["tester"],
80
- "activatesOn": ["qa", "navegador", "e2e", "prueba", "probar", "playwright"],
81
- "opcional": true
82
- }
83
- },
84
-
85
- "features": [
86
- "Spec-Driven Development",
87
- "12 agentes especializados",
88
- "Integración Figma → código adaptado al design system local",
89
- "Mapas de proyecto (ahorro de tokens)",
90
- "Compresión caveman-like",
91
- "Recomendaciones de modelos",
92
- "Hooks personalizables",
93
- "Instalador multiplataforma (npx sdd-es)",
94
- "Totalmente editable (Markdown plano)",
95
- "100% agnóstico al stack"
96
- ]
118
+ "mcpServers": "./.mcp.json"
97
119
  }
package/.gitignore ADDED
@@ -0,0 +1,20 @@
1
+ # MCP — dependencias y compilado (no se versionan)
2
+ sdd-lite/mcp-figma/node_modules/
3
+ sdd-lite/mcp-figma/dist/
4
+
5
+ # Estado local del proyecto (generado en cada repo donde se instala SDD-ES)
6
+ .sdd/
7
+
8
+ # Variables de entorno
9
+ .env
10
+ .env.local
11
+
12
+ # Reportes internos de desarrollo (borradores, no documentación de usuario)
13
+ # Se mantienen en disco pero no se publican en el repo.
14
+ REPORTE-ESTADO-PROBLEMAS.md
15
+ RESUMEN-v2.6.0-MVP-COMPLETADO.md
16
+ SPRINT-1-COMPLETADO.md
17
+ CHANGELOG-v2.6.0.md
18
+
19
+ # Archivos de contenido temporal del sitio de docs (se ensamblan en assets/data.js)
20
+ docs-site/_content-*.js
package/.mcp.json ADDED
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "playwright": {
4
+ "command": "npx",
5
+ "args": ["-y", "@playwright/mcp@latest"]
6
+ }
7
+ }
8
+ }
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Danilo Angarita
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,12 +1,16 @@
1
1
  # SDD-ES
2
2
 
3
- > **Fábrica de software en español para Claude Code**
4
- > De la idea al despliegue, agnóstica al stack, con estándares de ingeniería altos.
3
+ > **Una capa de opinión en español sobre las primitivas oficiales de Claude Code**
4
+ > Skills, subagentes, hooks y slash commands orquestados en un flujo idea→deploy, agnóstico al stack.
5
+ >
6
+ > **Para quién:** no-técnicos que quieren construir sin programar (modo guiado) y developers que quieren estándares de ingeniería altos sin boilerplate (modo experto).
5
7
 
6
8
  [![npm](https://img.shields.io/npm/v/sdd-es)](https://www.npmjs.com/package/sdd-es)
7
9
  [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
8
10
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
9
11
 
12
+ 📚 **[Documentación completa →](docs-site/)** · sitio navegable bilingüe (ES/EN) con buscador, para no-técnicos y developers. También disponible como Markdown en [`docs/`](docs/README.md).
13
+
10
14
  ---
11
15
 
12
16
  ## Instalación
@@ -46,40 +50,70 @@ bash instalar.sh --global # global
46
50
 
47
51
  ---
48
52
 
49
- ## Inicio rápido
53
+ ## 🔐 Seguridad (IMPORTANTE)
54
+
55
+ SDD-ES pide **tokens de GitHub y Vercel** para automatizar GitHub + deployment.
56
+
57
+ **Cómo SDD-ES cuida tu seguridad:**
58
+
59
+ - ✅ Tokens se usan en memoria, NUNCA se guardan en archivos
60
+ - ✅ `.gitignore` automático protege archivos sensibles
61
+ - ✅ Tokens se validan inmediatamente
62
+ - ✅ Instrucciones para revocar tokens si cometes un error
63
+
64
+ **Lee la guía de seguridad:** [docs/SEGURIDAD-PARA-NOTECNICOS.md](docs/SEGURIDAD-PARA-NOTECNICOS.md)
65
+
66
+ **IMPORTANTE:** No compartas tokens, no los guardes en archivos, no los commitess a GitHub.
67
+
68
+ ---
69
+
70
+ ## ¿Eres programador o no?
71
+
72
+ ### 👨‍💻 Para programadores (modo experto)
50
73
 
51
74
  Abre Claude Code en tu proyecto e inicia con lenguaje natural:
52
75
 
53
76
  ```
54
- /sdd quiero crear una app de lista de tareas
77
+ /sdd quiero crear una API REST con autenticación
55
78
  ```
56
79
 
57
- El hub entiende tu intención y te guía al siguiente paso. Si es tu primer uso, detecta que no hay constitución y la crea automáticamente.
58
-
59
- **Flujo completo en comandos:**
80
+ El hub entiende tu intención y te guía al siguiente paso. Flujo técnico completo:
60
81
 
61
82
  ```
62
- /sdd.constitucion ← principios del proyecto (solo la primera vez)
63
- /sdd.especificar [idea] ← captura qué quieres construir
64
- /sdd.planificar ← plan técnico
65
- /sdd.planificar aprobar ← confirmar el plan
66
- /sdd.tareas ← desglose en tareas atómicas
67
- /sdd.implementar agentes especializados lo construyen
68
- /sdd.qa QA en navegador real
69
- /sdd.verificar verificación final contra spec
70
- /sdd.desplegarpublica con health check
83
+ /sdd.constitucion ← principios, stack, restricciones (solo primera vez)
84
+ /sdd.especificar [idea] ← captura requirements con criterios de aceptación
85
+ /sdd.planificar ← plan técnico con arquitectura
86
+ /sdd.planificar aprobar ← apruebas el plan explícitamente
87
+ /sdd.tareas ← desglosa en tareas atómicas con agente asignado
88
+ /sdd.analizar auditoría cruzada de consistencia
89
+ /sdd.implementar agentes especializados lo construyen en paralelo
90
+ /sdd.qa QA en navegador real (Playwright)
91
+ /sdd.verificarverificación final contra spec original
92
+ /sdd.desplegar ← gate de calidad → health check → publica
71
93
  ```
72
94
 
73
- ### Para no-programadores
95
+ **Docs técnicos:** [docs/FLUJO.md](docs/FLUJO.md) (comandos completos), [docs/INICIO-RAPIDO.md](docs/INICIO-RAPIDO.md) (ejemplos).
96
+
97
+ ---
98
+
99
+ ### 👤 Para no-programadores (modo guiado)
74
100
 
75
- SDD-ES tiene un **perfil guiado** que detecta o pregunta si eres nuevo en programación. En ese modo:
101
+ **Buenas noticias:** No necesitas saber programar. SDD-ES elige la tecnología automáticamente y te guía con lenguaje simple.
76
102
 
77
- - No ves nombres de comandos ni jerga técnica
78
- - El sistema elige el stack automáticamente
79
- - Confirmas con "sí" entre cada paso
80
- - Claude publica tu app en internet al final
103
+ Flujo simplificado (sin jerga técnica):
81
104
 
82
- Ver recorrido completo en [docs/FABRICA.md](docs/FABRICA.md).
105
+ 1. **Describe tu idea:** "Una tienda donde vendo artesanías" (como hablarías con un amigo)
106
+ 2. **SDD-ES entiende:** Crea un plan que tú apruebas
107
+ 3. **Se construye:** 14 especialistas trabajan en paralelo (sin que hagas nada)
108
+ 4. **Se verifica:** Pruebas automáticas comprueban que todo funciona
109
+ 5. **Está en internet:** Tu app está viva en 15-20 minutos
110
+
111
+ **No ves:** comandos, jerga técnica, código, decisiones técnicas.
112
+ **Confirmas:** cada paso importante con "sí" o "cambio esto".
113
+
114
+ **Ejemplo completo:** Lee [docs/FABRICA.md](docs/FABRICA.md) — la historia real de Martina que pasó de idea a app en vivo sin saber programar.
115
+
116
+ **Resumen sin jerga:** [docs/RESUMEN-EJECUTIVO-NO-TECNICOS.md](docs/RESUMEN-EJECUTIVO-NO-TECNICOS.md)
83
117
 
84
118
  ### Crear una app desde cero
85
119
 
@@ -95,7 +129,7 @@ Ver recorrido completo en [docs/FABRICA.md](docs/FABRICA.md).
95
129
 
96
130
  ---
97
131
 
98
- ## Los 26 comandos
132
+ ## Los 35 comandos
99
133
 
100
134
  ### Inicialización
101
135
 
@@ -160,7 +194,7 @@ Ver recorrido completo en [docs/FABRICA.md](docs/FABRICA.md).
160
194
 
161
195
  ---
162
196
 
163
- ## Los 12 agentes especializados
197
+ ## Los 14 agentes especializados
164
198
 
165
199
  | Agente | Rol | Modelo recomendado |
166
200
  |--------|-----|--------------------|
@@ -176,12 +210,14 @@ Ver recorrido completo en [docs/FABRICA.md](docs/FABRICA.md).
176
210
  | `seguridad` | Auditoría de vulnerabilidades | opus |
177
211
  | `investigador` | Stack existente, deuda técnica, patrones | sonnet |
178
212
  | `documentador` | Documentación técnica útil | sonnet |
213
+ | `product-designer` | Wireframes, UX, validación de diseño | opus |
214
+ | `architecture-designer` | Blueprints técnicos, diagramas de arquitectura | sonnet |
179
215
 
180
216
  Cambia modelos y activa/desactiva agentes con `/sdd.configurar` o editando `.sdd/sdd.config.yaml`.
181
217
 
182
218
  ---
183
219
 
184
- ## Las 10 skills
220
+ ## Las 25 skills
185
221
 
186
222
  | Skill | Formato | Qué hace |
187
223
  |-------|---------|----------|
@@ -194,7 +230,7 @@ Cambia modelos y activa/desactiva agentes con `/sdd.configurar` o editando `.sdd
194
230
  | `compresion-tokens` | `.md` | Reglas de compresión estilo caveman para Markdown |
195
231
  | `constitucion-constraint` | `.md` | Aplica DEBE/NUNCA de la constitución como hard constraint |
196
232
  | `modo-guiado` | `📁 SKILL.md` | Conduce el flujo sin jerga para no-programadores |
197
- | `orquestacion-ptc` | `📁 SKILL.md` | Patrón PTC: despacha agentes en paralelo, −85% tokens |
233
+ | `orquestacion-ptc` | `📁 SKILL.md` | Patrón PTC: despacha agentes en paralelo, reduce tokens de orquestación |
198
234
 
199
235
  ---
200
236
 
@@ -212,7 +248,7 @@ Cambia modelos y activa/desactiva agentes con `/sdd.configurar` o editando `.sdd
212
248
  `/sdd.qa` genera casos E2E desde cada Criterio de Aceptación y los ejecuta en un navegador real vía Playwright MCP — no solo unitarios.
213
249
 
214
250
  ### Orquestación PTC
215
- `/sdd.implementar` y `/sdd.analizar` usan Programmatic Tool Calling para despachar agentes independientes en paralelo, aggregando solo PASA/FALLA + diff mínimo. Ahorro esperado: −70 a −85% de tokens en orquestación multi-agente.
251
+ `/sdd.implementar` y `/sdd.analizar` usan Programmatic Tool Calling para despachar agentes independientes en paralelo, agregando solo PASA/FALLA + diff mínimo. El patrón reduce el contexto de orquestación multi-agente al enviar solo resúmenes de resultado en vez del output completo de cada agente.
216
252
 
217
253
  ### Sprint estructurado
218
254
 
@@ -235,9 +271,9 @@ Cada flecha tiene un control. No se construye sin spec; no se publica sin tests
235
271
  ```
236
272
  tu-proyecto/
237
273
  ├── .claude/
238
- │ ├── commands/sdd.*.md ← 26 comandos
239
- │ ├── agents/*.md ← 12 agentes
240
- │ ├── skills/ ← 10 skills (flat .md + carpetas SKILL.md)
274
+ │ ├── commands/sdd.*.md ← 35 comandos
275
+ │ ├── agents/*.md ← 14 agentes
276
+ │ ├── skills/ ← 25 skills (flat .md + carpetas SKILL.md)
241
277
  │ └── hooks/ ← hooks de seguridad pre-instalados
242
278
  └── .sdd/
243
279
  ├── sdd.config.yaml ← configuración personalizable
@@ -277,23 +313,24 @@ Todo el plugin es Markdown plano. Personaliza editando archivos:
277
313
 
278
314
  ## MCP integrado
279
315
 
280
- SDD-ES declara dos servidores MCP en `plugin.json`:
316
+ SDD-ES declara un servidor MCP en `plugin.json`:
281
317
 
282
318
  | MCP | Cuándo se activa | Para qué |
283
319
  |-----|-----------------|----------|
284
- | `sdd-figma` | Tareas de UI con `figma_file_key` configurado | Extrae diseños de Figma y genera código adaptado al design system local |
285
320
  | `navegador` (Playwright) | `/sdd.qa`, palabras clave `e2e`, `prueba` | QA en navegador real sin mantener un navegador propio |
286
321
 
287
322
  ---
288
323
 
289
- ## Ahorro de tokens
324
+ ## Reducción de contexto
325
+
326
+ Las siguientes técnicas reducen el volumen de artefactos que Claude lee por sesión. Los números son estimaciones de bytes de artefactos generados, **no tokens de facturación medidos**.
290
327
 
291
- | Técnica | Ahorro estimado |
292
- |---------|----------------|
293
- | Mapas estáticos (`/sdd.mapear`) | −50 a −65k tokens por sesión |
294
- | Compresión caveman (`/sdd.comprimir`) | −60 a −70% en archivos de memoria |
295
- | RAG en 3 capas (estado.json → spec activa → constitución) | Carga solo lo necesario por fase |
296
- | PTC paralelo (`orquestacion-ptc`) | −70 a −85% en orquestación multi-agente |
328
+ | Técnica | Reducción de artefactos |
329
+ |---------|------------------------|
330
+ | Mapas estáticos (`/sdd.mapear`) | Reemplaza indexación completa en cada turno por un índice precalculado |
331
+ | Compresión caveman (`/sdd.comprimir`) | Reduce tamaño de archivos de memoria eliminando redundancias |
332
+ | RAG en 3 capas (estado.json → spec activa → constitución) | Carga solo lo necesario por fase en lugar del proyecto completo |
333
+ | PTC paralelo (`orquestacion-ptc`) | Agrega solo PASA/FALLA por agente en vez de output completo |
297
334
 
298
335
  ---
299
336