sddadd

O Modelo Inicial SDD + ADD é uma estrutura de governança para assistentes de programação com IA, especialmente o Claude Code. Seu objetivo principal é transformar o assistente de IA em um parceiro de desenvolvimento disciplinado, operando conforme um fluxo de trabalho de Desenvolvimento Orientado por Especificação (SDD) combinado com Desenvolvimento Orientado por Agentes (ADD). ## Fluxo de Trabalho Principal O modelo aplica um fluxo de trabalho sequencial: CONTEXTO → ESPECIFICAÇÃO → PLANO → TAREFAS → executar → verificar → sincronizar. Cada etapa possui um ponto de verificação e exige aprovação humana antes que o agente possa executar. ## Três Regras Fundamentais 1. **Edite a Especificação, não o Código**: Quando um requisito estiver ausente ou ambíguo, use o comando `/sdd-update` para atualizar primeiro a especificação e revise-a antes de alterar o comportamento. 2. **Sem Especulação Técnica**: Plano, Tarefas e execução usam apenas as vinculações e comandos exatos de verificação aprovados em `.sdd/architecture-profile.md`. 3. **Humanos Decidem**: O agente não se autoaprova, não faz `git push`, não faz deploy e não realiza autonomamente mudanças de estado físico. ## Propriedade e Execução O modelo separa dois eixos independentes em `.sdd/shared_context.md`: - **Propriedade do Projeto** (`solo` ou `team`): Determina a validade da revisão humana e a política de entrega via Git. Padrão é `team`. - **Execução do Agente** (`direct` ou `orchestrated`): `/add-execute` executa diretamente no agente atual ou orquestra trabalhadores após observar as capacidades em tempo de execução. ## Documentação O modelo fornece um sistema de documentação abrangente: - **Início Rápido** (`docs/sdd-add-quickstart.md`): Roteiro passo a passo para novatos. - **Guia de Operações** (`docs/sdd-add-guide.md`): Entenda artefatos, portões e propriedade. - **Referência Rápida** (`docs/sdd-add-field-guide.md`): Escolha comandos por cenário. - **Manual de Cenários** (`docs/sdd-add-scenario-playbook.md`): Lide com greenfield, brownfield, erros e transferência. - **Guia de Perfil de Arquitetura** (`docs/architecture-profile-guide.md`): Selecione vinculações e comandos técnicos. - **Guia de Execução** (`docs/multi-agent-orchestration-guide.md`): Execute tarefas/recursos e orquestração de trabalhadores. ## Fontes Canônicas - `.claude/skills/`: Contratos para comandos. - `.claude/skills/_shared/ai-review-protocol.md`: Protocolo de revisão, metodologia e Registro de Ação. - `.sdd/architecture-profile.md`: Vinculações técnicas e comandos exatos de verificação. - `CONSTITUTION.md`: Regras rígidas sobre segurança, arquitetura e qualidade. - `AGENTS.md`: Escopo e permissões do agente. ## Scripts Utilitários - `scripts/self-heal.sh`: Executa um comando aprovado para coletar evidências; não modifica o código-fonte nem tenta novamente. - `scripts/template-smoke.sh` / `.ps1`: Verificações estáticas para arquivos, links e contratos de política. - `scripts/adopt.*`: Adote o modelo em um repositório existente. - `scripts/update.*`: Puxe atualizações do modelo; arquivos de governança são preparados para revisão humana.