Pular para o conteúdo

Fase 3 — Especificação detalhada (S)

A Fase 3 transforma o backlog publicado em especificação executável: um SRS estruturado, diagramas atualizados e casos de teste já derivados. A IA produz o conteúdo; o arquiteto e o PO revisam e fecham o documento.

Acionamento: backlog publicado e matriz de conformidade aprovada (Fase 2).

O que a IA faz:

  1. Toma histórias, wireframes e decisões registradas.
  2. Gera documentação estruturada:
    • SRS (Software Requirements Specification) em Markdown versionado;
    • Diagrama de fluxo (Mermaid) gerado automaticamente;
    • Diagramas de sequência de interação (swim lane);
    • Casos de teste derivados dos critérios BDD.
  3. Tudo versionado no Git para rastreabilidade.
SeçãoConteúdo
1. Visão geralObjetivo, escopo, SLA, conformidades aplicáveis com âncoras rastreáveis
2. Histórias formatadasBDD completo (Given/When/Then) com critérios de aceite expandidos
3. Fluxo de processoDiagrama Mermaid (caminho feliz + escalações + casos de borda)
4. Sequência de integraçãoDiagramas de sequência para cada integração (email, 2FA, SSO, etc.)
5. Casos de testeMapeamento automático: critério BDD → casos de teste (unit/integration/E2E)
6. Conformidade rastreávelMatriz: lei → exigência → requisito → caso de teste → evidência
7. Histórico de versõesMudanças de v1.0, v1.1, … com motivo registrado
8. LinksWireframes (Figma), ADRs, histórias (Jira), testes (Git)

Validação humana obrigatória: o arquiteto e o PO revisam o SRS gerado antes de qualquer dev consumi-lo; nada do que a IA gerou entra em produção sem essa revisão.

Ganho típico: 8–10 horas em escrita técnica; documentação sempre sincronizada com requisitos; testes já derivados das specs.

Etapa 3.2 · Review de especificação com IA mediando

Seção intitulada “Etapa 3.2 · Review de especificação com IA mediando”

Quando: SRS gerado e em revisão por arquiteto/PO.

O que a IA faz:

  1. Apresenta a documentação gerada na reunião de review.
  2. O arquiteto/PO dá feedback (mudanças desejadas, alertas, dúvidas).
  3. A IA calcula impacto de cada mudança (esforço, risco, dependência).
  4. Atualiza a documentação em tempo real.
  5. Sugere testes adicionais se um critério foi alterado.
  6. Cria ADR automático quando uma decisão é tomada.

Arquiteto: “Eu queria SLA de 12h, não 24h. Isso afeta muito a escalação?”

IA: “Sim, reduz a janela de escalação. Estimativa: +3 SP em orquestração de escalação, +1 semana de dev (paralelo com outra história). Risco: aprovadores fora do horário comercial geram mais escalações. Teste adicional necessário: comportamento com múltiplas escalações em sequência.”

Arquiteto: “Entendi. Vamos manter 24h. Não dá para acelerar a infraestrutura de notificação agora.”

IA gera ADR automático:

ADR-XXX — Manter SLA de 24h em vez de 12h
Contexto: Infraestrutura de notificação não suporta a velocidade de 12h.
Alternativa considerada: assincronia com WebSocket (fora do escopo do MVP).
Decisão: SLA de 24h com escalação automática.
Consequência: usuários podem não ser notificados imediatamente.
Tomador: Silva (Arquiteto). Status: Aceita.

Validação humana obrigatória: o ADR gerado pela IA é publicado apenas após o arquiteto revisar; ADRs são versionados em /docs/adr/ no Git e referenciados pelos requisitos impactados.

Ganho típico: 1 hora de reunião que entrega decisão + ADR + análise de impacto; impacto de mudança calculado em tempo real (não “achismo”).

A Fase 3 é encerrada quando:

ItemCritério de fechamento
SRS v1.0 publicadoMarkdown versionado no Git, com índice e links rastreáveis
Diagramas atualizadosFluxo (Mermaid) + sequências (swim lanes) referenciados pelas histórias
Casos de teste derivadosCada critério BDD aponta para 1+ caso de teste (unit/integration/E2E)
ADRs principais publicadosDecisões críticas (stack, padrões, integrações) com rationale e consequência
Matriz lei → teste atualizadaCobertura de conformidade chega até o caso de teste
Aprovação duplaArquiteto + PO assinam o SRS; Encarregado de Dados aprova a parte LGPD

A partir desse encerramento, a equipe de arquitetura pode iniciar a Fase 4.


Anterior: 4 · Fase 2 — Refinamento de requisitos · Próximo: 6 · Fase 4 — Arquitetura com IA