Metodologia

Metodologia concebida para a confiança na decisão.

A RepoTruth explica não só o que observa, mas também os limites dessas observações.

A transparência da metodologia é fundamental para a confiança. Deve poder ver como cada resultado é alcançado, qual é a sua confiança e onde termina o seu conhecimento, para que as suas pessoas possam apoiar-se nas evidências e contestá-las. Esta página explica, em termos simples, como a RepoTruth chega ao que produz.

Solicitar um diagnóstico Ler o Modelo de confiança
  • Evidências, não veredictos
  • Delimitada por confiança
  • Incógnitas preservadas
  • Explicável
  • Revisão humana obrigatória

Como funciona a RepoTruth

De um instantâneo a um pacote pronto para a decisão, em cinco passos.

Cada passo é observável, explicável e somente leitura.

  1. Instantâneo

    É fornecida uma cópia somente leitura, num dado momento, do código. Nada é ligado e nada corre.

  2. Extração da realidade do repositório

    O sistema é observado tal como ele realmente é, estrutura, dependências, histórico, e os limites do que se pode ver são registados.

  3. Inteligência para a decisão

    A partir das evidências, a RepoTruth deriva onde investigar primeiro, qual a confiança de cada observação e o que permanece desconhecido.

  4. Geração do Pacote de diagnóstico

    Tudo é reunido numa só entrega estruturada, com a sua própria declaração explícita de limites.

  5. Revisão humana

    As suas pessoas leem, interpretam e decidem. A RepoTruth não conclui nada em seu nome.

A distinção fundadora

Interpretação ≠ Autoridade.

A RepoTruth foi concebida para interpretar evidências. A RepoTruth não está autorizada a exercer autoridade.

A interpretação é obrigatória, sem ela, a evidência é apenas dados. A autoridade é proibida, a decisão, e a responsabilidade, continuam a ser das suas pessoas. Tudo o que a RepoTruth produz vive dentro dessa única distinção.

A interpretação é obrigatória. A autoridade é proibida.

Ontologia da inteligência para a decisão

A RepoTruth produz inteligência, não decisões.

A plataforma gera um conjunto fixo de resultados baseados em evidências, e nada que se assemelhe a um veredicto.

  • Evidências

    Observações do sistema, citadas à sua fonte e delimitadas por confiança.

  • Possíveis pontos de atenção

    Observações estruturais levantadas para o juízo de um arquiteto, possíveis pontos de atenção para revisão, nunca veredictos.

  • Corredores de investigação

    Caminhos sugeridos através do sistema para revisão humana, uma forma de olhar, não uma forma de agir.

  • Prioridades de revisão

    Onde investigar primeiro, ordenadas por urgência de investigação e associadas à confiança.

  • Inventários de incógnitas

    Um registo explícito do que não se conseguiu determinar, trazido à superfície, não presumido como resolvido.

A RepoTruth interpreta as evidências e ordena onde olhar. A autoridade da decisão permanece sempre humana.

Constituição das pontuações

As pontuações indicam urgência de investigação, não verdade.

Cada pontuação responde a uma pergunta, onde devem os humanos olhar primeiro?, e nada mais.

  • Pontuação ≠ Verdade

    Uma pontuação reflete onde a atenção é mais bem aplicada, não um facto sobre o sistema.

  • Pontuação ≠ Gravidade

    Mede a urgência de investigação, nunca a seriedade ou o perigo de uma constatação.

  • Pontuação ≠ Recomendação

    Uma pontuação alta convida a um olhar mais atento. Nunca instrui ninguém a agir.

  • Sem pontuação global de saúde

    Não existe um único número para um repositório. Um veredicto numa só cifra não é deliberadamente produzido.

O único número sobre o qual um comprador ou um portão automatizado mais gostaria de agir é o número que esta metodologia se recusa a calcular.

Modelo de confiança

Cada observação transporta confiança.

A confiança delimita cada observação, comunica as suas limitações e mantém-se explicável, nunca uma caixa negra.

  1. Diretamente observado

    Lido diretamente do instantâneo, sem inferência.

  2. Fortemente derivado

    Inferido a partir de múltiplas observações consistentes.

  3. Moderadamente derivado

    Inferido a partir de evidências limitadas mas consistentes.

  4. Fracamente derivado

    Inferido a partir de evidências escassas ou parciais, com as lacunas declaradas.

  5. Inferido historicamente

    Derivado do histórico do repositório, onde está presente e é legível.

  6. Ambíguo

    A evidência sustenta mais do que uma leitura, trazida à superfície como ambiguidade, não resolvida por palpite.

  7. Não verificável

    Uma pergunta a que um instantâneo estático estruturalmente não consegue responder.

  8. Incógnita

    Sem evidência num sentido ou no outro, registada explicitamente, nunca inferida como encerrada.

Cada valor de confiança pode ser explicado: o que foi observado, o que foi inferido e porque não é sustentado com mais firmeza do que isso.

Preservação de incógnitas

As incógnitas são preservadas, nunca escondidas.

Onde a evidência se esgota, a RepoTruth regista a pergunta em vez de preencher uma resposta.

A maioria das ferramentas preenche em silêncio o que não consegue determinar, ou omite-o por completo. A RepoTruth trata a incógnita como uma entidade de primeira classe, nomeada, categorizada e trazida à superfície com o mesmo destaque que qualquer constatação.

Uma incógnita não é uma falha. Não é ruído. Não é baixo risco. É uma pergunta não avaliada, e muitas vezes a coisa mais útil do pacote, porque diz às suas pessoas exatamente o que perguntar a seguir.

  1. Incógnita

    Registada explicitamente onde a evidência está ausente, com a sua categoria e quem a poderia resolver.

  2. Revista

    Trazida à superfície para as suas pessoas como uma pergunta que vale a pena investigar, nunca resolvida por inferência.

  3. Resolvida

    Retirada apenas quando a evidência ou um humano fornece a resposta, nunca pela RepoTruth a preencher a lacuna.

Fluxo de revisão humana

Os humanos permanecem como instância final.

A RepoTruth apoia a revisão. As suas pessoas continuam responsáveis pela decisão.

  1. Observar

    As suas pessoas leem as evidências, as prioridades, a confiança e as incógnitas.

  2. Interpretar

    Trazem o contexto que a RepoTruth não pode ter, e formam um juízo a partir das evidências.

  3. Contestar

    Qualquer constatação pode ser questionada. Porque os resultados citam as suas evidências e confiança, podem ser verificados.

  4. Decidir

    A decisão é tomada por pessoas com a autoridade para a tomar, nunca pela plataforma.

Fronteiras constitucionais

A metodologia corre dentro de fronteiras permanentes.

Estas são propriedades da forma como a RepoTruth é construída, não opções que se possam configurar para lá delas.

  • Somente leitura

    Não escreve em nada no seu ambiente.

  • Baseada em instantâneos

    Analisa uma cópia inerte, num dado momento, nunca um sistema ao vivo.

  • Sem credenciais

    Não armazena, não pede e não reutiliza nenhuma.

  • Sem acesso a produção

    Nunca se liga a um sistema em funcionamento.

  • Sem execução

    Não corre nenhum código do seu repositório.

  • Sem remediação

    Não altera, não corrige e não aplica patches a nada.

  • Sem autoridade

    Não aprova, não certifica e não decide nada.

  • Revisão humana obrigatória

    Cada resultado é feito para um humano decidir.

Fluxo de geração do diagnóstico

Das evidências à entrega, um estágio explicável de cada vez.

Cada estágio assenta no anterior, e nada é afirmado com mais firmeza do que as evidências permitem.

  1. Evidências

    O que foi diretamente observado, citado à sua fonte.

  2. Sinais

    Padrões derivados das evidências, leituras sobre as quais um humano pode raciocinar.

  3. Pontuações

    Urgência de investigação sobre uma região, onde olhar primeiro, nunca quão mau é.

  4. Confiança

    Com que firmeza cada observação é sustentada, e porquê, explicável, nunca opaca.

  5. Incógnitas

    O que não se conseguiu determinar, registado explicitamente e levado adiante.

  6. Prioridades de revisão

    Uma ordenação de onde a atenção humana é mais bem aplicada primeiro.

  7. Pacote de diagnóstico

    Tudo reunido numa só entrega pronta para a decisão, com a sua própria declaração de limites.

FAQ da metodologia

Como o método se sustenta, em termos simples.

Como são calculadas as pontuações?

As pontuações são derivadas de forma determinística a partir das evidências observadas, por exemplo, quão fortemente outro código depende de uma região, ou quão ténue é o conhecimento disponível. Exprimem apenas urgência de investigação, e cada uma transporta a sua própria confiança. O mesmo instantâneo produz sempre as mesmas pontuações, e cada pontuação pode ser rastreada até às evidências que lhe estão por trás.

E se a confiança for baixa?

A baixa confiança é reportada, nunca escondida. Uma observação de baixa confiança é incerta, não errada, é um apelo a olhar mais de perto, a par de uma declaração honesta de porque não a sustentamos com mais firmeza. Uma constatação nunca é afirmada para além do que as evidências sustentam.

Como devem as incógnitas ser interpretadas?

Como perguntas, não como lacunas. Uma incógnita é não avaliada, não baixo risco e não segura. Uma região densa em incógnitas é precisamente onde a investigação humana é mais valiosa. As incógnitas são resolvidas apenas por evidência ou por um humano, nunca inferidas como encerradas.

Os resultados podem ser automatizados?

Os resultados da RepoTruth são feitos para revisão humana e são não acionáveis por construção. Não foram concebidos para controlar um pipeline, desencadear uma ação ou substituir uma decisão. O pacote informa as pessoas; as pessoas decidem.

A RepoTruth pode aprovar decisões arquitetónicas?

Não. A RepoTruth produz evidências e possíveis pontos de atenção para o juízo de um arquiteto. Não aprova nada e não decide nada. As decisões arquitetónicas são tomadas por pessoas com a autoridade para as tomar.

Porque é que a RepoTruth evita recomendações?

Porque interpretação não é recomendação. Uma recomendação encerra uma decisão que a RepoTruth não tem legitimidade para tomar, falta-lhe o seu contexto, as suas restrições e a sua autoridade. Ao produzir antes evidências, prioridades e incógnitas, a RepoTruth mantém o juízo, e a responsabilidade, com as suas pessoas.

Compreenda como a RepoTruth chega às suas conclusões, e os seus limites.

Um diagnóstico somente leitura, delimitado à sua decisão.

Diga-nos a decisão que enfrenta. Delimitaremos um Pacote de diagnóstico a ela, produzido pelo método desta página, somente leitura e baseado em instantâneos, com cada constatação a transportar as suas evidências, a sua confiança e as suas incógnitas.

Solicitar um diagnóstico Solicitar um pacote de exemplo

Evidências, não veredictos. A revisão humana permanece como instância final.