Maturity Score: A Saude da Sua Arquitetura em Uma Unica Nota
Voce tem um drift score. Voce tem regras de conformidade. Voce tem insights. Voce tem metricas DORA. Quatro sinais, quatro dashboards, quatro numeros para verificar antes de conseguir responder a pergunta mais simples: nossa arquitetura esta em boa forma?
A resposta sempre esteve espalhada. Um time poderia ter precisao perfeita na documentacao (drift score 95) mas praticas de deploy terriveis (DORA no subsolo). Outro poderia fazer deploy dez vezes por dia mas ignorar todas as regras de conformidade existentes. Cada metrica contava um pedaco da historia. Nenhuma contava tudo.
O Maturity Score resolve isso. Uma nota. Quatro dimensoes. Uma unica visao de quao saudavel sua arquitetura realmente esta.
De A ate F. So isso.
Abra qualquer projeto no Archyl e voce vera uma nota em letra:
- A (90-100) — Sua arquitetura esta bem documentada, em conformidade, monitorada ativamente e entrega de forma confiavel. Este e o objetivo.
- B (80-89) — Solido. Pequenas lacunas em uma ou duas dimensoes, mas nada que tire seu sono.
- C (70-79) — Base decente, fraquezas reais. Voce sabe onde estao os problemas mas ainda nao os corrigiu.
- D (60-69) — Com dificuldades. Multiplas dimensoes estao abaixo do esperado. A divida tecnica esta se acumulando.
- F (abaixo de 60) — Sua documentacao de arquitetura e decorativa. Comece pelo basico.
A nota nao e uma metrica de vaidade. Ela e calculada a partir de quatro dimensoes ponderadas, cada uma medindo algo diferente sobre sua pratica de arquitetura.
Quatro Dimensoes, Uma Nota
Drift — Sua documentacao diz a verdade?
A dimensao de drift mede quao precisamente seu modelo C4 reflete sua base de codigo real. Caminhos de arquivo que nao existem mais. Servicos que foram renomeados. Containers que foram mesclados. Cada elemento documentado e validado contra o repositorio.
Um drift score alto significa que seus diagramas de arquitetura descrevem o sistema que realmente roda em producao. Um baixo significa que eles descrevem um sistema que existia seis meses atras.
Insights — Voce esta ouvindo os sinais?
O Archyl analisa continuamente sua arquitetura e apresenta problemas: dependencias circulares, componentes superdimensionados, documentacao ausente, containers nao utilizados. A dimensao de insights mede quantos desses problemas existem e quao severos sao.
Um time que resolve insights criticos rapidamente pontua alto. Um time que deixa os avisos se acumularem pontua baixo. Nao se trata de ter zero problemas — trata-se de ter uma cultura de agir sobre eles.
Conformidade — Voce segue suas proprias regras?
Voce definiu regras de arquitetura por um motivo. Nenhum container de frontend deve chamar o banco de dados diretamente. Todo sistema deve ter pelo menos um contrato de API documentado. Servicos de autenticacao nao devem depender de logica de negocio.
A dimensao de conformidade mede qual porcentagem das suas regras estao passando. E a diferenca entre ter governanca e aplica-la.
DORA — Voce realmente consegue entregar?
Qualidade de arquitetura nao significa nada se voce nao consegue entregar. A dimensao DORA rastreia as quatro metricas padrao: frequencia de deploy, lead time para mudancas, taxa de falha de mudancas e tempo medio de recuperacao.
Um time com arquitetura bonita que faz deploy uma vez por trimestre tem um problema de entrega. O DORA detecta isso.
Ponderado, Nao Uma Media Simples
As quatro dimensoes nao tem pesos iguais. O maturity score de cada projeto e um composto ponderado:
| Dimensao | Peso Padrao | O que recompensa |
|---|---|---|
| Drift | 25% | Manter a documentacao precisa |
| Insights | 25% | Resolver problemas de arquitetura |
| Conformidade | 25% | Seguir suas proprias regras |
| DORA | 25% | Entregar de forma confiavel |
Os pesos sao visiveis no painel de detalhes — cada nota mostra sua contribuicao. Voce pode ver exatamente por que sua nota e o que e e qual dimensao esta puxando para baixo.
Visao no Nivel da Organizacao
Notas individuais de projetos sao uteis. Ver todos os seus projetos lado a lado e transformador.
O dashboard de Maturidade da Organizacao mostra cada projeto como um card: nota, pontuacao, tendencia e um detalhamento de todas as quatro dimensoes. Filtre por nota. Ordene por pontuacao. Pesquise por nome. Em trinta segundos, voce sabe quais projetos precisam de atencao.
A barra de distribuicao de notas no topo mostra o formato da saude da arquitetura da sua organizacao. Maioria de A's e B's? Voce esta em boa forma. Um grupo de D's e F's? Voce sabe onde investir.
Tendencias Contam a Historia Real
Cada calculo de maturidade e rastreado ao longo do tempo. Cada projeto mostra uma tendencia: melhorando, estavel ou declinando.
Um projeto que foi de C para B no mes passado esta no caminho certo, mesmo que ainda nao seja um A. Um projeto que vem declinando por tres sprints precisa de intervencao, mesmo que ainda seja um B. A tendencia e frequentemente mais acionavel do que a nota absoluta.
O Motor de Recomendacoes
O painel de detalhes nao mostra apenas notas — ele diz o que fazer. A dimensao mais fraca recebe uma recomendacao especifica e acionavel:
- Drift esta mais baixo? "Execute uma deteccao de drift para atualizar o alinhamento da sua documentacao."
- Insights esta mais baixo? "Revise e resolva os insights criticos de arquitetura."
- Conformidade esta mais baixa? "Corrija as violacoes de regras de conformidade para melhorar a conformidade."
- DORA esta mais baixo? "Melhore as praticas de deploy para elevar as metricas DORA."
Sem ambiguidade. Sem "considere melhorar seus processos." Um proximo passo concreto ligado ao que mais vai mover sua nota.
Por Que Uma Unica Nota Importa
Times nao agem com base em dashboards com doze metricas. Eles agem com base em um numero que e facil de entender, facil de comparar e dificil de manipular.
O Maturity Score e deliberadamente opinativo:
E holistico. Voce nao consegue um A sendo otimo em documentacao mas terrivel em entregas. As quatro dimensoes importam.
E comparavel. O Projeto A tem um B. O Projeto B tem um D. A conversa sobre onde investir tempo de engenharia ficou mais simples.
E rastreavel. Um numero que voce pode plotar ao longo do tempo e um numero que voce pode melhorar. Defina uma meta: "Todos os projetos em C ou acima ate o final do trimestre." Agora voce tem um objetivo mensuravel.
E honesto. A nota nao se importa com intencoes ou roadmaps. Ela mede o que e verdade agora. Sua documentacao ou corresponde ao codigo ou nao. Suas regras ou passam ou nao.
Comecando
O Maturity Score esta disponivel hoje para todos os projetos Archyl. Nenhuma configuracao necessaria — se voce tem um projeto com documentacao de arquitetura, voce ja tem uma nota.
- Abra qualquer projeto. O selo de maturidade aparece no cabecalho do projeto.
- Clique nele para ver o detalhamento completo: nota geral, quatro dimensoes, tendencia e recomendacao.
- Visite a pagina de Maturidade da Organizacao para ver todos os projetos de uma vez.
A saude da arquitetura da sua organizacao nao deveria ser um misterio. Agora e uma nota em letra.