Princípios sob a Ótica de Quem Escreve
Visão Geral
O nível anterior trata de como princípios operam no momento da decisão. Este trata de quem os escreve — e o trabalho de escrita tem três problemas próprios:
1. de onde vêm os princípios
2. como saber se eles funcionam
3. quando removê-los
O primeiro é o mais determinante. Princípios formulados numa oficina, a partir do que a organização gostaria de ser, quase sempre viram slogans. Princípios derivados de decisões que já foram tomadas descrevem o critério real da organização — e por isso são reconhecidos e usados.
Problema
O processo típico de criação:
oficina de dois dias com a liderança
brainstorming sobre valores e direção
consolidação em nove princípios
publicação no portal interno
O resultado previsível: afirmações que ninguém contestaria — "priorizamos qualidade", "buscamos simplicidade" —, nenhuma das quais elimina uma opção em nenhuma decisão real.
O problema não é a oficina. É a fonte: a organização foi perguntada sobre o que gostaria de ser, e não sobre o que ela de fato usa para decidir.
E há um segundo problema, do outro lado: princípios que funcionaram e viraram consenso, e que continuam ocupando espaço numa lista que ninguém consegue lembrar inteira.
Conceitos Centrais
Derive dos precedentes
O método que produz princípios usáveis:
1. leia as últimas cinquenta decisões arquiteturais registradas
2. procure os critérios que aparecem repetidamente
3. enuncie cada um como uma afirmação que elimina opções
4. valide contra decisões que você não usou para derivá-los
Isso produz princípios que descrevem o que a organização já faz — e a diferença prática é enorme: eles são reconhecidos imediatamente, e a discussão passa a ser sobre se o critério está certo, e não sobre se ele é o critério.
Ver ADRs.
Quando o acervo de decisões não existe, construí-lo vem antes de escrever princípios.
Aplique o teste do inverso
formule o oposto
se for absurdo, é slogan
se for uma posição defensável, é princípio
"buscamos simplicidade" inverso absurdo
"preferimos comprar a construir, exceto
onde a capacidade diferencia o negócio" inverso defensável
Todo princípio real abdica de algo bom. Se nada está sendo abdicado, não há escolha. Ver princípios corporativos.
Implicações, não apenas o enunciado
princípio "o que a plataforma oferece, os times não reconstroem"
implicações toda proposta de construir algo que a plataforma
cobre precisa justificar por escrito
lacunas da plataforma viram itens de roteiro dela,
não construções paralelas
a plataforma se compromete com prazo de resposta
A terceira implicação é a que torna o princípio justo: ele impõe obrigação aos dois lados. Um princípio que só restringe os times e não compromete a plataforma será contornado, com razão.
Precedência entre princípios conflitantes
"times decidem sua própria tecnologia"
"minimizamos o número de tecnologias em operação"
Ambos defensáveis, e opostos. Sem regra, cada decisão vira disputa de poder.
por domínio autonomia vence em escolha interna;
padronização vence em superfície compartilhada
por risco quanto maior o risco compartilhado, mais peso
à coerência
Definir a precedência é responsabilidade de quem escreve, e é a parte que a oficina normalmente não faz — porque ela exige escolher, e a oficina busca consenso.
Cinco a oito, no máximo
O limite é de memória, não de rigor. Princípios que precisam ser consultados não orientam as decisões que eles existem para orientar, porque essas decisões acontecem sem consulta.
Se a lista tem quinze, ela é referência de auditoria, não instrumento de decisão.
Meça citação em decisões reais
princípio citado em ADRs e revisões está operando
nunca citado não está
Essa medição é barata — uma busca no acervo de decisões — e é o único teste honesto. Um princípio bem escrito que ninguém cita em um ano não está funcionando, independentemente da qualidade da redação.
Aposente o que virou consenso
Contraintuitivo e importante: um princípio que ninguém mais contesta deixou de eliminar opções, e por isso deixou de ser princípio.
"preferimos serviços gerenciados a componentes operados por nós"
→ em 2020, eliminava opções e gerava discussão
→ em 2026, é consenso; virou descrição, não escolha
Removê-lo libera espaço na lista para um princípio que ainda decide algo. O caminho usual é promovê-lo a padrão verificado automaticamente, se aplicável. Ver padrões.
Revisão anual, com uma pergunta
"as condições que produziram este princípio ainda valem?"
Princípios são decisões sobre como decidir, e envelhecem como qualquer decisão. Um princípio formulado para uma organização de seis times pode ser ativamente prejudicial numa de trinta.
Modelo Mental
Derive de precedentes, teste pelo inverso, e aposente o que virou consenso. Cinco a oito, com implicações e precedência.
Quando Usar
- Quando decisões independentes precisam de critério comum.
- Derivando do acervo de decisões, não de oficina.
- Com implicações e regra de precedência.
Quando Não Usar
Formulados em oficina a partir de aspiração.
Sem passar no teste do inverso.
Sem implicações.
Sem precedência entre os que conflitam.
Em número acima de oito.
Sem medir citação em decisões reais.
Alternativas
- Acervo de ADRs — precedentes concretos ensinam o critério melhor que abstrações, e organizações com bom acervo precisam de menos princípios.
- Visão curta — três a cinco afirmações que cobrem o essencial. Ver visão de arquitetura.
- Padrões — quando a decisão é recorrente e o resultado previsível.
- Nada — em times pequenos, o critério compartilhado é tácito e funciona.
Trade-offs
| Derivado de precedentes | Formulado por aspiração |
|---|---|
| Reconhecido e usado | Descreve o desejado |
| Exige acervo de decisões | Rápido de produzir |
| Descreve o que já se faz | Pode não descrever nada |
| Poucos princípios | Muitos |
|---|---|
| Lembrados | Cobrem mais casos |
| Exigem escolher | Evitam escolher |
Modos de Falha
Slogan. Ninguém defende o inverso.
Sem implicação. Citado pelos dois lados de qualquer discussão.
Conflito sem precedência. Resolvido por poder.
Lista longa. Não é lembrada.
Consenso mantido na lista. Ocupa espaço sem decidir nada.
Nunca revisado. Governa com premissas de outra época.
Erros Comuns
Formular em oficina sem olhar as decisões reais.
Não declarar implicações que comprometem quem escreve.
Não medir citação.
Não remover o que virou consenso.
Escrever princípio onde um padrão resolveria.
Exemplo Real
Uma empresa de tecnologia em saúde não tinha princípios arquiteturais publicados, e a liderança de engenharia queria criar. A proposta inicial era a usual: uma oficina de dois dias com os arquitetos e líderes técnicos.
A área de arquitetura propôs um método diferente, com um argumento simples: a organização já decidia de alguma forma, havia quatro anos, e essas decisões estavam registradas.
Leitura dos ADRs. Os 96 registros de decisão dos últimos três anos foram lidos, e os critérios citados em cada um foram tabulados.
critério citado ADRs
"não podemos depender de conexão da unidade" 31
"o dado clínico não pode ser alterado" 27
"quem opera precisa conseguir depurar às 3h" 19
"o time que constrói é o que responde no plantão" 17
"preferimos comprar onde não somos diferentes" 11
demais critérios, com menos de 5 citações —
Os cinco critérios somavam 105 citações nas 96 decisões — vários ADRs citavam mais de um.
Teste do inverso aplicado aos cinco: os quatro primeiros passaram com folga; o quinto foi contestado internamente, porque a organização tinha construído três sistemas que o mercado oferecia. A discussão que se seguiu foi produtiva, e o princípio foi mantido com uma implicação adicional: toda proposta de construir precisa nomear o diferencial por escrito.
Implicações, mínimo duas por princípio, com ao menos uma impondo obrigação a quem escreveu. Para o princípio de plantão, a obrigação foi da liderança: nenhum time recebe responsabilidade de plantão sem a plataforma que a torna sustentável.
Precedência declarada entre os dois que conflitavam — autonomia de time e comprar em vez de construir — resolvida por domínio.
O resultado foi um documento de uma página, com cinco afirmações, publicado em três semanas em vez de uma oficina de dois dias.
Doze meses depois:
citações em ADRs novos 44 de 51
engenheiros que citavam ao menos três 83%
princípios contestados internamente 1 — o de comprar,
mantido após discussão
princípios adicionados 0
A conclusão registrada: os cinco princípios não eram novidade para ninguém. Eles descreviam o critério que a organização já usava, enunciado de forma lembrável — e é por isso que foram reconhecidos de imediato, em vez de precisarem ser vendidos.
E a oficina de dois dias, que teria produzido aspirações, custaria oito pessoas por dois dias. A leitura dos ADRs custou uma pessoa por três dias.
Conceitos Relacionados
Exercício Prático
Leia as últimas trinta decisões arquiteturais registradas na sua organização e extraia os critérios que aparecem mais de três vezes.
Compare com a lista de princípios publicada. A diferença entre as duas é a distância entre o que a organização diz e o que ela usa.
Perguntas de Entrevista
- Por que princípios derivados de precedentes funcionam melhor que os formulados em oficina?
- Por que um princípio que virou consenso deveria ser removido?
- Por que as implicações precisam comprometer quem escreveu o princípio?
Para Aprofundar
- Rumelt, Richard. Good Strategy Bad Strategy. Crown Business, 2011.
- Ford, Neal et al. Fundamentals of Software Architecture. O'Reilly, 2020.
- Hohpe, Gregor. The Software Architect Elevator. O'Reilly, 2020.