A entrega principal
Um retrato baseado em evidências para quem decide.
O Pacote de diagnóstico é um relato estruturado do que foi observado, do que merece investigação, do nosso nível de confiança e do que permanece desconhecido, reunido para que um executivo e um arquiteto o leiam em conjunto e ajam sobre ele. Não é um relatório, um painel, um cartão de pontuação nem um veredicto. É inteligência para a decisão.
Porque existe
As ferramentas operacionais respondem a perguntas operacionais. A decisão precisa de algo diferente.
A maioria das ferramentas foi construída para responder a perguntas operacionais, está a correr, está seguro, a compilação está verde. Nenhuma foi construída para o momento da decisão, quando uma equipa de liderança tem de se comprometer a mudar um software que não compreende por completo.
Os painéis reportam estado; os scanners reportam problemas. Nenhum lhe diz onde a compreensão é ténue, onde a investigação deve começar, nem que confiança alguém deve ter. Descrevem o sistema, não informam a decisão.
Uma decisão é tomada por pessoas com pontos de vista diferentes. O pacote dá a um executivo e a um arquiteto as mesmas evidências, as mesmas prioridades e o mesmo relato honesto das incógnitas, para que decidam a partir de um retrato, não de três opiniões.
O Pacote de diagnóstico existe para a decisão, e é honesto quanto aos limites do que sabe.
O que contém
Cada componente mostra o que a RepoTruth vê, o que interpreta e o que só as suas pessoas podem decidir.
Um relato legível pela liderança, o que foi observado, o que merece investigação e o que permanece desconhecido, de uma só vez.
Traz à superfície uma orientação baseada em evidências para quem decide.
Não aprova, rejeita nem recomenda um curso de ação.
A estrutura e os estratos reais do sistema, módulos, fronteiras, concentração de dependências e como se formou ao longo do tempo, observados em vez de presumidos.
Traz à superfície a forma real do sistema, mapeada a partir de evidências.
Não classifica a arquitetura nem a declara boa ou má.
Cada observação, citada à sua fonte, transportando a sua própria confiança, a base auditável sobre a qual tudo o resto assenta.
Traz à superfície evidências rastreáveis que um revisor pode verificar.
Não apresenta inferência como facto.
Onde investigar primeiro, ordenado por urgência de investigação e associado à confiança e à densidade de incógnitas.
Traz à superfície urgência de investigação, onde a atenção humana é mais bem aplicada primeiro.
Não recomenda ações, nem ordena por gravidade.
O que não se conseguiu determinar, titularidade, comportamento em execução, justificações, trazido à superfície explicitamente e com igual destaque.
Traz à superfície as perguntas que vale a pena fazer a seguir.
Não esconde lacunas nem as resolve por inferência.
Com que firmeza cada constatação é sustentada, e porquê, decomposta nas suas evidências, nunca um único número opaco.
Traz à superfície confiança explicável para cada observação.
Não produz pontuações de caixa negra.
As evidências tornadas visíveis, concentração de dependências, conhecimento que se torna ténue, o nevoeiro de incógnitas, exploráveis até às evidências subjacentes.
Traz à superfície uma leitura visual legível das evidências.
Não emite uma pontuação, classificação ou veredicto.
Uma declaração simples de exatamente o que foi analisado, o que não foi, o que permanece desconhecido e os limites dentro dos quais a RepoTruth opera.
Traz à superfície os próprios limites do pacote, por escrito.
Não exagera, certifica nem dá a entender completude.
Dentro do Relatório executivo
Feito para que quem decide e quem concebe leiam a partir das mesmas evidências.
A forma da decisão: o que foi observado, o que merece a investigação mais precoce e o que ainda é desconhecido, numa linguagem sobre a qual uma equipa de liderança pode agir.
A realidade estrutural e os seus pontos de atenção, estrangulamentos, concentração de dependências, fronteiras, cada um como possível ponto de atenção para o juízo humano, nunca um veredicto.
Um relato explícito das perguntas a que o instantâneo não conseguiu responder, levado para o relatório em vez de dele excluído.
O Inventário de incógnitas
Uma incógnita não é uma lacuna a esconder. É uma das coisas mais úteis que lhe podemos dar.
A maioria das ferramentas preenche em silêncio o que não consegue determinar, ou omite-o por completo. A RepoTruth regista-o. Onde a evidência se esgota, o pacote nomeia uma Incógnita, explicitamente, com destaque, e como uma constatação de primeira classe.
Uma incógnita não é baixo risco. É não avaliada. Uma região cheia de incógnitas não é segura, é precisamente onde as suas pessoas devem olhar. Muitas vezes, a página mais valiosa do pacote é a que enumera, exatamente, as perguntas que vale a pena fazer a seguir.
Preferimos dizer-lhe a verdade sobre o que não conseguimos ver a entregar-lhe uma falsa sensação de completude.
Matriz de confiança
Sem conclusões de caixa negra. Nada afirmado com mais firmeza do que as evidências permitem.
O que foi observado, citado à sua fonte, a base que um revisor pode verificar de forma independente.
Com que firmeza é sustentada, numa escala explicável, decomposta nas suas razões, nunca um único número opaco.
O que mudaria a constatação se fosse resolvido, a degradação e as incógnitas declaradas a par dela.
A confiança descreve com que firmeza sabemos algo. Nunca descreve se deve agir.
Manifesto constitucional
A página mais honesta é a que traça a fronteira.
Cada Pacote de diagnóstico é entregue com um Manifesto constitucional, um relato simples que uma equipa de segurança ou jurídica pode ler, declarando exatamente onde a análise começou e terminou.
Um pacote em que pode confiar é o que lhe diz onde o seu conhecimento termina.
Camada de visualização de evidências
A Projeção do Observatory torna visíveis as evidências do pacote, a camada de visualização por baixo das constatações, não um veredicto.
Revela onde a dependência se concentra, onde a mudança se agita, onde a titularidade é incerta, onde o conhecimento se torna ténue e onde as incógnitas se agrupam, as regiões que mais merecem a leitura humana mais atenta, e mantém-se explorável até às evidências subjacentes.
Mostra; não atribui notas, não calcula pontuação e não decide nada. As suas pessoas interpretam-no.
Na prática
Uma só entrega, usada antes dos momentos mais difíceis de reverter.
Compreenda onde a mudança automatizada acarreta mais risco, para que a revisão humana a preceda.
Identifique onde a mudança tende a propagar-se, e onde olhar antes de avançar.
Veja a estrutura real, e as suas incógnitas, antes de assumir um programa plurianual.
Estabeleça a linha de base observada antes de a redesenhar.
Construa uma base de evidências defensável e somente leitura para o processo de diligência.
Forme uma visão técnica independente do alvo, sem tocar no ativo.
Avalie o software entregue de forma objetiva, com base em evidências e não em afirmações.
Garantias constitucionais
Seis garantias permanentes, propriedades da forma como a RepoTruth é construída, não definições que aceite por fé.
Não escrevemos em nada no seu ambiente. Não há caminho pelo qual a RepoTruth possa alterar o seu código.
Analisamos uma cópia inerte, num dado momento, nunca um sistema ao vivo ou em funcionamento.
Nunca nos ligamos a produção. Nem para observar, nem por qualquer motivo.
Não armazenamos, não pedimos e não reutilizamos credenciais, porque não nos ligamos a nada que delas precise.
Não executamos, não implantamos e não remediamos nada. A RepoTruth não pode atuar nos seus sistemas.
Cada resultado é feito para um humano rever e decidir. A RepoTruth não chega a nenhuma conclusão própria.
Veja por si próprio
Antes de partilhar o que quer que seja seu, pode percorrer um Pacote de diagnóstico completo, montado sobre um código sintético, relatório executivo, atlas, catálogo de evidências, prioridades de revisão, inventário de incógnitas, matriz de confiança e manifesto constitucional. É inteiramente sintético: sem artefactos de clientes, sem repositório real, sem métricas inventadas.
Solicitar o pacote de amostraFornecido mediante pedido. Apenas demonstração sintética.
Um diagnóstico somente leitura, delimitado à sua decisão.
Diga-nos a decisão que enfrenta. Delimitaremos um Pacote de diagnóstico a ela, somente leitura, baseado em instantâneos, sem acesso a produção e sem qualquer obrigação de agir sobre o que encontrarmos. As suas pessoas saberão onde olhar primeiro, qual o nosso nível de confiança e o que continua desconhecido.
Sem credenciais. Sem acesso a produção. Nunca alteramos o seu código.
