sdd-es 2.0.0

package/plantillas/estructura-mapa.md

@@ -0,0 +1,40 @@
+---
+generado_por: /sdd.mapear
+fecha: [FECHA]
+proyecto: [NOMBRE_PROYECTO]
+---
+
+# Mapa de Estructura del Proyecto
+
+Árbol de directorios con descripción de cada archivo. Generado automáticamente por `/sdd.mapear`.
+
+## Estructura
+
+[ÁRBOL AQUÍ]
+
+## Cómo se generó
+
+- Comando: `/sdd.mapear`
+- Lenguajes detectados: [LISTA]
+- Archivos indexados: [N]
+- Última actualización: [FECHA Y HORA]
+
+## Editabilidad
+
+Este archivo se regenera con `/sdd.mapear`. Para editar descripciones:
+
+1. Edita la descripción directamente en este archivo
+2. La próxima ejecución de `/sdd.mapear` respetará tus cambios
+3. Backup automático en `estructura-mapa.md.backup`
+
+## Para ignorar directorios
+
+Edita `.sdd/.mapeoignore` (sintaxis como `.gitignore`):
+
+```
+node_modules/
+dist/
+.git/
+vendor/
+__pycache__/
+```

package/plantillas/glosario.md

@@ -0,0 +1,22 @@
+# Glosario del Dominio
+
+> Términos del dominio del proyecto. Una definición precisa por término.
+> Editar con: `/sdd.glosario`
+
+## Términos
+
+### [Término]
+
+**Definición:** [una frase precisa]
+**Categoría:** [negocio | técnico | usuario | proceso]
+**Sinónimos a evitar:**
+- ~~[sinónimo]~~ (usar "[Término]")
+
+**Ejemplos:**
+- [ejemplo 1]
+- [ejemplo 2]
+
+**Referenciado en:**
+- [SPEC_ID_1], [SPEC_ID_2]
+
+**Última actualización:** [FECHA]

package/plantillas/index-especificaciones.md

@@ -0,0 +1,15 @@
+# Índice de Especificaciones
+
+> Registro de todas las especificaciones del proyecto, ordenado cronológicamente.
+
+## Estadísticas
+- Total: [N]
+- Completadas: [N]
+- En progreso: [N]
+- En borrador: [N]
+
+## Especificaciones
+
+| ID | Título | Estado | Tamaño | Spec | Plan | Tareas | Verif | Fecha |
+|----|--------|--------|--------|------|------|--------|-------|-------|
+| [SPEC_ID] | [título] | [estado] | [tam] | ✅ | ✅ | ✅ | ✅ | [fecha] |

package/plantillas/mcp-server.md

@@ -0,0 +1,147 @@
+# Plantilla: Servidor MCP
+
+Esqueleto base para el generador `/sdd.crear-mcp`. El agente `desarrollador-backend` rellena los `TODO` con el código real de cada tool.
+
+---
+
+## `package.json`
+
+```json
+{
+  "name": "mcp-NOMBRE",
+  "version": "1.0.0",
+  "description": "DESCRIPCION_UNA_LINEA",
+  "type": "module",
+  "bin": {
+    "mcp-NOMBRE": "./src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node --test tests/*.test.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}
+```
+
+---
+
+## `src/index.js`
+
+```javascript
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const server = new McpServer({
+  name: "mcp-NOMBRE",
+  version: "1.0.0",
+});
+
+// ── TOOL 1 ──────────────────────────────────────────────────────────────────
+// TODO: reemplazar con la tool real (una por CA)
+server.tool(
+  "nombre_tool_1",
+  "Descripción para el modelo: cuándo usar esta tool y qué hace",
+  {
+    // Parámetros de entrada (Zod schema)
+    entrada: z.string().describe("qué es este parámetro")
+  },
+  async ({ entrada }) => {
+    // TODO: lógica de la tool
+    const resultado = `procesado: ${entrada}`;
+    return {
+      content: [{ type: "text", text: resultado }]
+    };
+  }
+);
+
+// ── TOOL 2 (copiar bloque de arriba por cada CA adicional) ──────────────────
+// server.tool("nombre_tool_2", ...)
+
+// ── ARRANQUE ─────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// El servidor queda escuchando por stdin — no imprimir nada a stdout aquí
+```
+
+---
+
+## `.env.example`
+
+```bash
+# Variables de entorno requeridas por este MCP
+# Copia este archivo como .env y rellena los valores
+
+# TODO: añadir las variables que necesite la tool (API keys, rutas, etc.)
+# EJEMPLO_API_KEY=tu_clave_aqui
+# EJEMPLO_BASE_URL=https://api.ejemplo.com
+```
+
+---
+
+## `README.md` (estructura que genera `/sdd.crear-mcp`)
+
+```markdown
+# mcp-NOMBRE
+
+DESCRIPCION_UNA_LINEA
+
+## Qué hace
+
+| Tool | Qué hace | Parámetros |
+|------|----------|-----------|
+| nombre_tool_1 | [descripción] | `entrada` (texto) |
+
+## Instalación en Claude Code
+
+1. Clona o descarga este proyecto.
+2. Ejecuta en tu terminal:
+
+```
+claude mcp add NOMBRE -- node "/ruta/a/mcp-NOMBRE/src/index.js"
+```
+
+3. Reinicia Claude Code.
+
+## Variables de entorno
+
+Copia `.env.example` como `.env` y rellena los valores antes de instalar.
+
+## Uso
+
+Dile a Claude: "[ejemplo de frase en lenguaje natural que activa la tool]"
+
+## Requisitos
+
+- Node.js 18 o superior
+- Claude Code
+```
+
+---
+
+## `tests/mcp.test.js` (estructura base)
+
+```javascript
+import { test } from "node:test";
+import assert from "node:assert/strict";
+
+// Prueba de integración mínima: el módulo carga sin errores de sintaxis
+test("src/index.js carga sin errores", async () => {
+  // Verificar que el archivo existe y tiene contenido
+  const { readFileSync } = await import("node:fs");
+  const src = readFileSync("src/index.js", "utf8");
+  assert.ok(src.includes("McpServer"), "debe importar McpServer");
+  assert.ok(src.includes("server.tool("), "debe declarar al menos una tool");
+  assert.ok(src.includes("StdioServerTransport"), "debe usar stdio transport");
+});
+
+// TODO: añadir un test por tool que simule la entrada y verifique la salida
+// test("nombre_tool_1: procesa entrada correctamente", async () => { ... })
+```

package/plantillas/plan.md

@@ -0,0 +1,152 @@
+---
+spec_id: [SPEC_ID]
+plan_id: [SPEC_ID]-plan
+estado: pendiente_aprobacion  # pendiente_aprobacion | aprobado | obsoleto
+creado: [FECHA]
+constitucion_version: [X.Y.Z]
+agentes_participantes: []
+---
+
+# Plan Técnico: [TITULO_SPEC]
+
+## 1. Resumen Ejecutivo
+
+[3-5 frases. Qué se va a construir técnicamente, con qué tecnología, en qué archivos principales.]
+
+## 2. Verificación de Constitución (Constitution Check)
+
+| Principio | Cumple | Justificación |
+|-----------|--------|--------------|
+| Principio I | ✅/❌/⚠️ | [explicación] |
+| Principio II | ✅ | [explicación] |
+
+> Si hay ❌ o ⚠️: documentar en sección "Complejidad Justificada" o detener el plan.
+
+## 3. Enfoque Técnico
+
+[2-4 párrafos del enfoque elegido y por qué.]
+
+## 4. Decisiones Técnicas
+
+| # | Decisión | Opción elegida | Alternativas descartadas | Razón |
+|---|----------|---------------|--------------------------|-------|
+| 1 | [decisión] | [opción] | [otras] | [razón concreta] |
+
+> Decisiones no triviales también se documentan como ADR en `.sdd/arquitectura/`.
+
+## 5. Estructura de Carpetas Afectada
+
+```
+[Diagrama de árbol mostrando dónde van los archivos nuevos]
+```
+
+## 6. Archivos Afectados
+
+| Acción | Ruta | Propósito | Agente responsable |
+|--------|------|-----------|--------------------|
+| CREAR | `ruta/archivo.ext` | [qué hace] | desarrollador-backend |
+| MODIFICAR | `ruta/existente.ext` | [qué cambia] | desarrollador-backend |
+| ELIMINAR | `ruta/obsoleto.ext` | [por qué] | — |
+
+## 7. Modelo de Datos
+
+### Entidades nuevas
+```[lenguaje]
+// Tipos / interfaces / schemas
+```
+
+### Cambios en entidades existentes
+[Migraciones requeridas]
+
+### Queries críticas
+[SQL/NoSQL queries importantes con justificación de índices]
+
+## 8. Contratos de API
+
+### Endpoints / Operaciones nuevas
+```yaml
+# OpenAPI / GraphQL schema / proto / etc
+```
+
+### Cambios en endpoints existentes
+[Breaking? Si sí, plan de migración]
+
+### Eventos / Mensajes (si aplica)
+[Topics, formatos, idempotencia]
+
+## 9. Estrategia de Tests
+
+### Tests unitarios
+- Qué unidades se testean
+- Mocks necesarios
+
+### Tests de integración
+- Qué integraciones se prueban
+
+### Tests E2E (si aplica)
+- Flujos críticos a cubrir
+
+## 10. Dependencias Nuevas
+
+| Paquete | Versión | Justificación | Alternativas |
+|---------|---------|--------------|-------------|
+| [paquete] | [versión] | [por qué] | [otras] |
+
+## 11. Riesgos Técnicos
+
+| # | Riesgo | Probabilidad | Impacto | Mitigación |
+|---|--------|--------------|---------|-----------|
+| 1 | [riesgo] | A/M/B | A/M/B | [acción] |
+
+## 12. Plan de Implementación en Fases
+
+### Fase A: Fundamentos
+[Tipos, interfaces, schemas, migraciones]
+
+### Fase B: Tests primero (si TDD)
+
+### Fase C: Capa de datos
+
+### Fase D: Lógica de negocio
+
+### Fase E: Interfaz / API
+
+### Fase F: UI (si aplica)
+
+### Fase G: Integración
+
+### Fase H: Verificación
+
+## 13. Cambios Breaking
+
+[Lista de cambios que rompen compatibilidad. Vacío si ninguno.]
+
+## 14. Métricas y Observabilidad
+
+[Qué loguear / métricas a exponer / alarmas]
+
+## 15. Complejidad Justificada
+
+[Solo si hay desviaciones de la constitución que se justifican.]
+
+## 16. Estimación
+
+- Complejidad global: [Baja / Media / Alta]
+- Tareas estimadas: [N]
+
+## 17. Aportes por Agente
+
+### Arquitecto
+[Decisiones de alto nivel]
+
+### Diseñador de API
+[Diseño de contratos]
+
+### Asesor de datos
+[Decisiones de BD]
+
+### Crítico
+[Riesgos identificados]
+
+### Seguridad
+[Consideraciones]

package/plantillas/simbolos-mapa.md

@@ -0,0 +1,57 @@
+---
+generado_por: /sdd.mapear
+fecha: [FECHA]
+proyecto: [NOMBRE_PROYECTO]
+---
+
+# Mapa de Símbolos Públicos
+
+Funciones, clases, tipos e interfaces exportadas por cada archivo.
+
+Generado automáticamente por `/sdd.mapear`.
+
+## Convención
+
+- **fn** = función
+- **class** = clase
+- **type** = tipo TypeScript
+- **interface** = interfaz TypeScript
+- **enum** = enumeración
+- **const** = constante exportada
+
+## Archivos
+
+[SÍMBOLOS POR ARCHIVO AQUÍ]
+
+Ejemplo:
+
+```markdown
+## src/auth/login.service.ts
+
+- **fn** autenticarUsuario(email: string, password: string): Promise<Session>
+  Autentica usuario con email y password. Lanza InvalidCredentialsError si fallan.
+
+- **fn** cerrarSesion(sessionId: string): Promise<void>
+  Cierra sesión borrando el token.
+
+- **type** AuthResult
+  ```typescript
+  { session: Session, user: User }
+  ```
+
+## src/users/user.service.ts
+
+- **fn** crearUsuario(datos: CreateUserDTO): Promise<User>
+  Crea nuevo usuario. Valida email único.
+
+- **fn** obtenerPorId(id: string): Promise<User>
+  Obtiene usuario por ID. Lanza UserNotFoundError si no existe.
+```
+
+## Cómo usarlo
+
+Durante `/sdd.implementar`, antes de modificar archivo X:
+
+1. Claude consulta este mapa: ¿qué exporta X?
+2. Si necesita más detalle, lee el archivo
+3. Típicamente el mapa le alcanza

package/plantillas/snapshot.md

@@ -0,0 +1,54 @@
+# SNAPSHOT del Producto: [NOMBRE_PROYECTO]
+
+> Última actualización: [FECHA]
+> Versión de constitución: v[X.Y.Z]
+> Última spec aplicada: [SPEC_ID]
+
+## ¿Qué es este producto?
+
+[2-4 frases ejecutivas]
+
+## ¿Para quién?
+
+[Actores/usuarios con su necesidad]
+
+## Funcionalidades Activas
+
+### [Categoría 1]
+- ✅ **[Funcionalidad]** — [descripción]. *Spec: [ID]*
+
+### [Categoría 2]
+- ✅ **[...]**
+
+## Arquitectura de Alto Nivel
+
+```
+┌────────┐    ┌────────┐    ┌──────┐
+│Frontend│───>│Backend │───>│  BD  │
+└────────┘    └────────┘    └──────┘
+```
+
+## Integraciones
+
+| Sistema | Propósito | Estado |
+|---------|-----------|--------|
+
+## Datos manejados
+
+[Tipos de datos principales]
+
+## Términos del dominio (resumen)
+> Glosario completo: `.sdd/dominio/glosario.md`
+
+## Especificaciones aplicadas (últimas 10)
+
+| ID | Título | Fecha |
+|----|--------|-------|
+
+## Roadmap
+
+[Specs en borrador o pendientes]
+
+## Métricas del producto
+
+[Si la constitución establece métricas]

package/plantillas/tareas.md

@@ -0,0 +1,72 @@
+---
+spec_id: [SPEC_ID]
+total_tareas: 0
+estado: pendiente
+generado: [FECHA]
+---
+
+# Tareas: [TITULO_SPEC]
+
+## Progreso
+
+```
+[░░░░░░░░░░░░░░░░░░░░] 0% (0/[N])
+```
+
+| Total | Pendientes | En progreso | Completadas | Bloqueadas |
+|-------|------------|-------------|-------------|------------|
+| [N]   | [N]        | 0           | 0           | 0          |
+
+## Leyenda de estados
+- ⬜ pendiente
+- 🔧 en_progreso
+- ✅ completada
+- ❌ bloqueada
+- ⏭️ omitida
+
+---
+
+## T001 — [Nombre descriptivo]
+
+**Fase:** A (Fundamentos)
+**Agente:** [agente]
+**Modelo:** [modelo] (según config)
+**Archivos:** `ruta/nuevo.ext` (CREAR)
+**Depende de:** —
+**Estado:** ⬜ pendiente
+**Tiempo estimado:** S/M/L
+
+### Qué hacer
+[Descripción específica e inequívoca]
+
+### Contexto
+- CA cubierto: CA-001-01
+- Decisión técnica: #1 del plan
+
+### Criterio de verificación
+```bash
+[comando o assertion concreta]
+```
+
+### Notas
+[Patrones a seguir, decisiones tomadas]
+
+---
+
+## Matriz de Cobertura de CAs
+
+| CA | Tareas que lo cubren |
+|----|----------------------|
+| CA-001-01 | T001, T003 |
+
+## Diagrama de Dependencias
+
+```
+T001 ──> T003 ──> T005
+T002 ──> T004
+```
+
+## Historial de Cambios
+
+| Tarea | Anterior | Nuevo | Fecha | Notas |
+|-------|----------|-------|-------|-------|

package/presets/enterprise.yaml

@@ -0,0 +1,69 @@
+# ============================================================
+# PRESET: enterprise
+# Para: equipos grandes, compliance, auditoría, producto crítico.
+# Filosofía: proceso completo. Nada llega a prod sin revisión.
+# ============================================================
+
+preset:
+  nombre: enterprise
+  descripcion: "Equipo grande o producto crítico. Proceso completo con auditoría."
+  casos_de_uso:
+    - "Equipo de 8+ desarrolladores"
+    - "Producto con datos sensibles (fintech, healthtech, legaltech)"
+    - "Compliance requerido (SOC2, ISO 27001, HIPAA, GDPR)"
+    - "Sistema que no puede fallar (infraestructura crítica)"
+
+agentes:
+  arquitecto:
+    activo: true
+    modelo: opus
+  disenador-api:
+    activo: true
+    modelo: sonnet
+  asesor-datos:
+    activo: true
+    modelo: opus
+  desarrollador-backend:
+    activo: true
+    modelo: sonnet
+  desarrollador-frontend:
+    activo: true
+    modelo: sonnet
+  operaciones:
+    activo: true
+    modelo: sonnet
+  tester:
+    activo: true
+    modelo: sonnet
+  revisor:
+    activo: true
+    modelo: opus          # revisión profunda siempre
+  critico:
+    activo: true
+    modelo: opus          # análisis de riesgos en todo
+  seguridad:
+    activo: true
+    modelo: opus          # auditoría en cada cambio sensible
+  documentador:
+    activo: true          # docs formales requeridas
+    modelo: sonnet
+  investigador:
+    activo: true
+    modelo: sonnet
+
+comportamiento:
+  deteccion_tamano_automatica: true
+  ruta_rapida_micro: false          # incluso cambios micro pasan por el flujo
+  numeracion_especificaciones: "ambos"   # fecha + secuencial para trazabilidad
+  requerir_aprobacion_plan: true
+  requerir_aprobacion_tareas: true  # aprobación explícita del plan de tareas
+  flujo_minimo: false
+  requiere_analizar: true           # /sdd.analizar obligatorio antes de implementar
+  requiere_verificar: true          # /sdd.verificar obligatorio al final
+
+calidad:
+  cobertura_tests_minima: 85
+  permitir_warnings_lint: false
+  permitir_codigo_comentado: false
+  longitud_funcion_maxima: 40       # funciones más cortas, más legibles
+  longitud_archivo_maxima: 300

package/presets/lean.yaml

@@ -0,0 +1,63 @@
+# ============================================================
+# PRESET: lean
+# Para: proyectos personales, prototipos, indie hackers,
+#        MVPs con un desarrollador.
+# Filosofía: velocidad > proceso. Sin fricción innecesaria.
+# ============================================================
+
+preset:
+  nombre: lean
+  descripcion: "Proyecto personal o prototipo. Velocidad máxima, proceso mínimo."
+  casos_de_uso:
+    - "Side project / indie hacker"
+    - "Prototipo para validar idea"
+    - "Proyecto de aprendizaje"
+    - "MVP con un solo desarrollador"
+
+# Solo los agentes esenciales
+agentes:
+  arquitecto:
+    activo: true
+    modelo: sonnet        # sonnet en lugar de opus — decisiones más simples
+  disenador-api:
+    activo: true
+    modelo: sonnet
+  asesor-datos:
+    activo: true
+    modelo: sonnet        # sonnet OK para BDs simples
+  desarrollador-backend:
+    activo: true
+    modelo: sonnet
+  desarrollador-frontend:
+    activo: true
+    modelo: sonnet
+  operaciones:
+    activo: false         # configura el CI tú mismo
+  tester:
+    activo: true
+    modelo: sonnet
+  revisor:
+    activo: false         # sin revisión formal — tú eres el revisor
+  critico:
+    activo: false         # sin análisis de riesgos formal
+  seguridad:
+    activo: false         # revisión básica en tu cabeza
+  documentador:
+    activo: false
+  investigador:
+    activo: false         # no hay equipo que necesite el contexto documentado
+
+comportamiento:
+  deteccion_tamano_automatica: true
+  ruta_rapida_micro: true
+  numeracion_especificaciones: "secuencial"
+  requerir_aprobacion_plan: false   # no pide confirmación — avanza solo
+  requerir_aprobacion_tareas: false
+  flujo_minimo: true                # salta /sdd.analizar por defecto
+
+calidad:
+  cobertura_tests_minima: 60        # umbral relajado
+  permitir_warnings_lint: true      # no bloquea por warnings
+  permitir_codigo_comentado: true
+  longitud_funcion_maxima: 80       # más flexible
+  longitud_archivo_maxima: 600