Geração da EAP de Implementação
Propósito
EAP é O QUE deve ser implementado, não uma estimativa de esforço.
Não pule diretamente da prosa do TDD para tarefas genéricas.
As entradas devem incluir designs detalhados VERIFICADOS.
Requisito
→ Gap
→ TDD
→ Artefato de Design
→ Design Detalhado VERIFICADO
→ Tarefa da EAP
→ Verificação
Entradas
- requisito autoritativo
- análise de gap verificada
- TDD verificado
- registro de artefatos de design
- todos os designs detalhados
DD_VERIFIED - relatórios de verificação de design detalhado
- design de teste (se disponível)
- repositório atual
1. Derivação de Tarefas
Derive tarefas apenas de decisões de design verificadas.
Categorias de tarefas:
- código de produção
- API/contrato
- integração
- dados/persistência
- configuração
- migração/compatibilidade
- testes
- build/implantação
- documentação
- limpeza apenas se exigida pelo design aprovado
Não adicione refatoração "seria bom ter".
2. Granularidade da Tarefa
Uma tarefa deve ser pequena o suficiente para ter:
- um resultado claro
- âncoras concretas de fonte/design
- dependências explícitas
- critérios de conclusão verificáveis
Mas não divida edições mecânicas em dezenas de microtarefas sem sentido.
3. IDs Estáveis
Use:
WBS-001, WBS-002, ...
3A. EAP ↔ Identidade Semântica de Design
A rastreabilidade não é satisfeita apenas porque uma linha da EAP contém um ID de Artefato existente.
Para cada tarefa da EAP, identifique sua principal entrega de implementação e prove que o(s) artefato(s) de design referenciado(s) possuem essa entrega.
Cadeia semântica obrigatória:
Título da tarefa da EAP / objetivo / entrega principal
↔ nome do artefato do registro + responsabilidade
↔ unidade(s) de implementação de propriedade do DD VERIFICADO
↔ decisão de design do TDD
Regras:
- Uma referência a um ID de Artefato é necessária, mas não suficiente.
- Um tipo/classe/interface ser meramente mencionado, importado, referenciado ou vinculado a partir de um DD não prova que o artefato possui essa unidade de implementação.
- Se a entrega principal de uma tarefa da EAP é um tipo subordinado, uma das seguintes condições deve ser verdadeira:
- o registro/DD declara explicitamente esse tipo subordinado dentro do escopo do artefato proprietário, ou
- a decomposição do artefato de design deve ser revisada para rastreá-lo separadamente.
- Não mapeie uma tarefa intitulada para o componente/tipo A a um artefato cuja responsabilidade registrada é o componente/tipo B, a menos que o artefato possua explicitamente A.
- Se a propriedade semântica não puder ser comprovada, pare com
WBS_BLOCKED_DESIGN_GAP; não invente um mapeamento a partir de prosa de TDD próxima.
Antes de emitir a EAP, crie uma tabela de consistência interna/exposta:
| ID da EAP | Entrega Principal | IDs de Artefato Referenciados | Responsabilidade do Registro | Unidade de Propriedade do DD | Correspondência Semântica? | Evidência |
|---|
Limiar obrigatório:
EAP ↔ identidade semântica do artefato = 100%
4. Tabela da EAP
| ID da EAP | IDs de Artefatos de Design | Tarefa | Âncora de Fonte Existente / Local Proposto | Tipo de Mudança | Dependências | IDs de Requisitos | Referências TDD/DD | Verificação | Critérios de Conclusão |
|---|
Tipo de Mudança:
- ADD
- MODIFY
- REMOVE
- CONFIGURE
- MIGRATE
- TEST
- DOCUMENT
- VERIFY
5. Grafo de Dependências (DAG)
Derive a ordenação da implementação a partir das dependências dos artefatos e dependências de código/tempo de execução.
Crie:
| ID da EAP | Depende De | Motivo da Dependência | Forte/Fraco |
|---|
Detecte dependência circular.
Não invente ordenação apenas a partir da ordem dos arquivos.
6. Mapeamento de Verificação
Toda tarefa que altera código precisa de um caminho de verificação.
Mapeie para:
- teste existente a ser atualizado
- novo ID/ponto de vista de teste
- verificação de fonte/build
- verificação de tempo de execução/integração
- verificação manual apenas quando a automação não for viável
7. Rastreabilidade
Crie:
| ID do Requisito | ID do Gap | ID da Decisão do TDD | ID do Artefato | DD | IDs da EAP | IDs de Teste/Verificação | Cobertura |
|---|
Nenhum artefato de design verificado pode ficar órfão.
8. Portão da EAP
Antes de WBS_READY_FOR_VERIFICATION:
[ ] todos os artefatos DD_VERIFIED têm cobertura de tarefa de implementação/verificação
[ ] toda tarefa da EAP mapeia de volta para o design verificado
[ ] a entrega principal de cada tarefa da EAP corresponde semanticamente à responsabilidade/unidade de propriedade do(s) artefato(s) referenciado(s)
[ ] nenhuma tarefa depende de um símbolo DD/TDD meramente mencionado como prova de propriedade do artefato
[ ] âncoras de fonte/locais propostos são concretos
[ ] dependências são explícitas
[ ] tarefas que alteram código têm critérios de conclusão e verificação
[ ] trabalho de configuração/migração/documentação/teste é incluído quando necessário
[ ] nenhuma arquitetura/refatoração não aprovada foi adicionada
[ ] nenhuma lacuna de fonte ALTA/CRÍTICA está oculta dentro de uma tarefa
Status:
- WBS_READY_FOR_VERIFICATION
- WBS_BLOCKED_DESIGN_GAP
- WBS_BLOCKED_SOURCE_GAP
Importante
Não estime horas/dias/pontos de história neste skill. Estimar esforço é uma preocupação separada.