don-cheli-sdd 1.13.0

package/scripts/.claude/don-cheli/locales/pt.json

@@ -0,0 +1,179 @@
+{
+  "installer": {
+    "banner_line1": "Don Cheli — SDD Framework v{{version}}",
+    "banner_line2": "Pare de improvisar. Comece 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": "Opção inválida. Selecione 1, 2 ou 3.",
+    "language_selected": "Idioma selecionado: {{language}}",
+    "mode_global": "Modo: Instalação global",
+    "mode_local": "Modo: Instalação local no projeto atual",
+    "framework_path": "Framework: {{path}}",
+    "commands_path": "Comandos: {{path}}",
+    "step_structure": "Criando estrutura...",
+    "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 regras...",
+    "step_rules_done": "{{count}} regras",
+    "step_templates": "Copiando modelos...",
+    "step_templates_done": "Modelos copiados",
+    "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 arquivos de referência...",
+    "step_reference_done": "CLAUDE.md, AGENTS.md, prompt.md, NOTICE",
+    "success_title": "Don Cheli v{{version}} instalado com sucesso",
+    "structure_title": "Estrutura instalada:",
+    "structure_skills": "habilidades",
+    "structure_rules": "regras",
+    "structure_templates": "modelos",
+    "structure_hooks": "ganchos",
+    "structure_agents": "agentes",
+    "structure_commands": "comandos",
+    "next_steps_title": "Próximos passos:",
+    "next_step_1": "Reinicie o Claude Code",
+    "next_step_2": "Em qualquer projeto execute: /especdev:iniciar",
+    "farewell": "Pare de improvisar. Comece a entregar!"
+  },
+  "framework": {
+    "identity": "Você é um assistente de desenvolvimento que opera sob o framework Don Cheli (Desenvolvimento Orientado por Especificações).",
+    "language_instruction": "SEMPRE responda em português. Código (variáveis, funções) em inglês. Documentação, commits e comunicação em português.",
+    "phases": {
+      "0": "Inicialização",
+      "1": "Proposta",
+      "2": "Especificação",
+      "3": "Clarificação",
+      "4": "Design técnico",
+      "5": "Planejamento",
+      "6": "Detalhamento",
+      "7": "Implementação",
+      "8": "Revisão"
+    },
+    "status": {
+      "pending": "Pendente",
+      "in_progress": "Em andamento",
+      "completed": "Concluída",
+      "approved": "Aprovada",
+      "blocked": "Bloqueada"
+    },
+    "project_types": {
+      "produto": "Produto completo novo",
+      "cli": "Aplicação de linha de comando",
+      "app": "Aplicação desktop/móvel",
+      "libreria": "Pacote reutilizável",
+      "servico": "Microsserviço/API",
+      "refactor": "Refactoring existente",
+      "correcao": "Correção de bug"
+    },
+    "verdicts": {
+      "viable": "VIÁVEL — Prosseguir com a implementação",
+      "viable_with_reservations": "VIÁVEL COM RESSALVAS — Documentar limitações",
+      "not_viable": "NÃO VIÁVEL — Explorar alternativas",
+      "inconclusive": "INCONCLUSIVO — Reformular hipótese"
+    },
+    "review": {
+      "approved": "APROVADO",
+      "approved_with_observations": "APROVADO COM OBSERVAÇÕES",
+      "rejected": "REJEITADO",
+      "pending": "PENDENTE DE APROVAÇÃO"
+    },
+    "priorities": {
+      "p1": "Caminho Crítico",
+      "p2": "Importante",
+      "p3": "Desejável"
+    },
+    "severity": {
+      "critical": "Crítico",
+      "high": "Alto",
+      "medium": "Médio",
+      "low": "Baixo"
+    },
+    "tdd": {
+      "red": "Escrever teste que FALHA",
+      "green": "Implementar código MÍNIMO para passar",
+      "refactor": "Limpar sem alterar comportamento"
+    },
+    "iron_laws": {
+      "1": "Todo código de produção requer testes",
+      "2": "Primeiro a causa raiz, depois a correção",
+      "3": "Evidência antes de afirmações"
+    }
+  },
+  "commands": {
+    "iniciar": {
+      "initialized": "Don Cheli inicializado",
+      "project": "Projeto",
+      "type": "Tipo",
+      "directory": "Diretório",
+      "files_created": "arquivos criados",
+      "next_step": "Próximo passo: edite .especdev/plan.md para definir suas fases",
+      "already_exists": ".especdev/ já existe. Deseja sobrescrever ou reparar?"
+    },
+    "estado": {
+      "current_phase": "Fase Atual",
+      "next_phase": "Próxima Fase",
+      "summary": "Resumo",
+      "phase_history": "Histórico de Fases"
+    },
+    "proponer": {
+      "intention": "Intenção (POR QUÊ)",
+      "scope": "Escopo (O QUÊ)",
+      "included": "Incluído",
+      "excluded": "Excluído",
+      "approach": "Abordagem (COMO)",
+      "risks": "Riscos",
+      "estimate": "Estimativa Preliminar",
+      "open_questions": "Perguntas em Aberto",
+      "pending_approval": "PENDENTE DE APROVAÇÃO"
+    },
+    "clarificar": {
+      "ambiguities_detected": "Ambiguidades Detectadas",
+      "schema_check": "Verificação Schema-Spec",
+      "convention_check": "Verificação de Convenções",
+      "auto_generated_audit": "Auditoria Auto-Gerado",
+      "result": "Resultado",
+      "pass": "PASSA",
+      "fail": "FALHA",
+      "advance": "AVANÇAR",
+      "no_advance": "NÃO-AVANÇAR"
+    },
+    "implementar": {
+      "phase_setup": "Fase 1: Setup",
+      "phase_foundation": "Fase 2: Fundação",
+      "phase_stories": "Fase 3: Histórias de Usuário",
+      "phase_polish": "Fase 4: Polish",
+      "phase_verify": "Fase 5: Verificação Final",
+      "checkpoint_verify": "CHECKPOINT: verificar",
+      "checkpoint_decision": "CHECKPOINT: decisão",
+      "checkpoint_human": "CHECKPOINT: ação-humana",
+      "all_tests_pass": "Todos os testes passam. Feature implementada com sucesso."
+    },
+    "revisar": {
+      "functional": "Correção Funcional",
+      "tests": "Testes e Cobertura",
+      "performance": "Desempenho",
+      "architecture": "Arquitetura e Design",
+      "security": "Segurança",
+      "style": "Estilo e Convenções",
+      "diff": "Diff Limpo"
+    },
+    "diagnostico": {
+      "structure": "Estrutura",
+      "configuration": "Configuração",
+      "environment": "Ambiente",
+      "pipeline": "Pipeline",
+      "healthy": "SAUDÁVEL",
+      "functional": "FUNCIONAL",
+      "needs_attention": "REQUER ATENÇÃO",
+      "warnings": "Avisos"
+    }
+  }
+}

package/scripts/.claude/don-cheli/plantillas/checklist-requisitos.md

@@ -0,0 +1,31 @@
+# Checklist de Requisitos
+
+## Feature: [nombre]
+## Dominio: [dominio]
+## Estado: @borrador
+
+---
+
+### Verificación de Completitud
+
+| # | Check | Estado | Evidencia |
+|---|-------|--------|-----------|
+| 1 | Cada Regla tiene al menos un escenario happy path | [ ] | |
+| 2 | Cada Regla tiene al menos un escenario sad path | [ ] | |
+| 3 | Campos del Gherkin coinciden con DBML | [ ] | |
+| 4 | Campos NOT NULL tienen escenario de validación | [ ] | |
+| 5 | Convención de nombres correcta (COMMAND/QUERY) | [ ] | |
+| 6 | Sin escenarios @auto_generated redundantes | [ ] | |
+
+### Puerta de Auditoría
+
+| # | Item | Estado |
+|---|------|--------|
+| 1 | Mejoras de cobertura identificadas | [ ] |
+| 2 | Riesgos de boundary identificados | [ ] |
+| 3 | Todos los items de auditoría resueltos | [ ] |
+
+### Resultado
+
+- [ ] ✅ AVANZAR → Marcar spec como `@lista`
+- [ ] ❌ NO-AVANZAR → Resolver issues pendientes

package/scripts/.claude/don-cheli/plantillas/docker/Dockerfile

@@ -0,0 +1,16 @@
+# Dockerfile para Don Cheli
+# Entorno de ejecución de tests y lint
+
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Instalar dependencias
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt 2>/dev/null || true
+
+# Copiar código
+COPY . .
+
+# Comando por defecto: ejecutar tests
+CMD ["pytest", "-v", "--tb=short"]

package/scripts/.claude/don-cheli/plantillas/docker/docker-compose.yml

@@ -0,0 +1,28 @@
+# docker-compose.yml para Don Cheli
+# Servicios: test, lint, reporte
+
+services:
+  test:
+    build: .
+    command: pytest -v --tb=short
+    volumes:
+      - .:/app
+    environment:
+      - PYTHONDONTWRITEBYTECODE=1
+
+  lint:
+    build: .
+    command: |
+      sh -c "
+        flake8 app/ --max-line-length=120 --ignore=E501 &&
+        mypy app/ --ignore-missing-imports
+      "
+    volumes:
+      - .:/app
+
+  reporte:
+    build: .
+    command: pytest --html=reports/test-report.html --self-contained-html -v
+    volumes:
+      - .:/app
+      - ./reports:/app/reports

package/scripts/.claude/don-cheli/plantillas/especdev/WORKFLOW.md

@@ -0,0 +1,118 @@
+---
+description: Plantilla WORKFLOW.md — contrato de workflow versionado en el repositorio
+---
+
+# WORKFLOW.md — Contrato de Workflow
+
+## Qué Es
+
+`WORKFLOW.md` es un archivo que vive en tu repositorio y define el **comportamiento completo** del agente para ese proyecto. Es la unión de configuración + prompt en un solo archivo versionado.
+
+> Adaptado de OpenAI Symphony — el contrato que conecta issue tracker → agente → código.
+
+## Por Qué Importa
+
+Sin WORKFLOW.md, la configuración del agente vive:
+- En tu cabeza → no reproducible
+- En CLAUDE.md → no portable entre agentes
+- En configs sueltas → difíciles de versionar
+
+Con WORKFLOW.md, el **workflow es código** — versionado, revisable, reproducible.
+
+## Formato
+
+YAML front matter + cuerpo Markdown (prompt):
+
+```markdown
+---
+# === Configuración Runtime ===
+nombre: "mi-proyecto"
+version: "1.0.0"
+
+# Agente
+agente:
+  modelo: "sonnet"
+  max_turnos: 15
+  timeout_sesion_ms: 1800000  # 30 min
+  max_reintentos: 3
+  max_backoff_reintento_ms: 300000  # 5 min
+
+# Concurrencia
+concurrencia:
+  max_agentes: 3
+  max_por_estado:
+    en_progreso: 2
+    revision: 1
+
+# Workspace
+workspace:
+  raiz: ".especdev/workspaces"
+  hooks:
+    despues_crear: "npm install"
+    antes_ejecutar: "git pull origin main"
+    despues_ejecutar: "npm run lint && npm test"
+
+# Stop Hooks
+hooks_parar:
+  - nombre: "Lint"
+    comando: "npm run lint"
+    obligatorio: true
+  - nombre: "Tests"
+    comando: "npm test"
+    obligatorio: true
+
+# Tracker (opcional)
+tracker:
+  tipo: "github-issues"  # linear | github-issues | jira
+  estados_activos: ["todo", "en progreso"]
+  estados_terminales: ["done", "cerrado", "cancelado"]
+
+# Prueba de Trabajo
+prueba_trabajo:
+  ci_status: true
+  complejidad: true
+  walkthrough_video: false
+---
+
+# Prompt del Workflow
+
+Eres un agente de desarrollo trabajando en el proyecto {{nombre}}.
+
+## Tu Rol
+- Implementar las tareas asignadas siguiendo las specs en `specs/`
+- Seguir las convenciones del proyecto en `.especdev/reglas/`
+- Crear PRs con prueba de trabajo completa
+
+## Proceso
+1. Leer la tarea asignada: {{tarea.titulo}}
+2. Revisar specs relevantes en `specs/features/`
+3. Crear branch: `feature/{{tarea.identificador}}`
+4. Implementar con TDD (RED → GREEN → REFACTOR)
+5. Ejecutar stop hooks
+6. Crear PR con prueba de trabajo
+7. Solicitar revisión humana
+
+## Restricciones
+- NO modificar archivos fuera del alcance de la tarea
+- NO commitear sin que los tests pasen
+- Si hay ambigüedad, PARAR y preguntar
+```
+
+## Variables de Template
+
+| Variable | Origen | Ejemplo |
+|----------|--------|---------|
+| `{{nombre}}` | Front matter | "mi-proyecto" |
+| `{{tarea.titulo}}` | Issue tracker | "Agregar login OAuth" |
+| `{{tarea.identificador}}` | Issue tracker | "PROJ-42" |
+| `{{tarea.descripcion}}` | Issue tracker | Cuerpo del issue |
+| `{{tarea.prioridad}}` | Issue tracker | 1 (urgente) |
+
+## Precedencia de Configuración
+
+```
+1. Variables de entorno (más alta)
+2. WORKFLOW.md front matter
+3. .especdev/config.yaml
+4. Defaults del framework (más baja)
+```

package/scripts/.claude/don-cheli/plantillas/especdev/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/scripts/.claude/don-cheli/plantillas/especdev/en/config.yaml

@@ -0,0 +1,27 @@
+# Don Cheli Project Configuration
+project:
+  name: "my-project"
+  type: "product"  # product|cli|app|library|service|refactor|bugfix|poc
+  description: ""
+  version: "0.1.0"
+
+# AI Models
+models:
+  default: sonnet
+  agents:
+    planner: opus
+    architect: opus
+    executor: sonnet
+    reviewer: opus
+    tester: sonnet
+    documenter: haiku
+    estimator: opus
+
+# Session history
+history:
+  enabled: true
+  maxSessions: 10
+  autoSave: true
+
+# Language
+language: "en"

package/scripts/.claude/don-cheli/plantillas/especdev/en/findings.md

@@ -0,0 +1,7 @@
+# Findings
+
+Discoveries and insights from the project. Updated continuously.
+
+---
+
+<!-- Findings are added here with /especdev:memorizar -->

package/scripts/.claude/don-cheli/plantillas/especdev/en/plan.md

@@ -0,0 +1,35 @@
+# Project Plan
+
+## Phase 1: Discovery
+- [ ] Validate the problem
+- [ ] Research existing solutions
+- [ ] Document findings
+
+## Phase 2: Strategy
+- [ ] Define roadmap
+- [ ] Establish milestones
+- [ ] Make key decisions
+
+## Phase 3: Design
+- [ ] System architecture
+- [ ] UX/UI design
+- [ ] Technical specifications
+
+## Phase 4: Development
+- [ ] Implement with TDD
+- [ ] Iterate on feedback
+
+## Phase 5: Quality
+- [ ] Complete tests
+- [ ] Performance validation
+- [ ] Security review
+
+## Phase 6: Launch
+- [ ] Deployment
+- [ ] Final documentation
+- [ ] Release notes
+
+## Phase 7: Growth
+- [ ] Monitoring
+- [ ] User feedback
+- [ ] Iteration

package/scripts/.claude/don-cheli/plantillas/especdev/en/progress.md

@@ -0,0 +1,7 @@
+# Progress
+
+Project session log. Updated continuously.
+
+---
+
+<!-- Progress is recorded automatically by the post-tool hook -->

package/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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/scripts/.claude/don-cheli/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 -->