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.
- package/.claude/settings.json +29 -29
- package/.claude/settings.local.json +10 -0
- package/.claude-plugin/marketplace.json +10 -7
- package/.claude-plugin/plugin.json +59 -37
- package/.gitignore +20 -0
- package/.mcp.json +8 -0
- package/LICENSE +21 -0
- package/README.md +77 -40
- package/agents/architecture-designer.md +211 -0
- package/agents/arquitecto.md +16 -1
- package/agents/asesor-datos.md +15 -1
- package/agents/critico.md +37 -1
- package/agents/desarrollador-backend.md +3 -1
- package/agents/desarrollador-frontend.md +11 -16
- package/agents/disenador-api.md +13 -1
- package/agents/documentador.md +3 -1
- package/agents/investigador.md +3 -1
- package/agents/operaciones.md +3 -1
- package/agents/product-designer.md +268 -0
- package/agents/revisor.md +25 -1
- package/agents/seguridad.md +5 -1
- package/agents/tester.md +3 -1
- package/claude-hooks/agent-memory.js +288 -0
- package/claude-hooks/pre-tool-guard.js +61 -9
- package/cli/index.js +1 -2
- package/commands/sdd.adr.md +196 -0
- package/commands/sdd.analizar.md +23 -2
- package/commands/sdd.ayuda.md +13 -0
- package/commands/sdd.compliance.md +521 -0
- package/commands/sdd.configurar.md +34 -1
- package/commands/sdd.constitucion.md +198 -23
- package/commands/sdd.construir.md +210 -0
- package/commands/sdd.crear-mcp.md +2 -0
- package/commands/sdd.defect-report.md +134 -0
- package/commands/sdd.descubrir.md +19 -0
- package/commands/sdd.dise/303/261ar.md +188 -0
- package/commands/sdd.estado.md +120 -3
- package/commands/sdd.exportar.md +344 -0
- package/commands/sdd.implementar.md +272 -52
- package/commands/sdd.interpretar.md +239 -0
- package/commands/sdd.md +93 -4
- package/commands/sdd.optimizar-memoria.md +47 -0
- package/commands/sdd.optimizar.md +164 -0
- package/commands/sdd.planificar.md +64 -0
- package/commands/sdd.retro.md +74 -0
- package/commands/sdd.verificar.md +81 -0
- package/configuracion-ejemplo/.claude/CLAUDE.md +106 -0
- package/configuracion-ejemplo/sdd.config.yaml +10 -0
- package/craft/accessibility-baseline.md +216 -0
- package/craft/anti-ai-slop.md +158 -0
- package/craft/color.md +160 -0
- package/craft/typography.md +121 -0
- package/design-systems/bold-brutalist/DESIGN.md +239 -0
- package/design-systems/editorial-minimal/DESIGN.md +205 -0
- package/design-systems/neutral-modern/DESIGN.md +227 -0
- package/design-systems/vibrant-consumer/DESIGN.md +257 -0
- package/design-systems/warm-editorial/DESIGN.md +221 -0
- package/docs/AGENTES.md +4 -1
- package/docs/CASO-COMPLETO.md +206 -0
- package/docs/EJEMPLOS.md +61 -185
- package/docs/FABRICA.md +163 -115
- package/docs/INICIO-RAPIDO.md +27 -79
- package/docs/MEMORIA-Y-OBSERVABILIDAD.md +239 -0
- package/docs/MODELOS.md +3 -0
- package/docs/QUE-PASA-SI-FALLA.md +404 -0
- package/docs/README.md +43 -0
- package/docs/RELACION-CON-CLAUDE-CODE.md +38 -0
- package/docs/SEGURIDAD-PARA-NOTECNICOS.md +280 -0
- package/package.json +15 -10
- package/plantillas/job-story-mejorar-prompt.md +107 -0
- package/presets/enterprise.yaml +6 -0
- package/presets/lean.yaml +4 -0
- package/presets/startup.yaml +6 -0
- package/skills/adr-indexer/SKILL.md +181 -0
- package/skills/cache-audit/SKILL.md +163 -0
- package/skills/critica-diseno/SKILL.md +193 -0
- package/skills/descubrir-idea/SKILL.md +133 -0
- package/skills/effort-router/SKILL.md +128 -0
- package/skills/elegir-direccion/SKILL.md +184 -0
- package/skills/github-connect/IMPLEMENTATION-CHECKLIST.md +297 -0
- package/skills/github-connect/INDEX.md +223 -0
- package/skills/github-connect/INTEGRATION.md +361 -0
- package/skills/github-connect/QUICK-START.md +168 -0
- package/skills/github-connect/README.md +414 -0
- package/skills/github-connect/RESUMEN_IMPLEMENTACION.txt +374 -0
- package/skills/github-connect/SKILL.md +343 -0
- package/skills/github-connect/STRUCTURE.txt +252 -0
- package/skills/github-connect/example-config.yaml +41 -0
- package/skills/github-connect/github-connect.sh +419 -0
- package/skills/interpretar-idea/SKILL.md +254 -0
- package/skills/mejorar-prompt/SKILL.md +237 -0
- package/skills/memory-compactor/SKILL.md +68 -0
- package/skills/modo-guiado/SKILL.md +12 -2
- package/skills/mutation-detector/SKILL.md +134 -0
- package/skills/observabilidad-consumo/SKILL.md +164 -0
- package/skills/token-budget/SKILL.md +177 -0
- package/skills/vercel-deploy/00-START-HERE.txt +364 -0
- package/skills/vercel-deploy/CHECKLIST.md +205 -0
- package/skills/vercel-deploy/EXEC-SUMMARY.txt +322 -0
- package/skills/vercel-deploy/FLOW.txt +334 -0
- package/skills/vercel-deploy/INDEX.md +276 -0
- package/skills/vercel-deploy/INTEGRATION.md +328 -0
- package/skills/vercel-deploy/MANIFEST.md +310 -0
- package/skills/vercel-deploy/README.md +65 -0
- package/skills/vercel-deploy/SKILL.md +356 -0
- package/skills/vercel-deploy/deploy.sh +298 -0
- package/skills/vercel-deploy/estado.json.example +205 -0
- package/skills/vercel-deploy/skill.yaml +323 -0
- package/skills/vercel-deploy/vercel-deploy.sh +216 -0
- package/skills/wireframe-mvp/SKILL.md +157 -0
- package/docs/EJEMPLO-PRACTICA.md +0 -383
- package/mcp-figma/README.md +0 -158
- package/mcp-figma/package.json +0 -7
- package/mcp-figma/src/component-generator.js +0 -162
- package/mcp-figma/src/design-system-analyzer.js +0 -247
- package/mcp-figma/src/figma-client.js +0 -75
- package/mcp-figma/src/index.js +0 -114
- package/mcp-figma/src/mcp.js +0 -97
- package/mcp-figma/src/style-mapper.js +0 -85
- /package/skills/{compresion-tokens.md → compresion-tokens/SKILL.md} +0 -0
- /package/skills/{constitucion-constraint.md → constitucion-constraint/SKILL.md} +0 -0
- /package/skills/{deteccion-stack.md → deteccion-stack/SKILL.md} +0 -0
- /package/skills/{enrutador-agentes.md → enrutador-agentes/SKILL.md} +0 -0
- /package/skills/{gestion-estado.md → gestion-estado/SKILL.md} +0 -0
- /package/skills/{indexador.md → indexador/SKILL.md} +0 -0
- /package/skills/{validacion-spec.md → validacion-spec/SKILL.md} +0 -0
- /package/skills/{verificador-implementacion.md → verificador-implementacion/SKILL.md} +0 -0
package/.claude/settings.json
CHANGED
|
@@ -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": "
|
|
5
|
+
"matcher": "",
|
|
31
6
|
"hooks": [
|
|
32
7
|
{
|
|
33
8
|
"type": "command",
|
|
34
|
-
"command": "node
|
|
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
|
|
16
|
+
"matcher": "Write|Edit",
|
|
42
17
|
"hooks": [
|
|
43
18
|
{
|
|
44
19
|
"type": "command",
|
|
45
|
-
"command": "node
|
|
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
|
}
|
|
@@ -2,29 +2,32 @@
|
|
|
2
2
|
"name": "sdd-es-marketplace",
|
|
3
3
|
"owner": {
|
|
4
4
|
"name": "SDD-ES",
|
|
5
|
-
"url": "https://github.com/
|
|
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.
|
|
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
|
|
16
|
-
"version": "2.
|
|
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": "
|
|
18
|
+
"name": "Danilo Angarita",
|
|
19
|
+
"email": "daniloangaritagarcia@gmail.com"
|
|
19
20
|
},
|
|
20
|
-
"homepage": "https://github.com/
|
|
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.
|
|
4
|
-
"description": "Spec-Driven Development en español. Fábrica de software agnóstica al stack: de la idea al despliegue. Con mapas y
|
|
5
|
-
"homepage": "https://github.com/carlos060798/
|
|
6
|
-
"repository": "https://github.com/carlos060798/
|
|
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
|
-
"
|
|
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
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
|
-
> **
|
|
4
|
-
>
|
|
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
|
[](https://www.npmjs.com/package/sdd-es)
|
|
7
9
|
[](https://nodejs.org)
|
|
8
10
|
[](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
|
-
##
|
|
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
|
|
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.
|
|
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
|
|
63
|
-
/sdd.especificar [idea] ← captura
|
|
64
|
-
/sdd.planificar ← plan técnico
|
|
65
|
-
/sdd.planificar aprobar ←
|
|
66
|
-
/sdd.tareas ←
|
|
67
|
-
/sdd.
|
|
68
|
-
/sdd.
|
|
69
|
-
/sdd.
|
|
70
|
-
/sdd.
|
|
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.verificar ← verificación final contra spec original
|
|
92
|
+
/sdd.desplegar ← gate de calidad → health check → publica
|
|
71
93
|
```
|
|
72
94
|
|
|
73
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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,
|
|
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,
|
|
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 ←
|
|
239
|
-
│ ├── agents/*.md ←
|
|
240
|
-
│ ├── skills/ ←
|
|
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
|
|
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
|
-
##
|
|
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 |
|
|
292
|
-
|
|
293
|
-
| Mapas estáticos (`/sdd.mapear`) |
|
|
294
|
-
| Compresión caveman (`/sdd.comprimir`) |
|
|
295
|
-
| RAG en 3 capas (estado.json → spec activa → constitución) | Carga solo lo necesario por fase |
|
|
296
|
-
| PTC paralelo (`orquestacion-ptc`) |
|
|
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
|
|