don-cheli-sdd 1.13.0

package/plantillas/especdev/en/runtime.md

@@ -0,0 +1,26 @@
+# Runtime
+
+Project execution information: endpoints, environment variables, services, ports.
+
+## Local Endpoints
+| Service | URL | Port |
+|---------|-----|------|
+<!-- Auto-generated during /especdev:implementar -->
+
+## Required Environment Variables
+| Variable | Description | Source |
+|----------|-------------|--------|
+<!-- Extracted from .env.example -->
+
+## External Services
+| Service | URL/Host | Plan | Rate Limit |
+|---------|----------|------|------------|
+<!-- Documented during PoC and planning -->
+
+## Development Commands
+```bash
+# Start
+# Tests
+# Build
+# Deploy
+```

package/plantillas/especdev/en/status.md

@@ -0,0 +1,16 @@
+# Don Cheli Status
+
+## Current
+- **Phase:** 1/7 (Discovery)
+- **Task:** Define the problem
+- **Blocker:** None
+
+## Quick Stats
+- **Progress:** 0%
+- **Last Updated:** [date]
+
+## Velocity
+- Sessions completed: 0
+- Average duration: -
+- Phases completed: 0/7
+- Estimated time remaining: -

package/plantillas/especdev/es/config.yaml

@@ -0,0 +1,27 @@
+# Configuración del Proyecto Don Cheli
+proyecto:
+  nombre: "mi-proyecto"
+  tipo: "producto"  # producto|cli|app|libreria|servicio|refactor|correccion|poc
+  descripcion: ""
+  version: "0.1.0"
+
+# Modelos de IA
+modelos:
+  default: sonnet
+  agentes:
+    planificador: opus
+    arquitecto: opus
+    ejecutor: sonnet
+    revisor: opus
+    tester: sonnet
+    documentador: haiku
+    estimador: opus
+
+# Historial de sesiones
+historial:
+  habilitado: true
+  maxSesiones: 10
+  autoGuardar: true
+
+# Idioma
+idioma: "es"

package/plantillas/especdev/es/conocimiento.md

@@ -0,0 +1,19 @@
+# Conocimiento
+
+Patrones, convenciones y aprendizajes cross-sesión del proyecto. Se acumula y actualiza continuamente.
+
+## Patrones del Proyecto
+<!-- Convenciones de código, patrones arquitectónicos, estándares adoptados -->
+
+## APIs y Servicios Externos
+<!-- Endpoints, credenciales (referencia, no valores), rate limits, quirks -->
+
+## Errores Conocidos y Workarounds
+<!-- Problemas recurrentes y cómo resolverlos -->
+
+## Dependencias Críticas
+<!-- Versiones pinneadas, incompatibilidades conocidas -->
+
+---
+
+<!-- El conocimiento se actualiza con /especdev:memorizar y /especdev:cerrar-sesion -->

package/plantillas/especdev/es/constitucion-proyecto.md

@@ -0,0 +1,53 @@
+# Constitución del Proyecto
+
+Principios inmutables que rigen TODAS las decisiones del proyecto. Se validan en cada fase del ciclo. No se pueden override por specs individuales.
+
+## Principios Fundamentales
+<!-- ¿Cuáles son los valores no negociables de este proyecto? -->
+<!-- Ejemplo: "La privacidad del usuario es más importante que la conveniencia" -->
+
+1.
+2.
+3.
+
+## Restricciones Técnicas Irreversibles
+<!-- Decisiones de arquitectura que NO se cambian -->
+<!-- Ejemplo: "PostgreSQL como base de datos principal", "API REST, no GraphQL" -->
+
+-
+-
+
+## Restricciones de Negocio
+<!-- Límites que el negocio impone -->
+<!-- Ejemplo: "Presupuesto máximo de cloud: $500/mes", "Launch date: Q3 2026" -->
+
+-
+-
+
+## Estándares de Calidad Mínimos
+<!-- Umbrales que nunca se bajan -->
+<!-- Ejemplo: "Coverage ≥ 85%", "Latencia p99 < 500ms", "OWASP Top 10 sin hallazgos críticos" -->
+
+-
+-
+
+## Público Objetivo
+<!-- ¿Para quién es esto? ¿Quién NO es el público? -->
+
+**Es para:**
+-
+
+**NO es para:**
+-
+
+## Alcance Inmutable
+<!-- ¿Qué está definitivamente DENTRO y FUERA del scope? -->
+
+**Dentro:**
+-
+
+**Fuera (nunca):**
+-
+
+---
+*Este archivo se genera con `/especdev:iniciar` y se valida en cada puerta de calidad.*

package/plantillas/especdev/es/decisiones.md

@@ -0,0 +1,17 @@
+# Decisiones
+
+Registro append-only de decisiones técnicas y de producto. Nunca se borra — solo se agregan nuevas o se marcan como superseded.
+
+## Formato
+
+### DEC-NNN: [Título]
+- **Fecha:** YYYY-MM-DD
+- **Estado:** vigente | superseded por DEC-XXX
+- **Contexto:** [Por qué se tomó esta decisión]
+- **Decisión:** [Qué se decidió]
+- **Alternativas descartadas:** [Qué más se evaluó]
+- **Consecuencias:** [Qué implica]
+
+---
+
+<!-- Las decisiones se agregan aquí con /especdev:memorizar -->

package/plantillas/especdev/es/deuda-scope.md

@@ -0,0 +1,17 @@
+# Deuda de Scope
+
+Trabajo descubierto durante fixes, PoCs o implementación que está FUERA del alcance actual. Se registra aquí para no expandir el scope y se prioriza después.
+
+## Formato
+
+### DS-NNN: [Descripción corta]
+- **Descubierto en:** [Tarea/PoC/Fix donde se encontró]
+- **Fecha:** YYYY-MM-DD
+- **Prioridad estimada:** alta | media | baja
+- **Esfuerzo estimado:** < 1h | 1-4h | 1d | 1w+
+- **Contexto:** [Por qué apareció y por qué no se resolvió ahora]
+- **Estado:** pendiente | planificado | descartado
+
+---
+
+<!-- La deuda de scope se registra automáticamente durante /especdev:poc, /especdev:rapido y /especdev:implementar -->

package/plantillas/especdev/es/estado.md

@@ -0,0 +1,16 @@
+# Estado de Don Cheli
+
+## Actual
+- **Fase:** 1/7 (Descubrimiento)
+- **Tarea:** Definir el problema
+- **Bloqueador:** Ninguno
+
+## Estadísticas Rápidas
+- **Progreso:** 0%
+- **Última Actualización:** [fecha]
+
+## Velocidad
+- Sesiones completadas: 0
+- Duración promedio: -
+- Fases completadas: 0/7
+- Tiempo restante estimado: -

package/plantillas/especdev/es/hallazgos.md

@@ -0,0 +1,7 @@
+# Hallazgos
+
+Descubrimientos e insights del proyecto. Se actualiza continuamente.
+
+---
+
+<!-- Los hallazgos se agregan aquí con /especdev:memorizar -->

package/plantillas/especdev/es/plan.md

@@ -0,0 +1,35 @@
+# Plan del Proyecto
+
+## Fase 1: Descubrimiento
+- [ ] Validar el problema
+- [ ] Investigar soluciones existentes
+- [ ] Documentar hallazgos
+
+## Fase 2: Estrategia
+- [ ] Definir hoja de ruta
+- [ ] Establecer hitos
+- [ ] Tomar decisiones clave
+
+## Fase 3: Diseño
+- [ ] Arquitectura del sistema
+- [ ] Diseño de UX/UI
+- [ ] Especificaciones técnicas
+
+## Fase 4: Desarrollo
+- [ ] Implementar con TDD
+- [ ] Iterar sobre feedback
+
+## Fase 5: Calidad
+- [ ] Tests completos
+- [ ] Validación de rendimiento
+- [ ] Revisión de seguridad
+
+## Fase 6: Lanzamiento
+- [ ] Despliegue
+- [ ] Documentación final
+- [ ] Release notes
+
+## Fase 7: Crecimiento
+- [ ] Monitoreo
+- [ ] Feedback de usuarios
+- [ ] Iteración

package/plantillas/especdev/es/progreso.md

@@ -0,0 +1,7 @@
+# Progreso
+
+Log de sesión del proyecto. Se actualiza continuamente.
+
+---
+
+<!-- El progreso se registra automáticamente por el hook post-herramienta -->

package/plantillas/especdev/es/pseudocodigo.md

@@ -0,0 +1,35 @@
+# Pseudocódigo
+
+Lógica de alto nivel agnóstica de lenguaje/framework. Se genera DESPUÉS de especificar y ANTES de planificar. Fuerza al agente a razonar sobre la lógica sin comprometer tecnología.
+
+## [Feature/Módulo]
+
+### Flujo Principal
+```
+CUANDO usuario hace X
+  VALIDAR que Y
+  SI condición A
+    EJECUTAR acción B
+    PERSISTIR resultado en C
+    NOTIFICAR a D
+  SINO
+    RETORNAR error E
+```
+
+### Invariantes
+<!-- Condiciones que SIEMPRE deben ser verdad -->
+- [Invariante 1]
+- [Invariante 2]
+
+### Casos Límite
+<!-- Qué pasa en los bordes -->
+- [Edge case 1]: [comportamiento esperado]
+- [Edge case 2]: [comportamiento esperado]
+
+### Dependencias de Datos
+<!-- Qué datos necesita y de dónde vienen -->
+- [Dato 1] ← [Fuente]
+- [Dato 2] ← [Fuente]
+
+---
+*Se genera con `/especdev:pseudocodigo` entre especificar y planificar.*

package/plantillas/especdev/es/runtime.md

@@ -0,0 +1,26 @@
+# Runtime
+
+Información de ejecución del proyecto: endpoints, variables de entorno, servicios, puertos.
+
+## Endpoints Locales
+| Servicio | URL | Puerto |
+|----------|-----|--------|
+<!-- Se auto-genera durante /especdev:implementar -->
+
+## Variables de Entorno Requeridas
+| Variable | Descripción | Origen |
+|----------|-------------|--------|
+<!-- Se extrae de .env.example -->
+
+## Servicios Externos
+| Servicio | URL/Host | Plan | Rate Limit |
+|----------|----------|------|------------|
+<!-- Se documenta durante PoC y planificación -->
+
+## Comandos de Desarrollo
+```bash
+# Arrancar
+# Tests
+# Build
+# Deploy
+```

package/plantillas/especdev/estado.md

@@ -0,0 +1,16 @@
+# Estado de Don Cheli
+
+## Actual
+- **Fase:** 1/7 (Descubrimiento)
+- **Tarea:** Definir el problema
+- **Bloqueador:** Ninguno
+
+## Estadísticas Rápidas
+- **Progreso:** 0%
+- **Última Actualización:** [fecha]
+
+## Velocidad
+- Sesiones completadas: 0
+- Duración promedio: -
+- Fases completadas: 0/7
+- Tiempo restante estimado: -

package/plantillas/especdev/hallazgos.md

@@ -0,0 +1,7 @@
+# Hallazgos
+
+Descubrimientos e insights del proyecto. Se actualiza continuamente.
+
+---
+
+<!-- Los hallazgos se agregan aquí con /especdev:memorizar -->

package/plantillas/especdev/isa.yml

@@ -0,0 +1,152 @@
+# ISA — Arquitectura de Conjunto de Instrucciones para BDD
+
+# Mapea tipos de pasos Gherkin a patrones de código de test.
+# Adaptado de Specular (pei9564/Specular) y traducido al español.
+#
+# Este archivo define la "arquitectura de instrucciones" que conecta
+# cada tipo de paso Gherkin con su implementación en tests.
+#
+# CÓMO MEJORA EL FRAMEWORK:
+# Sin ISA, el agente inventa patrones de test diferentes cada vez.
+# Con ISA, la generación de tests es CONSISTENTE y PREDECIBLE.
+# Cada escenario Gherkin mapea a un patrón de test bien definido.
+
+# ============================================================
+# Compartido: Contrato de conftest.py para TODOS los tipos
+# ============================================================
+compartido:
+  contexto_fixture:
+    descripcion: |
+      Diccionario mutable, portador de estado para Dado → Cuando → Entonces.
+      Proporcionado por tests/integracion/conftest.py como fixture de pytest.
+    claves:
+      - "contexto['datos_base_*']  ← Pasos Dado (datos mock de tablas Gherkin)"
+      - "contexto['resultado']     ← Paso Cuando (valor de retorno o excepción capturada)"
+      - "contexto['payload']       ← (tipos API) Pasos Cuando acumulan de tablas de datos"
+      - "contexto['respuesta']     ← (tipos API) asegurar_llamado() cachea la respuesta"
+      - "contexto['config']        ← (tipos Servicio) Pasos Dado configuran objeto de config"
+
+  helpers:
+    - nombre: "tabla_a_dicts"
+      ubicacion: "tests/integracion/conftest.py"
+      firma: "tabla_a_dicts(datatable: list[list[str]]) -> list[dict]"
+      descripcion: "Convierte datatable de pytest-bdd a list[dict]. NUNCA parsear datatables manualmente."
+
+  reglas_limite:
+    conftest_posee:
+      - "fixture contexto (dict[str, Any])"
+      - "helper tabla_a_dicts()"
+      - "fixtures app / client (solo tipos API)"
+      - "Pasos Dado comunes: entidades de fondo, middleware de auth"
+    archivo_feature_posee:
+      - "decoradores @scenario() (1:1 desde Gherkin)"
+      - "Pasos Dado específicos del feature"
+      - "Pasos Cuando específicos del feature"
+      - "Pasos Entonces específicos del feature"
+    prevencion_colision:
+      - "Nombres de función DEBEN incluir contexto de dominio o feature"
+      - "MAL:  cuando_crear_recurso, entonces_fallo"
+      - "BIEN: cuando_ejecutar_creacion_usuario, entonces_creacion_usuario_deberia_fallar"
+
+# ============================================================
+# Tipo API: Flujo HTTP client
+# ============================================================
+api:
+  flujo_contexto:
+    cuando_acumula: "contexto['payload']"
+    disparador_almacena: "contexto['respuesta']"
+    funcion_disparador: "asegurar_llamado(contexto, client, {{ mock_repo }})"
+
+  definiciones:
+    # --- CONFIGURACION_MOCK (Dado) ---
+    - patron: "el sistema tiene los siguientes {tipo_entidad}:"
+      tipo: "CONFIGURACION_MOCK"
+      contexto: "Dado"
+      notas: "Parsear tabla de datos en contexto para configuración de mock."
+
+    # --- LLAMADA_API (Cuando) ---
+    - patron: "el usuario crea {recurso}:"
+      tipo: "LLAMADA_API"
+      contexto: "Cuando"
+      notas: "Parsear tabla field/value en contexto['payload']."
+
+    # --- DISPARADOR_API ---
+    - patron: "(interno — llamado por pasos Entonces)"
+      tipo: "DISPARADOR_API"
+      contexto: "Entonces (interno)"
+      notas: |
+        asegurar_llamado() configura mocks, dispara el request HTTP,
+        y cachea la respuesta. Idempotente: dispara solo una vez por escenario.
+
+    # --- ASERCION_API (Entonces) ---
+    - patron: "el {recurso} debería crearse exitosamente"
+      tipo: "ASERCION_API"
+      contexto: "Entonces"
+      notas: "Verificar status 201 y campos del body."
+
+    - patron: "la creación debería fallar"
+      tipo: "ASERCION_API"
+      contexto: "Entonces"
+      notas: "Verificar status >= 400."
+
+    - patron: "el mensaje de error debería indicar \"{texto}\""
+      tipo: "ASERCION_API"
+      contexto: "Entonces"
+      notas: "Verificar que el mensaje de error contiene el texto."
+
+    # --- ASERCION_BD (Entonces) ---
+    - patron: "la tabla {tabla} debería contener:"
+      tipo: "ASERCION_BD"
+      contexto: "Entonces"
+      notas: "Verificar campos de respuesta contra tabla de datos."
+
+# ============================================================
+# Tipo Servicio: Llamada directa al servicio
+# ============================================================
+servicio:
+  flujo_contexto:
+    dado_acumula: "contexto['config']"
+    cuando_almacena: "contexto['resultado']"
+    descripcion: |
+      Sin HTTP client involucrado. Los pasos Cuando llaman al método del servicio directamente.
+      contexto["resultado"] almacena el valor de retorno o la excepción capturada.
+
+  definiciones:
+    # --- CONFIGURACION (Dado) ---
+    - patron: "el sistema está configurado con:"
+      tipo: "CONFIGURACION"
+      contexto: "Dado"
+      notas: "Parsear tabla de configuración en contexto['config']."
+
+    # --- LLAMADA_SERVICIO (Cuando) ---
+    - patron: "el sistema ejecuta {operacion}"
+      tipo: "LLAMADA_SERVICIO"
+      contexto: "Cuando"
+      notas: "Invocar método del servicio directamente. Capturar excepciones."
+
+    # --- ASERCION_SERVICIO (Entonces) ---
+    - patron: "la operación debería completarse exitosamente"
+      tipo: "ASERCION_SERVICIO"
+      contexto: "Entonces"
+      notas: "Verificar que resultado no es excepción."
+
+    - patron: "el resultado debería contener:"
+      tipo: "ASERCION_SERVICIO"
+      contexto: "Entonces"
+      notas: "Verificar campos del resultado contra tabla de datos."
+
+    # --- ASERCION_EXCEPCION (Entonces) ---
+    - patron: "la operación debería fallar"
+      tipo: "ASERCION_EXCEPCION"
+      contexto: "Entonces"
+      notas: "Verificar que resultado es una excepción."
+
+    - patron: "el tipo de error debería ser \"{tipo_excepcion}\""
+      tipo: "ASERCION_EXCEPCION"
+      contexto: "Entonces"
+      notas: "Verificar nombre de clase de excepción."
+
+    - patron: "el mensaje de error debería contener \"{texto}\""
+      tipo: "ASERCION_EXCEPCION"
+      contexto: "Entonces"
+      notas: "Verificar que el mensaje de excepción contiene el texto."

package/plantillas/especdev/plan.md

@@ -0,0 +1,35 @@
+# Plan del Proyecto
+
+## Fase 1: Descubrimiento
+- [ ] Validar el problema
+- [ ] Investigar soluciones existentes
+- [ ] Documentar hallazgos
+
+## Fase 2: Estrategia
+- [ ] Definir hoja de ruta
+- [ ] Establecer hitos
+- [ ] Tomar decisiones clave
+
+## Fase 3: Diseño
+- [ ] Arquitectura del sistema
+- [ ] Diseño de UX/UI
+- [ ] Especificaciones técnicas
+
+## Fase 4: Desarrollo
+- [ ] Implementar con TDD
+- [ ] Iterar sobre feedback
+
+## Fase 5: Calidad
+- [ ] Tests completos
+- [ ] Validación de rendimiento
+- [ ] Revisión de seguridad
+
+## Fase 6: Lanzamiento
+- [ ] Despliegue
+- [ ] Documentación final
+- [ ] Release notes
+
+## Fase 7: Crecimiento
+- [ ] Monitoreo
+- [ ] Feedback de usuarios
+- [ ] Iteración

package/plantillas/especdev/progreso.md

@@ -0,0 +1,7 @@
+# Progreso
+
+Log de sesión del proyecto. Se actualiza continuamente.
+
+---
+
+<!-- El progreso se registra automáticamente por el hook post-herramienta -->

package/plantillas/especdev/pt/config.yaml

@@ -0,0 +1,27 @@
+# Configuração do Projeto Don Cheli
+projeto:
+  nome: "meu-projeto"
+  tipo: "produto"  # produto|cli|app|biblioteca|servico|refatoracao|correcao|poc
+  descricao: ""
+  versao: "0.1.0"
+
+# Modelos de IA
+modelos:
+  padrao: sonnet
+  agentes:
+    planejador: opus
+    arquiteto: opus
+    executor: sonnet
+    revisor: opus
+    testador: sonnet
+    documentador: haiku
+    estimador: opus
+
+# Histórico de sessões
+historico:
+  habilitado: true
+  maxSessoes: 10
+  autoSalvar: true
+
+# Idioma
+idioma: "pt"

package/plantillas/especdev/pt/conhecimento.md

@@ -0,0 +1,19 @@
+# Conhecimento
+
+Padrões, convenções e aprendizados cross-sessão do projeto. Acumulado e atualizado continuamente.
+
+## Padrões do Projeto
+<!-- Convenções de código, padrões arquitetônicos, padrões adotados -->
+
+## APIs e Serviços Externos
+<!-- Endpoints, credenciais (referência, não valores), rate limits, quirks -->
+
+## Erros Conhecidos e Workarounds
+<!-- Problemas recorrentes e como resolvê-los -->
+
+## Dependências Críticas
+<!-- Versões fixadas, incompatibilidades conhecidas -->
+
+---
+
+<!-- O conhecimento é atualizado com /especdev:memorizar e /especdev:cerrar-sesion -->

package/plantillas/especdev/pt/constituicao-projeto.md

@@ -0,0 +1,53 @@
+# Constituição do Projeto
+
+Princípios imutáveis que regem TODAS as decisões do projeto. Validados em cada fase do ciclo. Não podem ser sobrescritos por specs individuais.
+
+## Princípios Fundamentais
+<!-- Quais são os valores inegociáveis deste projeto? -->
+<!-- Exemplo: "A privacidade do usuário é mais importante que a conveniência" -->
+
+1.
+2.
+3.
+
+## Restrições Técnicas Irreversíveis
+<!-- Decisões de arquitetura que NÃO serão alteradas -->
+<!-- Exemplo: "PostgreSQL como banco de dados principal", "API REST, não GraphQL" -->
+
+-
+-
+
+## Restrições de Negócio
+<!-- Limites impostos pelo negócio -->
+<!-- Exemplo: "Orçamento máximo de cloud: $500/mês", "Data de lançamento: Q3 2026" -->
+
+-
+-
+
+## Padrões Mínimos de Qualidade
+<!-- Limiares que nunca são reduzidos -->
+<!-- Exemplo: "Coverage ≥ 85%", "Latência p99 < 500ms", "OWASP Top 10 sem achados críticos" -->
+
+-
+-
+
+## Público-Alvo
+<!-- Para quem é isso? Quem NÃO é o público? -->
+
+**É para:**
+-
+
+**NÃO é para:**
+-
+
+## Escopo Imutável
+<!-- O que está definitivamente DENTRO e FORA do escopo? -->
+
+**Dentro:**
+-
+
+**Fora (nunca):**
+-
+
+---
+*Este arquivo é gerado com `/especdev:iniciar` e validado em cada porta de qualidade.*

package/plantillas/especdev/pt/decisoes.md

@@ -0,0 +1,17 @@
+# Decisões
+
+Registro append-only de decisões técnicas e de produto. Nunca é apagado — apenas novas decisões são adicionadas ou marcadas como substituídas.
+
+## Formato
+
+### DEC-NNN: [Título]
+- **Data:** YYYY-MM-DD
+- **Status:** vigente | substituída por DEC-XXX
+- **Contexto:** [Por que esta decisão foi tomada]
+- **Decisão:** [O que foi decidido]
+- **Alternativas descartadas:** [O que mais foi avaliado]
+- **Consequências:** [O que isso implica]
+
+---
+
+<!-- As decisões são adicionadas aqui com /especdev:memorizar -->

package/plantillas/especdev/pt/descobertas.md

@@ -0,0 +1,7 @@
+# Descobertas
+
+Descobertas e insights do projeto. Atualizado continuamente.
+
+---
+
+<!-- Descobertas são adicionadas aqui com /especdev:memorizar -->