don-cheli-sdd 1.13.0

package/habilidades/validacion-nyquist/HABILIDAD.md

@@ -0,0 +1,161 @@
+---
+nombre: Validación Nyquist
+descripcion: "Verificar que cada requisito de la spec tiene al menos un test que lo cubre (mapeo 1:1 spec↔test)"
+version: 1.0.0
+autor: Don Cheli
+tags: [calidad, nyquist, tests, cobertura, requisitos]
+activacion: "nyquist", "cobertura de specs", "mapeo tests requisitos"
+---
+
+# Habilidad: Validación Nyquist (Testabilidad Pre-Coding)
+
+**Versión:** 1.0.0
+**Categoría:** Calidad
+**Tipo:** Rígida
+
+> Adaptado de Get Shit Done (gsd-build/get-shit-done) — Nyquist Validation Layer.
+
+## Cómo Mejora el Framework
+
+Don Cheli exige TDD (Ley de Hierro #1), pero la validación ocurre **durante** la implementación (RED→GREEN). No hay verificación de que **todos** los requisitos tengan tests mapeados **antes** de empezar a codear.
+
+La Validación Nyquist previene el problema: "lo construimos pero no podemos medir si funciona".
+
+## El Concepto
+
+> En teoría de señales, el Teorema de Nyquist dice que para capturar fielmente una señal, necesitas muestrearla al doble de su frecuencia. Analogía: para capturar fielmente los requisitos, necesitas al menos un test por requisito.
+
+```
+Sin Nyquist:
+  Plan → Implementar → "¿funciona?" → "no sé, no hay test para eso"
+
+Con Nyquist:
+  Plan → Mapeo tests↔requisitos → ¿100% cubierto? → Implementar → Verificar
+```
+
+## Cuándo se Ejecuta
+
+La validación Nyquist se ejecuta como **puerta de calidad** entre `/especdev:desglosar` y `/especdev:implementar`:
+
+```
+/especdev:desglosar → .tasks.md
+  → [VALIDACIÓN NYQUIST] ← aquí
+  → /especdev:implementar
+```
+
+## Proceso de Validación
+
+### Paso 1: Extraer Requisitos
+
+De la spec (`.feature`) y el plan (`.plan.md`), extraer todos los requisitos verificables:
+
+```markdown
+## Requisitos Extraídos
+
+| ID | Requisito | Fuente | Tipo |
+|----|-----------|--------|------|
+| R01 | Registro exitoso crea usuario | CrearUsuario.feature:E1 | Funcional |
+| R02 | Email duplicado retorna error | CrearUsuario.feature:E2 | Funcional |
+| R03 | Campo vacío retorna error | CrearUsuario.feature:E3 | Validación |
+| R04 | Respuesta en < 500ms (p95) | CrearUsuario.feature:CE | Rendimiento |
+| R05 | Password se almacena hasheado | CrearUsuario.plan.md:Modelo | Seguridad |
+```
+
+### Paso 2: Mapear Tests
+
+Para cada requisito, identificar qué tarea del `.tasks.md` lo verifica:
+
+```markdown
+## Mapeo Nyquist
+
+| Requisito | Tarea que lo verifica | Comando de verificación | Estado |
+|-----------|----------------------|------------------------|--------|
+| R01 | T008 (test registro exitoso) | `pytest tests/unit/test_service.py::test_crear_exitoso` | ✅ Cubierto |
+| R02 | T009 (test email duplicado) | `pytest tests/unit/test_service.py::test_email_duplicado` | ✅ Cubierto |
+| R03 | T014 (test campo vacío) | `pytest tests/unit/test_service.py::test_campo_vacio` | ✅ Cubierto |
+| R04 | — | — | ❌ Sin test |
+| R05 | — | — | ❌ Sin test |
+```
+
+### Paso 3: Evaluar Cobertura
+
+```markdown
+## Resultado Nyquist
+
+Requisitos totales: 5
+Cubiertos por tests: 3
+Sin cobertura: 2
+Cobertura Nyquist: 60% (mínimo requerido: 100% para P1, 80% para P2)
+
+❌ NO-AVANZAR — Faltan tests para:
+  - R04 (Rendimiento): Agregar test de latencia p95
+  - R05 (Seguridad): Agregar test que verifique hash vs plaintext
+```
+
+### Paso 4: Resolver Brechas
+
+Antes de implementar, se DEBEN agregar las tareas faltantes al `.tasks.md`:
+
+```markdown
+## Tareas Agregadas por Nyquist
+
+- [T025] [P] [US1] RED: Test de latencia p95 para POST /usuarios (< 500ms)
+- [T026] [P] [US1] RED: Test que verifica password hasheado en BD (no plaintext)
+```
+
+## Umbrales de Cobertura Nyquist
+
+| Prioridad | Cobertura Mínima | Acción si no cumple |
+|-----------|------------------|---------------------|
+| **P1** (Camino Crítico) | 100% | ❌ NO-AVANZAR |
+| **P2** (Importante) | 80% | ⚠️ WARNING (puede avanzar con justificación) |
+| **P3+** (Deseable) | 50% | ℹ️ INFO (registrar deuda) |
+
+## Tipos de Verificación
+
+No todos los requisitos se verifican con tests automatizados:
+
+| Tipo | Verificación | Ejemplo |
+|------|-------------|---------|
+| **Automatizado** | Test unitario/integración | "Email duplicado retorna 409" |
+| **Visual** | Checkpoint humano | "UI se ve correctamente en mobile" |
+| **Rendimiento** | Benchmark automatizado | "Respuesta < 500ms p95" |
+| **Manual** | Checklist UAT | "Flujo de onboarding es intuitivo" |
+
+Los requisitos con verificación **Visual** o **Manual** se marcan como `[checkpoint-humano]` y no bloquean la puerta Nyquist, pero se registran en la deuda de verificación.
+
+## Deuda de Verificación
+
+Requisitos que no pueden verificarse automáticamente se registran como **deuda**:
+
+```markdown
+## Deuda de Verificación
+
+| Requisito | Tipo | Razón | Cuándo resolver |
+|-----------|------|-------|-----------------|
+| R04 | Rendimiento | Requiere entorno de carga | Antes de release |
+| "UI responsive" | Visual | Requiere revisión humana | En checkpoint |
+```
+
+## Integración con Puertas de Calidad
+
+La Validación Nyquist se integra como **sub-puerta de la Puerta 5** (Preparación de Tareas):
+
+```
+Puerta 5: Preparación de Tareas
+├── Todas las tareas con IDs (T###) ✅
+├── Rutas de archivos en tareas ✅
+├── Marcadores [P] de paralelismo ✅
+├── 5 fases presentes ✅
+└── Validación Nyquist ✅ ← NUEVA
+    ├── P1: 100% cubierto
+    ├── P2: 80%+ cubierto
+    └── P3+: 50%+ cubierto (o deuda registrada)
+```
+
+## Guardrails
+
+- **Nunca** avanzar a implementación con P1 sin 100% de cobertura Nyquist
+- **Nunca** aceptar "se probará manualmente" para requisitos automatizables
+- **Siempre** registrar deuda de verificación para requisitos no automatizables
+- **Siempre** agregar tareas faltantes al `.tasks.md` antes de implementar

package/habilidades/worktrees/HABILIDAD.md

@@ -0,0 +1,80 @@
+---
+nombre: Git Worktrees
+descripcion: "Usar git worktrees para trabajo paralelo en múltiples branches sin conflictos de checkout"
+version: 1.0.0
+autor: Don Cheli
+tags: [git, worktrees, paralelo, branches]
+activacion: "worktree", "trabajo paralelo", "múltiples branches"
+---
+
+# Habilidad: Git Worktrees
+
+**Versión:** 1.0.0
+**Categoría:** Desarrollo
+**Tipo:** Rígida
+
+> Adaptado de [superpowers](https://github.com/obra/superpowers) — Desarrollo paralelo con workspaces aislados.
+
+## Propósito
+
+Usar git worktrees para desarrollo en paralelo sin conflictos de branch. Cada tarea trabaja en su propia copia del repo sin afectar a las demás.
+
+## Cuándo Usar
+
+- Múltiples features en paralelo
+- PoC que no debe contaminar `main`
+- Subagentes ejecutando tareas independientes
+- Code review mientras se sigue desarrollando
+
+## Comandos
+
+```bash
+# Crear worktree para una feature
+git worktree add ../mi-proyecto-feature-auth feature/auth
+
+# Crear worktree desde branch nuevo
+git worktree add -b feature/payments ../mi-proyecto-payments main
+
+# Listar worktrees activos
+git worktree list
+
+# Eliminar worktree terminado
+git worktree remove ../mi-proyecto-feature-auth
+```
+
+## Convención de Nombres
+
+```
+../<proyecto>-<tipo>-<nombre>/
+```
+
+Ejemplos:
+```
+../mi-api-feature-auth/
+../mi-api-poc-websockets/
+../mi-api-fix-timeout/
+```
+
+## Flujo con Subagentes
+
+```
+Tarea A (independiente)  →  Worktree A  →  Subagente A
+Tarea B (independiente)  →  Worktree B  →  Subagente B
+Tarea C (independiente)  →  Worktree C  →  Subagente C
+                                              ↓
+                                      Merge secuencial
+```
+
+## Reglas
+
+1. **Un worktree = un branch** — Nunca compartir branches entre worktrees
+2. **Limpiar al terminar** — `git worktree remove` después de merge
+3. **No worktrees anidados** — Siempre al mismo nivel que el repo principal
+4. **Commit antes de eliminar** — Verificar que todo está mergeado
+5. **Nombrar descriptivamente** — El nombre debe indicar qué se trabaja
+
+## Integración con Don Cheli
+
+- `/especdev:implementar` puede usar worktrees para tareas `[P]` (paralelas)
+- `/especdev:poc` crea worktree automáticamente en `poc/<nombre>`
+- Subagentes ejecutores reciben worktree aislado por defecto

package/locales/en.json

@@ -0,0 +1,179 @@
+{
+  "installer": {
+    "banner_line1": "Don Cheli — SDD Framework v{{version}}",
+    "banner_line2": "Stop improvising. Start delivering.",
+    "select_language": "Selecciona tu idioma / Select your language / Selecione seu idioma",
+    "option_es": "Español",
+    "option_en": "English",
+    "option_pt": "Português",
+    "invalid_option": "Invalid option. Select 1, 2 or 3.",
+    "language_selected": "Language selected: {{language}}",
+    "mode_global": "Mode: Global installation",
+    "mode_local": "Mode: Local installation in current project",
+    "framework_path": "Framework: {{path}}",
+    "commands_path": "Commands: {{path}}",
+    "step_structure": "Creating structure...",
+    "step_commands": "Copying commands...",
+    "step_commands_done": "{{count}} commands /especdev:*",
+    "step_reasoning_done": "{{count}} commands /razonar:*",
+    "step_skills": "Copying skills...",
+    "step_skills_done": "{{count}} skills",
+    "step_rules": "Copying rules...",
+    "step_rules_done": "{{count}} rules",
+    "step_templates": "Copying templates...",
+    "step_templates_done": "Templates copied",
+    "step_hooks": "Copying hooks...",
+    "step_hooks_done": "Hooks copied",
+    "step_agents": "Copying agents...",
+    "step_agents_done": "Agents copied",
+    "step_scripts": "Copying scripts...",
+    "step_scripts_done": "Scripts copied",
+    "step_reference": "Copying reference files...",
+    "step_reference_done": "CLAUDE.md, AGENTS.md, prompt.md, NOTICE",
+    "success_title": "Don Cheli v{{version}} successfully installed",
+    "structure_title": "Installed structure:",
+    "structure_skills": "skills",
+    "structure_rules": "rules",
+    "structure_templates": "templates",
+    "structure_hooks": "hooks",
+    "structure_agents": "agents",
+    "structure_commands": "commands",
+    "next_steps_title": "Next steps:",
+    "next_step_1": "Restart Claude Code",
+    "next_step_2": "In any project run: /especdev:iniciar",
+    "farewell": "Stop improvising. Start delivering!"
+  },
+  "framework": {
+    "identity": "You are a development assistant operating under the Don Cheli framework (Specification-Driven Development).",
+    "language_instruction": "ALWAYS respond in English. Code (variables, functions) in English. Documentation, commits and communication in English.",
+    "phases": {
+      "0": "Initialization",
+      "1": "Proposal",
+      "2": "Specification",
+      "3": "Clarification",
+      "4": "Technical design",
+      "5": "Planning",
+      "6": "Breakdown",
+      "7": "Implementation",
+      "8": "Review"
+    },
+    "status": {
+      "pending": "Pending",
+      "in_progress": "In progress",
+      "completed": "Completed",
+      "approved": "Approved",
+      "blocked": "Blocked"
+    },
+    "project_types": {
+      "producto": "New complete product",
+      "cli": "Command-line application",
+      "app": "Desktop/mobile application",
+      "libreria": "Reusable package",
+      "servicio": "Microservice/API",
+      "refactor": "Existing refactoring",
+      "correccion": "Bug fix"
+    },
+    "verdicts": {
+      "viable": "VIABLE — Proceed with implementation",
+      "viable_with_reservations": "VIABLE WITH RESERVATIONS — Document limitations",
+      "not_viable": "NOT VIABLE — Explore alternatives",
+      "inconclusive": "INCONCLUSIVE — Reformulate hypothesis"
+    },
+    "review": {
+      "approved": "APPROVED",
+      "approved_with_observations": "APPROVED WITH OBSERVATIONS",
+      "rejected": "REJECTED",
+      "pending": "PENDING APPROVAL"
+    },
+    "priorities": {
+      "p1": "Critical Path",
+      "p2": "Important",
+      "p3": "Desirable"
+    },
+    "severity": {
+      "critical": "Critical",
+      "high": "High",
+      "medium": "Medium",
+      "low": "Low"
+    },
+    "tdd": {
+      "red": "Write a FAILING test",
+      "green": "Implement MINIMUM code to pass",
+      "refactor": "Clean up without changing behavior"
+    },
+    "iron_laws": {
+      "1": "All production code requires tests",
+      "2": "Root cause first, then the fix",
+      "3": "Evidence before assertions"
+    }
+  },
+  "commands": {
+    "iniciar": {
+      "initialized": "Don Cheli initialized",
+      "project": "Project",
+      "type": "Type",
+      "directory": "Directory",
+      "files_created": "files created",
+      "next_step": "Next step: edit .especdev/plan.md to define your phases",
+      "already_exists": ".especdev/ already exists. Do you want to overwrite or repair?"
+    },
+    "estado": {
+      "current_phase": "Current Phase",
+      "next_phase": "Next Phase",
+      "summary": "Summary",
+      "phase_history": "Phase History"
+    },
+    "proponer": {
+      "intention": "Intention (WHY)",
+      "scope": "Scope (WHAT)",
+      "included": "Included",
+      "excluded": "Excluded",
+      "approach": "Approach (HOW)",
+      "risks": "Risks",
+      "estimate": "Preliminary Estimate",
+      "open_questions": "Open Questions",
+      "pending_approval": "PENDING APPROVAL"
+    },
+    "clarificar": {
+      "ambiguities_detected": "Ambiguities Detected",
+      "schema_check": "Schema-Spec Verification",
+      "convention_check": "Convention Check",
+      "auto_generated_audit": "Auto-Generated Audit",
+      "result": "Result",
+      "pass": "PASS",
+      "fail": "FAIL",
+      "advance": "ADVANCE",
+      "no_advance": "NO-ADVANCE"
+    },
+    "implementar": {
+      "phase_setup": "Phase 1: Setup",
+      "phase_foundation": "Phase 2: Foundation",
+      "phase_stories": "Phase 3: User Stories",
+      "phase_polish": "Phase 4: Polish",
+      "phase_verify": "Phase 5: Final Verification",
+      "checkpoint_verify": "CHECKPOINT: verify",
+      "checkpoint_decision": "CHECKPOINT: decision",
+      "checkpoint_human": "CHECKPOINT: human-action",
+      "all_tests_pass": "All tests pass. Feature successfully implemented."
+    },
+    "revisar": {
+      "functional": "Functional Correctness",
+      "tests": "Tests and Coverage",
+      "performance": "Performance",
+      "architecture": "Architecture and Design",
+      "security": "Security",
+      "style": "Style and Conventions",
+      "diff": "Clean Diff"
+    },
+    "diagnostico": {
+      "structure": "Structure",
+      "configuration": "Configuration",
+      "environment": "Environment",
+      "pipeline": "Pipeline",
+      "healthy": "HEALTHY",
+      "functional": "FUNCTIONAL",
+      "needs_attention": "NEEDS ATTENTION",
+      "warnings": "Warnings"
+    }
+  }
+}

package/locales/es.json

@@ -0,0 +1,179 @@
+{
+  "installer": {
+    "banner_line1": "Don Cheli — SDD Framework v{{version}}",
+    "banner_line2": "Deja de improvisar. Empieza a entregar.",
+    "select_language": "Selecciona tu idioma / Select your language / Selecione seu idioma",
+    "option_es": "Español",
+    "option_en": "English",
+    "option_pt": "Português",
+    "invalid_option": "Opción inválida. Selecciona 1, 2 o 3.",
+    "language_selected": "Idioma seleccionado: {{language}}",
+    "mode_global": "Modo: Instalación global",
+    "mode_local": "Modo: Instalación local en proyecto actual",
+    "framework_path": "Framework: {{path}}",
+    "commands_path": "Comandos: {{path}}",
+    "step_structure": "Creando estructura...",
+    "step_commands": "Copiando comandos...",
+    "step_commands_done": "{{count}} comandos /especdev:*",
+    "step_reasoning_done": "{{count}} comandos /razonar:*",
+    "step_skills": "Copiando habilidades...",
+    "step_skills_done": "{{count}} habilidades",
+    "step_rules": "Copiando reglas...",
+    "step_rules_done": "{{count}} reglas",
+    "step_templates": "Copiando plantillas...",
+    "step_templates_done": "Plantillas copiadas",
+    "step_hooks": "Copiando ganchos...",
+    "step_hooks_done": "Ganchos copiados",
+    "step_agents": "Copiando agentes...",
+    "step_agents_done": "Agentes copiados",
+    "step_scripts": "Copiando scripts...",
+    "step_scripts_done": "Scripts copiados",
+    "step_reference": "Copiando archivos de referencia...",
+    "step_reference_done": "CLAUDE.md, AGENTS.md, prompt.md, NOTICE",
+    "success_title": "Don Cheli v{{version}} instalado exitosamente",
+    "structure_title": "Estructura instalada:",
+    "structure_skills": "habilidades",
+    "structure_rules": "reglas",
+    "structure_templates": "plantillas",
+    "structure_hooks": "ganchos",
+    "structure_agents": "agentes",
+    "structure_commands": "comandos",
+    "next_steps_title": "Próximos pasos:",
+    "next_step_1": "Reinicia Claude Code",
+    "next_step_2": "En cualquier proyecto ejecuta: /especdev:iniciar",
+    "farewell": "¡Deja de improvisar. Empieza a entregar!"
+  },
+  "framework": {
+    "identity": "Eres un asistente de desarrollo que opera bajo el framework Don Cheli (Desarrollo Dirigido por Especificaciones).",
+    "language_instruction": "Responde SIEMPRE en español. Código (variables, funciones) en inglés. Documentación, commits y comunicación en español.",
+    "phases": {
+      "0": "Inicialización",
+      "1": "Propuesta",
+      "2": "Especificación",
+      "3": "Clarificación",
+      "4": "Diseño técnico",
+      "5": "Planificación",
+      "6": "Desglose",
+      "7": "Implementación",
+      "8": "Revisión"
+    },
+    "status": {
+      "pending": "Pendiente",
+      "in_progress": "En progreso",
+      "completed": "Completada",
+      "approved": "Aprobada",
+      "blocked": "Bloqueada"
+    },
+    "project_types": {
+      "producto": "Producto completo nuevo",
+      "cli": "Aplicación de línea de comandos",
+      "app": "Aplicación desktop/móvil",
+      "libreria": "Paquete reutilizable",
+      "servicio": "Microservicio/API",
+      "refactor": "Refactoring existente",
+      "correccion": "Corrección de bug"
+    },
+    "verdicts": {
+      "viable": "VIABLE — Proceder con implementación",
+      "viable_with_reservations": "VIABLE CON RESERVAS — Documentar limitaciones",
+      "not_viable": "NO VIABLE — Explorar alternativas",
+      "inconclusive": "INCONCLUSO — Reformular hipótesis"
+    },
+    "review": {
+      "approved": "APROBADO",
+      "approved_with_observations": "APROBADO CON OBSERVACIONES",
+      "rejected": "RECHAZADO",
+      "pending": "PENDIENTE APROBACIÓN"
+    },
+    "priorities": {
+      "p1": "Camino Crítico",
+      "p2": "Importante",
+      "p3": "Deseable"
+    },
+    "severity": {
+      "critical": "Crítico",
+      "high": "Alto",
+      "medium": "Medio",
+      "low": "Bajo"
+    },
+    "tdd": {
+      "red": "Escribir test que FALLA",
+      "green": "Implementar código MÍNIMO para que pase",
+      "refactor": "Limpiar sin cambiar comportamiento"
+    },
+    "iron_laws": {
+      "1": "Todo código de producción requiere tests",
+      "2": "Primero la causa raíz, luego la corrección",
+      "3": "Evidencia antes de afirmaciones"
+    }
+  },
+  "commands": {
+    "iniciar": {
+      "initialized": "Don Cheli inicializado",
+      "project": "Proyecto",
+      "type": "Tipo",
+      "directory": "Directorio",
+      "files_created": "archivos creados",
+      "next_step": "Próximo paso: edita .especdev/plan.md para definir tus fases",
+      "already_exists": ".especdev/ ya existe. ¿Deseas sobrescribir o reparar?"
+    },
+    "estado": {
+      "current_phase": "Fase Actual",
+      "next_phase": "Próxima Fase",
+      "summary": "Resumen",
+      "phase_history": "Historial de Fases"
+    },
+    "proponer": {
+      "intention": "Intención (POR QUÉ)",
+      "scope": "Alcance (QUÉ)",
+      "included": "Incluido",
+      "excluded": "Excluido",
+      "approach": "Enfoque (CÓMO)",
+      "risks": "Riesgos",
+      "estimate": "Estimado Preliminar",
+      "open_questions": "Preguntas Abiertas",
+      "pending_approval": "PENDIENTE APROBACIÓN"
+    },
+    "clarificar": {
+      "ambiguities_detected": "Ambigüedades Detectadas",
+      "schema_check": "Verificación Schema-Spec",
+      "convention_check": "Verificación de Convenciones",
+      "auto_generated_audit": "Auditoría Auto-Generado",
+      "result": "Resultado",
+      "pass": "PASA",
+      "fail": "FALLA",
+      "advance": "AVANZAR",
+      "no_advance": "NO-AVANZAR"
+    },
+    "implementar": {
+      "phase_setup": "Fase 1: Setup",
+      "phase_foundation": "Fase 2: Fundación",
+      "phase_stories": "Fase 3: Historias de Usuario",
+      "phase_polish": "Fase 4: Polish",
+      "phase_verify": "Fase 5: Verificación Final",
+      "checkpoint_verify": "CHECKPOINT: verificar",
+      "checkpoint_decision": "CHECKPOINT: decisión",
+      "checkpoint_human": "CHECKPOINT: acción-humana",
+      "all_tests_pass": "Todos los tests pasan. Feature implementada exitosamente."
+    },
+    "revisar": {
+      "functional": "Corrección Funcional",
+      "tests": "Tests y Cobertura",
+      "performance": "Rendimiento",
+      "architecture": "Arquitectura y Diseño",
+      "security": "Seguridad",
+      "style": "Estilo y Convenciones",
+      "diff": "Diff Limpio"
+    },
+    "diagnostico": {
+      "structure": "Estructura",
+      "configuration": "Configuración",
+      "environment": "Entorno",
+      "pipeline": "Pipeline",
+      "healthy": "SALUDABLE",
+      "functional": "FUNCIONAL",
+      "needs_attention": "REQUIERE ATENCIÓN",
+      "warnings": "Warnings"
+    }
+  }
+}