Pular para o conteúdo

Fase 4 — Arquitetura com IA (S)

A Fase 4 consolida as decisões técnicas. A IA propõe a arquitetura com base na especificação aprovada e em ADRs anteriores; o arquiteto e o time validam, revisam, aceitam ou rejeitam cada parte. Nenhuma escolha técnica vai para o desenvolvimento sem aprovação explícita.

Acionamento: SRS publicado e ADRs principais aprovados (Fase 3).

O que a IA faz:

  1. Toma especificação, requisitos, conformidade e contexto da Fase 0.
  2. Propõe arquitetura com base em padrões históricos da organização e em ADRs anteriores.
  3. Desenha diagramas C4 (Context, Container, Component, Code) automaticamente.
  4. Sugere tecnologias com trade-offs explícitos.
  5. Identifica riscos arquiteturais com mitigação inicial.
  6. Mapeia conformidades em componentes específicos (criptografia, auditoria, controle de acesso).
SeçãoConteúdo
Contexto (C1)Sistemas externos, integrações, fronteiras de negócio
Containers (C2)Frontend, backend, worker, bancos, fila, cache, observabilidade
Padrões aplicadosREST, event-driven, SAGA, CQRS, etc. — com justificativa
Conformidade × componenteLGPD → criptografia em S3; ISO 27001 → auditoria em Elasticsearch; LAI → exportação
Riscos e mitigaçõesEmail em spam → SPF/DKIM/DMARC; escalação infinita → limite de 3 níveis; perda de evento → fila persistente com retry
Tecnologia justificadaLinguagem, banco, fila, cache, observabilidade, com motivo objetivo
Não recomendadoO que não fazer e por quê (ex.: microserviços para um MVP de 35 SP)
ADRs a criarLista de decisões que precisam de ADR formal

A proposta nunca é prescritiva. É ponto de partida baseado em padrões internos e externos. A organização permanece dona da escolha de stack e fornecedor — ver SinergIA é referencial, não produto.

Validação humana obrigatória: o Arquiteto Líder revisa cada container, padrão e justificativa antes da reunião de revisão arquitetural. O Validador Técnico confirma riscos e mitigações.

Ganho típico: 6–8 horas de desenho arquitetural; arquitetura justificada (não “vamos usar a que conheço”); conformidades já mapeadas a componentes.

Etapa 4.2 · Revisão arquitetural com IA sintetizando

Seção intitulada “Etapa 4.2 · Revisão arquitetural com IA sintetizando”

Quando: o arquiteto apresenta a proposta para o time técnico.

O que a IA faz:

  1. Transcreve o debate em tempo real.
  2. Detecta questões não respondidas (debate caiu sem decisão clara).
  3. Sugere trade-offs objetivos com base em métricas conhecidas.
  4. Atualiza ADRs com a decisão tomada.
  5. Identifica dependências de desenvolvimento que precisam ser priorizadas.

Desenvolvedor: “Python é lento. A gente devia usar Node.js.”

IA (calculando impacto): “Verdadeiro: Node.js tende a ser ~2× mais rápido em I/O. Mas: o time tem expertise em Python. Trade-off: Python entrega mais rápido em desenvolvimento (você conhece), mais lento em runtime; Node.js entrega mais rápido em runtime, mas exige curva de aprendizado. Como o SLA de 24h é tolerante a runtime, a recomendação depende da prioridade — qual é a prioridade?”

Arquiteto: “Vamos rápido. Python.”

IA cria ADR (draft):

ADR-XXX — Python vs. Node.js
Contexto: SLA tolerante a runtime; equipe com expertise Python.
Alternativa considerada: Node.js (mais rápido em I/O).
Decisão: Python (mais rápido em desenvolvimento).
Consequência: runtime ligeiramente mais lento, aceitável para o SLA.
Validação: teste de carga obrigatório na fase de QA.

Validação humana obrigatória: o ADR só é publicado após aprovação explícita do Arquiteto (e do Tech Lead quando a decisão impactar o pipeline ou a operação). Decisões com efeito em segurança ou dados pessoais exigem visto adicional do Validador Técnico e/ou Encarregado de Dados.

Ganho típico: 1 hora de reunião com decisão objetiva + ADR + critério de validação; ninguém “quer trocar tecnologia no meio do caminho”.

A Fase 4 é encerrada quando:

ItemCritério
Diagramas C4 aprovadosC1, C2 e (quando relevante) C3 publicados no Git/wiki, referenciados pelo SRS
ADRs principais aprovadosStack, padrões transversais (auditoria, autenticação, criptografia), integrações críticas
Riscos arquiteturais com mitigaçãoCada risco tem responsável, mitigação proposta e prazo para validação
Mapa conformidade × componenteLGPD/LAI/ISO 27001 com componente responsável por cada controle
Plano de validação técnicaComo testar performance, escalação, recuperação de falha (insumos para Fase 6)
Aprovação duplaArquiteto + Validador Técnico assinam a proposta

Concluída a Fase 4, o ambiente de desenvolvimento pode ser preparado pela IA (Fase 5).


Anterior: 5 · Fase 3 — Especificação detalhada · Próximo: 7 · Fase 5 — Desenvolvimento assistido