Maturity Score: A Saúde da Sua Arquitetura em Uma Única Nota

Você tem um drift score. Você tem regras de conformidade. Você tem insights. Você tem métricas DORA. Quatro sinais, quatro dashboards, quatro números para verificar antes de conseguir responder a pergunta mais simples: nossa arquitetura está em boa forma?

A resposta sempre esteve espalhada. Um time poderia ter precisão perfeita na documentação (drift score 95) mas praticas de deploy terríveis (DORA no subsolo). Outro poderia fazer deploy dez vezes por dia mas ignorar todas as regras de conformidade existentes. Cada métrica contava um pedaço da historia. Nenhuma contava tudo.

O Maturity Score resolve isso. Uma nota. Quatro dimensões. Uma única visão de quão saudável sua arquitetura realmente esta.

De A ate F. Só isso.

Abra qualquer projeto no Archyl e você vera uma nota em letra:

• A (90-100) — Sua arquitetura esta bem documentada, em conformidade, monitorada ativamente e entrega de forma confiável. Este é o objetivo.
• B (80-89) — Solido. Pequenas lacunas em uma ou duas dimensões, mas nada que tire seu sono.
• C (70-79) — Base decente, fraquezas reais. Você sabe onde estão os problemas mas ainda não os corrigiu.
• D (60-69) — Com dificuldades. Múltiplas dimensões estão abaixo do esperado. A divida técnica esta se acumulando.
• F (abaixo de 60) — Sua documentação de arquitetura é decorativa. Comece pelo básico.

A nota não é uma métrica de vaidade. Ela é calculada a partir de quatro dimensões ponderadas, cada uma medindo algo diferente sobre sua pratica de arquitetura.

Quatro Dimensões, Uma Nota

Drift — Sua documentação diz a verdade?

A dimensão de drift mede quão precisamente seu modelo C4 reflete sua base de código real. Caminhos de arquivo que não existem mais. Serviços que foram renomeados. Containers que foram mesclados. Cada elemento documentado é validado contra o repositório.

Um drift score alto significa que seus diagramas de arquitetura descrevem o sistema que realmente roda em produção. Um baixo significa que eles descrevem um sistema que existia seis meses atrás.

Insights — Você está ouvindo os sinais?

O Archyl analisa continuamente sua arquitetura e apresenta problemas: dependências circulares, componentes superdimensionados, documentação ausente, containers não utilizados. A dimensão de insights mede quantos desses problemas existem e quão severos são.

Um time que resolve insights criticos rapidamente pontua alto. Um time que deixa os avisos se acumularem pontua baixo. Não se trata de ter zero problemas — trata-se de ter uma cultura de agir sobre eles.

Conformidade — Você segue suas próprias regras?

Você 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. Serviços de autenticação não devem depender de logica de negocio.

A dimensão de conformidade mede qual porcentagem das suas regras estão passando. E a diferença entre ter governança e aplica-la.

DORA — Você realmente consegue entregar?

Qualidade de arquitetura não significa nada se você não consegue entregar. A dimensão DORA rastreia as quatro métricas padrão: frequência de deploy, lead time para mudanças, taxa de falha de mudanças e tempo médio de recuperação.

Um time com arquitetura bonita que faz deploy uma vez por trimestre tem um problema de entrega. O DORA detecta isso.

Ponderado, Não Uma Media Simples

As quatro dimensões não têm pesos iguais. O maturity score de cada projeto é um composto ponderado:

Se um projeto não usa uma das quatro (sem regras de conformidade, sem acompanhamento de releases), essa dimensão pode ser desativada nas configurações do projeto, e o peso dela é redistribuído proporcionalmente entre as outras, para que o score não seja diluído por um valor de preenchimento.

Os pesos são visíveis no painel de detalhes — cada nota mostra sua contribuição. Você pode ver exatamente por que sua nota é o que e e qual dimensão está puxando para baixo.

Visão no Nível da Organização

Notas individuais de projetos são uteis. Ver todos os seus projetos lado a lado e transformador.

O dashboard de Maturidade da Organização mostra cada projeto como um card: nota, pontuação, tendencia e um detalhamento de todas as quatro dimensões. Filtre por nota. Ordene por pontuação. Pesquise por nome. Em trinta segundos, você sabe quais projetos precisam de atenção.

A barra de distribuição de notas no topo mostra o formato da saúde da arquitetura da sua organização. Maioria de A's e B's? Você está em boa forma. Um grupo de D's e F's? Você sabe onde investir.

Tendencias Contam a Historia Real

Cada calculo de maturidade é rastreado ao longo do tempo. Cada projeto mostra uma tendencia: melhorando, estável ou declinando.

Um projeto que foi de C para B no mes passado está no caminho certo, mesmo que ainda não seja um A. Um projeto que vem declinando por três sprints precisa de intervenção, mesmo que ainda seja um B. A tendencia é frequentemente mais acionável do que a nota absoluta.

O Motor de Recomendações

O painel de detalhes não mostra apenas notas — ele diz o que fazer. A dimensão mais fraca recebe uma recomendação especifica e acionável:

• Drift está mais baixo? "Execute uma detecção de drift para atualizar o alinhamento da sua documentação."
• Insights está mais baixo? "Revise e resolva os insights criticos de arquitetura."
• Conformidade está mais baixa? "Corrija as violações de regras de conformidade para melhorar a conformidade."
• DORA está mais baixo? "Melhore as praticas de deploy para elevar as métricas DORA."

Sem ambiguidade. Sem "considere melhorar seus processos." Um próximo passo concreto ligado ao que mais vai mover sua nota.

Por Que Uma Única Nota Importa

Times não agem com base em dashboards com doze métricas. Eles agem com base em um numero que é fácil de entender, fácil de comparar e difícil de manipular.

O Maturity Score é deliberadamente opinativo:

Cobre a prática inteira. Documentação precisa sozinha não garante um A: o drift é 40% do score, e os outros 60% vêm de insights, conformidade e entrega.

E comparável. O Projeto A tem um B. O Projeto B tem um D. A conversa sobre onde investir tempo de engenharia ficou mais simples.

E rastreável. Um numero que você pode plotar ao longo do tempo e um numero que você pode melhorar. Defina uma meta: "Todos os projetos em C ou acima ate o final do trimestre." Agora você tem um objetivo mensurável.

E honesto. A nota não se importa com intenções ou roadmaps. Ela mede o que é verdade agora. Sua documentação ou corresponde ao código ou não. Suas regras ou passam ou não.

Começando

O Maturity Score está disponível hoje para todos os projetos Archyl. Nenhuma configuração necessária — se você tem um projeto com documentação de arquitetura, você já tem uma nota.

1. Abra qualquer projeto. O selo de maturidade aparece no cabeçalho do projeto.
2. Clique nele para ver o detalhamento completo: nota geral, quatro dimensões, tendencia e recomendação.
3. Visite a pagina de Maturidade da Organização para ver todos os projetos de uma vez.

A saúde da arquitetura da sua organização não deveria ser um mistério. Agora é uma nota em letra.