Desenvolva funcionalidades a partir de especificações aprovadas antes de programar

## Separe as diretrizes gerais do projeto da especificação de cada funcionalidade Mantenha deliberadamente duas camadas de orientação para o desenvolvimento. O direcionamento do projeto registra o contexto duradouro do produto, as escolhas de tecnologia, a estrutura do repositório, as políticas e as convenções. As especificações de funcionalidades definem uma mudança delimitada e reúnem seus requisitos, design, tarefas, pesquisa e evidências de validação. Consulte o direcionamento relevante do projeto antes de trabalhar em uma funcionalidade e mantenha-o atualizado quando restrições estáveis mudarem. Nunca permita que decisões específicas de uma funcionalidade reescrevam silenciosamente as orientações de todo o projeto. Identifique as especificações ativas e exponha a fase atual de cada uma para que o trabalho retomado continue a partir do estado registrado, em vez de se basear em suposições. ## Verifique primeiro o escopo e escolha uma especificação ou um roteiro Comece com uma breve etapa de descoberta que esclareça a ideia, o sistema afetado, as dependências e o resultado esperado. Para uma funcionalidade delimitada, abra diretamente uma única especificação. Para uma iniciativa ampla, crie um resumo e um roteiro, divida o trabalho em especificações coesas, registre as dependências e programe a implementação em etapas organizadas por elas. Ao alterar um sistema consolidado, examine a implementação existente antes do design e registre lacunas, restrições de compatibilidade e componentes reutilizáveis. Use um caminho acelerado somente de forma intencional; ainda assim, ele deve produzir os artefatos essenciais de requisitos, design, tarefas e validação. ## Escreva requisitos, design e tarefas em ordem, com aprovação em cada etapa Avance pelas fases da especificação na seguinte ordem: 1. Escreva requisitos testáveis que definam comportamento, limites, restrições e condições de aceitação. 2. Obtenha uma revisão humana dos requisitos antes de tratá-los como base do design. 3. Produza um design que associe cada requisito à arquitetura, às interfaces, ao fluxo de dados, aos riscos e à verificação. 4. Revise o design e, em seguida, derive tarefas de implementação ordenadas, com dependências e verificações de conclusão. 5. Obtenha a aprovação do plano de tarefas antes da implementação, a menos que um caminho acelerado intencional já tenha autorizado toda a sequência. Se o escopo mudar de modo substancial, retorne à fase afetada e revalide os artefatos posteriores, em vez de remendar um plano obsoleto. ## Implemente só tarefas aprovadas num modo escolhido: todas ou as indicadas Inicie a implementação somente a partir de tarefas aprovadas e escolha explicitamente o modo de execução. No modo de escopo completo, execute o plano aprovado de forma autônoma, divida o trabalho por tarefa quando isso for útil, integre os resultados, obtenha uma revisão independente e execute a validação final. No modo de tarefas selecionadas, implemente somente as tarefas nomeadas no contexto atual e não altere tarefas sem relação com elas. Use uma revisão de implementação separada quando um trabalho concluído precisar ser revalidado posteriormente. Pause somente quando faltarem informações essenciais ou uma permissão necessária, houver um problema de segurança ou estiver pendente uma decisão que altere o escopo; a dificuldade, por si só, não é motivo para abandonar o fluxo de trabalho aprovado. ## Reutilize habilidades de desenvolvimento e peça uma revisão independente Mantenha procedimentos especializados de desenvolvimento como habilidades reutilizáveis, com uma instrução de entrada clara e modelos, exemplos ou referências de apoio opcionais. As habilidades devem operar com o contexto da tarefa atual e só podem delegar pesquisas ou revisões paralelas de escopo delimitado quando a plataforma, as permissões e o escopo da tarefa permitirem. Use revisão adversarial para as constatações da implementação, depuração que priorize a causa raiz para falhas e verificação com evidências recentes antes de declarar o trabalho concluído. Examine e aplique uma habilidade relevante mesmo que haja apenas uma pequena possibilidade de ela reger a tarefa; a aparente simplicidade não comprova que suas salvaguardas sejam desnecessárias. ## Mantenha o status da especificação em dia e comprove a conclusão com evidências novas Escreva os artefatos da especificação no idioma de destino configurado para ela, mesmo que o raciocínio interno use outro idioma. Mantenha o status disponível durante todo o fluxo de trabalho, incluindo a fase atual, os artefatos aprovados, as dependências, o trabalho concluído, as tarefas restantes e as decisões pendentes que bloqueiam o avanço. Não declare sucesso apenas com base na inspeção do código-fonte ou na conclusão das tarefas. Execute a validação de implementação aplicável, examine os artefatos resultantes e vincule a declaração de conclusão às evidências atuais. Depois que uma revisão ou implementação alterar o resultado, atualize a especificação e o status para que a próxima sessão herde o estado real.