Skip to content
in studydocs
↑ ↓ navigateEnter openon-site search, no external service

0005 · Integrações terceirizadas, sempre com caminho nativo

  • Status: Proposto
  • Data: 2026-11-14

Contexto

Seção intitulada “Contexto”

O Prumo conversa com muitos sistemas: rastreadores de tarefa, forjas de código (GitHub, GitLab, Forgejo), provedores de IA, comunicação. Vários são proprietários ou pagos. Ao mesmo tempo, o Prumo quer ser estudado, usado e melhorado por qualquer pessoa, inclusive sem dinheiro, e servir ao setor público (ADR-0004).

Construir tudo em casa desde o início travaria a entrega. Depender de algo proprietário pra sempre trairia o propósito.

Decisão

Seção intitulada “Decisão”
  1. Toda integração fica atrás de uma interface (porta), com implementações trocáveis (adapters, padrão Strategy).
  2. Um adapter proprietário pode entrar primeiro, como terceirização de uma etapa, pra acelerar a entrega. Ex.: executar etapas com o Claude Code no C1.
  3. Toda porta com adapter proprietário ganha, no mesmo dia, uma issue aberta para o caminho nativo (livre e gratuito), com a label caminho-nativo. Essa issue é trabalho de primeira classe, não “um dia”.
  4. Dependência obrigatória é sempre livre. O Prumo precisa rodar de ponta a ponta sem nada proprietário quando todas as issues caminho-nativo de uma etapa estiverem fechadas.
  5. Toda dependência nova passa por checagem de licença antes de entrar (no CI, assim que houver CI).

Consequências

Seção intitulada “Consequências”
  • O C1 pode usar o Claude Code e chegar mais rápido; o caminho com agente e modelo livres (ex.: OpenCode ou Aider com modelo local) vira issue aberta, boa pra quem quer contribuir.
  • A lista de issues caminho-nativo mostra, a qualquer momento, o quanto o Prumo ainda depende de terceiros.
  • Cada interface precisa de testes que rodem com o adapter nativo ou com um dublê, pra não acoplar no proprietário sem perceber.
  • Exige disciplina: adapter proprietário sem issue nativa não passa no review.

Fontes

Seção intitulada “Fontes”