don-cheli-sdd 1.13.0

package/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/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "don-cheli-sdd",
+  "version": "1.13.0",
+  "description": "Framework SDD para Claude Code — 72+ comandos, 43 habilidades, 15 modelos de razonamiento. TDD como ley de hierro. EN/ES/PT.",
+  "main": "scripts/instalar.sh",
+  "scripts": {
+    "instalar": "bash scripts/instalar.sh",
+    "bucle": "bash scripts/bucle.sh",
+    "validar": "bash scripts/validar.sh"
+  },
+  "keywords": [
+    "claude-code", "sdd", "ai-framework", "prompt-engineering",
+    "developer-tools", "tdd", "llm", "especificaciones", "español",
+    "agentes-ia", "claude-ai", "spec-driven-development", "rlm",
+    "estimados"
+  ],
+  "homepage": "https://www.doncheli.tv",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/doncheli/don-cheli-sdd.git"
+  },
+  "bugs": {
+    "url": "https://github.com/doncheli/don-cheli-sdd/issues"
+  },
+  "author": "Jose Luis Oronoz Troconis <@doncheli>",
+  "license": "Apache-2.0",
+  "bin": {
+    "don-cheli": "./scripts/instalar.sh"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "comandos/",
+    "habilidades/",
+    "reglas/",
+    "plantillas/",
+    "agentes/",
+    "ganchos/",
+    "scripts/",
+    "locales/",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "prompt.md",
+    "VERSION",
+    "CHANGELOG.md"
+  ]
+}

package/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/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/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/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/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/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/plantillas/especdev/en/decisions.md

@@ -0,0 +1,17 @@
+# Decisions
+
+Append-only log of technical and product decisions. Never deleted — only new ones are added or existing ones marked as superseded.
+
+## Format
+
+### DEC-NNN: [Title]
+- **Date:** YYYY-MM-DD
+- **Status:** active | superseded by DEC-XXX
+- **Context:** [Why this decision was made]
+- **Decision:** [What was decided]
+- **Alternatives:** [What else was evaluated]
+- **Consequences:** [What this implies]
+
+---
+
+<!-- Decisions are added here with /especdev:memorizar -->

package/plantillas/especdev/en/deferred-work.md

@@ -0,0 +1,17 @@
+# Deferred Work
+
+Work discovered during fixes, PoCs, or implementation that is OUTSIDE the current scope. Logged here to prevent scope creep and prioritized later.
+
+## Format
+
+### DW-NNN: [Short description]
+- **Discovered in:** [Task/PoC/Fix where it was found]
+- **Date:** YYYY-MM-DD
+- **Estimated priority:** high | medium | low
+- **Estimated effort:** < 1h | 1-4h | 1d | 1w+
+- **Context:** [Why it came up and why it wasn't resolved now]
+- **Status:** pending | planned | discarded
+
+---
+
+<!-- Deferred work is automatically logged during /especdev:poc, /especdev:rapido and /especdev:implementar -->

package/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/plantillas/especdev/en/knowledge.md

@@ -0,0 +1,19 @@
+# Knowledge
+
+Patterns, conventions and cross-session learnings for the project. Continuously accumulated and updated.
+
+## Project Patterns
+<!-- Code conventions, architectural patterns, adopted standards -->
+
+## External APIs & Services
+<!-- Endpoints, credentials (reference only, not values), rate limits, quirks -->
+
+## Known Issues & Workarounds
+<!-- Recurring problems and how to solve them -->
+
+## Critical Dependencies
+<!-- Pinned versions, known incompatibilities -->
+
+---
+
+<!-- Knowledge is updated with /especdev:memorizar and /especdev:cerrar-sesion -->

package/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/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/plantillas/especdev/en/project-constitution.md

@@ -0,0 +1,53 @@
+# Project Constitution
+
+Immutable principles that govern ALL project decisions. Validated at every phase gate. Cannot be overridden by individual specs.
+
+## Core Principles
+<!-- What are the non-negotiable values of this project? -->
+<!-- Example: "User privacy is more important than convenience" -->
+
+1.
+2.
+3.
+
+## Irreversible Technical Constraints
+<!-- Architecture decisions that will NOT change -->
+<!-- Example: "PostgreSQL as primary database", "REST API, not GraphQL" -->
+
+-
+-
+
+## Business Constraints
+<!-- Limits imposed by the business -->
+<!-- Example: "Maximum cloud budget: $500/month", "Launch date: Q3 2026" -->
+
+-
+-
+
+## Minimum Quality Standards
+<!-- Thresholds that are never lowered -->
+<!-- Example: "Coverage ≥ 85%", "p99 latency < 500ms", "OWASP Top 10 with no critical findings" -->
+
+-
+-
+
+## Target Audience
+<!-- Who is this for? Who is NOT the audience? -->
+
+**This is for:**
+-
+
+**NOT for:**
+-
+
+## Immutable Scope
+<!-- What is definitively IN and OUT of scope? -->
+
+**In scope:**
+-
+
+**Out of scope (never):**
+-
+
+---
+*This file is generated with `/especdev:iniciar` and validated at every quality gate.*

package/plantillas/especdev/en/pseudocode.md

@@ -0,0 +1,35 @@
+# Pseudocode
+
+High-level logic agnostic of language/framework. Generated AFTER specifying and BEFORE planning. Forces the agent to reason about logic without committing to technology.
+
+## [Feature/Module]
+
+### Main Flow
+```
+WHEN user does X
+  VALIDATE that Y
+  IF condition A
+    EXECUTE action B
+    PERSIST result in C
+    NOTIFY D
+  ELSE
+    RETURN error E
+```
+
+### Invariants
+<!-- Conditions that MUST always be true -->
+- [Invariant 1]
+- [Invariant 2]
+
+### Edge Cases
+<!-- What happens at the boundaries -->
+- [Edge case 1]: [expected behavior]
+- [Edge case 2]: [expected behavior]
+
+### Data Dependencies
+<!-- What data is needed and where it comes from -->
+- [Data 1] ← [Source]
+- [Data 2] ← [Source]
+
+---
+*Generated with `/especdev:pseudocodigo` between specifying and planning.*