T-112 — DECISÃO ESTRUTURAL DP-1: Atlas único × Atlas + agente de fornecedor

Owner: Pedro · Co-owners: Antônio + Gabriel · Frente: anouk-interno · Prazo: 2026-05-15 · Prioridade: crítica · Tipo: decisão estrutural de arquitetura

🚨 Blocker estrutural — não fechar essa decisão bloqueia spec TO-BE Orçamentação, dimensionamento da Onda 1 Costal, modelagem dos domínios de dados, e priorização de backlog. Registrada também em decisões pendentes.

Descrição

Decisão de projeto registrada por Pedro na própria mensagem após discovery Leandro 28/04:

“Um ponto importante, parece que o tema de fornecedores e equalização de propostas de fornecedores é um tema sensível, talvez tenhamos que ter um agente específico para isso. Essa é uma decisão de projeto que quero tomar depois, para modificar o escopo do Atlas.”

A complexidade da equalização de fornecedores tem peso desproporcional no processo de orçamentação:

  • Modelagem semântica do produto (decomposição por componente: corpo + lâmpada + reator + plug; tampo + pé + caixa de conectividade + divisor frontal)
  • Lógica de agrupamento por código de marca (ex: Deca AP51 é AP51 no Brasil inteiro)
  • Cobrança ativa de fornecedores (e-mail + WhatsApp + ligação)
  • Benchmark cruzado com home center (Tigre etc.)
  • Negociação contínua de formato com fornecedor (relacionamento de longo prazo)

Sessão 28/04 mostrou que luminária e mobiliário são as duas categorias críticas — meio-dia para equalizar 1 proposta. Leandro tem estratégia de “punir” fornecedor indisciplinado (usar preço do concorrente), mas isso vira diferencial competitivo da Costal se o agente fizer bem.

Opções

OpçãoDescriçãoRisco principal
A — Atlas únicoAtlas engloba ingestão, levantamento, CPUs, fornecedores, equalização, BDI, cronogramaMódulo de fornecedor fica raso ou monolítico; perde diferencial competitivo
B — Atlas + agente irmãoAtlas faz orçamento; agente irmão (codinome a definir — “Quote”, “Forge”, “Nexus”, etc.) faz contato + equalização + benchmark + relacionamento. Atlas consome o output do irmãoMais complexidade arquitetural; coordenação entre agentes
C — Atlas + módulo “fornecedor”Separação lógica dentro do Atlas mas mesmo agente físicoPode ser solução intermediária; risco de ficar nem A nem B

Critérios de decisão

  • Inputs de T-111 (varredura na rede Colliers) recebidos
  • Inputs de T-109 (Atlas atualizado) revisados
  • Inputs de T-113 (discovery com Lucas) revisados — segundo orçamentista pode ter visão complementar
  • Reflexão sobre roadmap completo de agentes Costal — agente de fornecedor pode atender também outras frentes (Compras corporativa, CREMS Property)
  • Eventual 2ª rodada com Leandro com deep-dive em equalização (T-001 follow-up) se ainda houver dúvida
  • Decisão registrada em decisoes.md com racional
  • Atlas e (eventualmente) agente irmão atualizados no catálogo
  • AE Costal §Camada de Inteligência atualizada com a estrutura escolhida

Implicação para roadmap (peso estrutural)

Decisão bloqueia em cascata:

  • ❌ Spec TO-BE Orçamentação Costal
  • ❌ Modelagem dos domínios de dados (não dá para definir Bronze/Silver/Gold sem saber se equalização é módulo Atlas ou agente externo)
  • ❌ Catálogo de agentes Costal (Atlas, Draft, Gate, Sentinel, Trace + possível 6º agente irmão)
  • ❌ Dimensionamento da Onda 1 Costal
  • ❌ Priorização de backlog
  • ❌ Hipótese transversal: agente unificado de fornecedores cobrindo Costal + Compras Colliers + CREMS Property/Facilities

Se a decisão for adiada além do prazo:

  • Costal pode criar planilha-padrão por conta própria (R-018) — janela arquitetural se fecha
  • Atlas segue subespecificado e contamina desenho de outros agentes
  • Backlog Onda 1 vira especulação

Hipótese de plataforma (não decidir antes da DP-1)

A opção B (Atlas + agente irmão) abre uma hipótese de plataforma transversal — um agente de fornecedores atende:

  • Atlas (orçamentação Costal — equalização de cotação)
  • Compras corporativas Colliers (Tatiana Souza — banco de >70 fornecedores homologados que Gianlucca já trouxe)
  • CREMS Property (manutenção predial: contratos diretos condomínio↔manutencista; OS no Smart Colliers)
  • CREMS Facilities (qualidade de dados de fornecedores é o gargalo declarado em ML)

Não fechar essa hipótese antes da DP-1 — se confirmada, muda o status do segundo agente de feature local da Costal para plataforma transversal.

Histórico de status

Ver também