sddadd

La Plantilla de Inicio SDD + ADD es un marco de gobernanza para asistentes de programación con IA, especialmente Claude Code. Su objetivo principal es transformar al asistente de IA en un socio de desarrollo disciplinado que trabaje según un flujo de Desarrollo Dirigido por Especificaciones (SDD) combinado con Desarrollo Dirigido por Agentes (ADD). ## Flujo de Trabajo Principal La plantilla aplica un flujo de desarrollo secuencial: CONTEXTO → ESPECIFICACIÓN → PLAN → TAREAS → ejecutar → verificar → sincronizar. Cada paso tiene un punto de control y requiere aprobación humana antes de que el agente pueda ejecutar. ## Tres Reglas Fundamentales 1. **Edita la Especificación, no el Código**: Cuando falta un requisito o es ambiguo, usa el comando `/sdd-update` para actualizar primero la especificación, luego revísala antes de cambiar el comportamiento. 2. **Sin Especulación Técnica**: El Plan, las Tareas y la ejecución usan solo los enlaces y comandos de verificación exactos aprobados en `.sdd/architecture-profile.md`. 3. **Los Humanos Deciden**: El agente no se autoaprueba, no hace `git push`, no despliega y no realiza cambios de estado físico de forma autónoma. ## Propiedad y Ejecución La plantilla separa dos ejes independientes en `.sdd/shared_context.md`: - **Propiedad del Proyecto** (`solo` o `team`): Determina la validez de la revisión humana y la política de entrega de Git. Por defecto es `team`. - **Ejecución del Agente** (`direct` o `orchestrated`): `/add-execute` se ejecuta directamente en el agente actual u orquesta trabajadores después de observar las capacidades del entorno. ## Documentación La plantilla proporciona un sistema de documentación integral: - **Inicio Rápido** (`docs/sdd-add-quickstart.md`): Hoja de ruta paso a paso para nuevos usuarios. - **Guía de Operaciones** (`docs/sdd-add-guide.md`): Comprende artefactos, compuertas y propiedad. - **Referencia Rápida** (`docs/sdd-add-field-guide.md`): Elige comandos según el escenario. - **Manual de Escenarios** (`docs/sdd-add-scenario-playbook.md`): Maneja proyectos nuevos, existentes, errores y transferencias. - **Guía de Perfil de Arquitectura** (`docs/architecture-profile-guide.md`): Selecciona enlaces y comandos técnicos. - **Guía de Ejecución** (`docs/multi-agent-orchestration-guide.md`): Ejecuta tareas/funcionalidades y orquestación de trabajadores. ## Fuentes Canónicas - `.claude/skills/`: Contratos para comandos. - `.claude/skills/_shared/ai-review-protocol.md`: Protocolo de revisión, metodología y Registro de Acciones. - `.sdd/architecture-profile.md`: Enlaces técnicos y comandos de verificación exactos. - `CONSTITUTION.md`: Reglas estrictas sobre seguridad, arquitectura y calidad. - `AGENTS.md`: Alcance y permisos del agente. ## Scripts de Utilidad - `scripts/self-heal.sh`: Ejecuta un comando aprobado para recopilar evidencia; no modifica el código fuente ni reintenta. - `scripts/template-smoke.sh` / `.ps1`: Comprobaciones estáticas de archivos, enlaces y contratos de políticas. - `scripts/adopt.*`: Adopta la plantilla en un repositorio existente. - `scripts/update.*`: Obtiene actualizaciones de la plantilla; los archivos de gobernanza se preparan para revisión humana.