Méthodologie

Une méthodologie conçue pour la confiance dans la décision.

RepoTruth explique non seulement ce qu'il observe, mais aussi les limites de ces observations.

La transparence de la méthodologie est fondamentale pour la confiance. Vous devriez pouvoir voir comment chaque sortie est atteinte, à quel point elle est confiante, et où s'arrête sa connaissance, afin que vos équipes puissent se fier aux preuves et les contester. Cette page explique, en termes clairs, comment RepoTruth parvient à ce qu'il produit.

  • Des preuves, pas des verdicts
  • Cadré par la confiance
  • Inconnues préservées
  • Explicable
  • Revue humaine requise

Comment RepoTruth fonctionne

D'un instantané à un dossier prêt pour la décision, en cinq étapes.

Chaque étape est observable, explicable et en lecture seule.

  1. Instantané

    Une copie en lecture seule, figée dans le temps, de la base de code est fournie. Rien n'est connecté et rien ne s'exécute.

  2. Extraction de la réalité du dépôt

    Le système est observé tel qu'il est réellement, structure, dépendances, historique, et les limites de ce qui peut être vu sont consignées.

  3. Intelligence décisionnelle

    À partir des preuves, RepoTruth déduit où enquêter en premier, à quel point chaque observation est confiante, et ce qui demeure inconnu.

  4. Génération du Dossier de diagnostic

    Tout est assemblé en un seul livrable structuré, avec son propre énoncé explicite de limites.

  5. Revue humaine

    Vos équipes lisent, interprètent et décident. RepoTruth ne conclut rien en leur nom.

La distinction fondatrice

Interprétation ≠ Autorité.

RepoTruth est conçu pour interpréter les preuves. RepoTruth n'est pas autorisé à exercer une autorité.

L'interprétation est obligatoire, sans elle, les preuves ne sont que des données. L'autorité est interdite, la décision, et la responsabilité, demeurent celles de vos équipes. Tout ce que RepoTruth produit vit à l'intérieur de cette seule distinction.

L'interprétation est obligatoire. L'autorité est interdite.

Ontologie de l'intelligence décisionnelle

RepoTruth produit de l'intelligence, pas des décisions.

La plateforme génère un ensemble fixe de sorties fondées sur les preuves, et rien qui ressemble à un verdict.

  • Preuves

    Des observations du système, citées à leur source et cadrées par la confiance.

  • Points d'attention potentiels

    Des observations structurelles soulevées pour le jugement d'un architecte, des candidats à l'examen, jamais des verdicts.

  • Couloirs d'investigation

    Des chemins suggérés à travers le système pour la revue humaine, une façon de regarder, pas une façon d'agir.

  • Priorités d'examen

    Où enquêter en premier, ordonné par urgence d'enquête et associé à la confiance.

  • Inventaires des inconnues

    Un relevé explicite de ce qui n'a pas pu être déterminé, mis en évidence, pas évacué par supposition.

RepoTruth interprète les preuves et ordonne où regarder. L'autorité de décision demeure toujours humaine.

Constitution des scores

Les scores indiquent l'urgence d'enquête, pas la vérité.

Chaque score répond à une seule question, où les humains devraient-ils regarder en premier ?, et rien de plus.

  • Score ≠ Vérité

    Un score reflète où l'attention est le mieux investie, pas un fait à propos du système.

  • Score ≠ Gravité

    Il mesure l'urgence d'enquête, jamais le sérieux ou le danger d'un constat.

  • Score ≠ Recommandation

    Un score élevé invite à un examen plus attentif. Il n'ordonne jamais à quiconque d'agir.

  • Aucun score de santé global

    Il n'existe aucun nombre unique pour un dépôt. Un verdict en un seul chiffre n'est délibérément pas produit.

Le seul nombre sur lequel un acheteur ou une barrière automatisée aimerait le plus agir est le nombre que cette méthodologie refuse de calculer.

Modèle de confiance

Chaque observation porte une confiance.

La confiance cadre chaque observation, communique ses limitations, et demeure explicable, jamais une boîte noire.

  1. Directement observé

    Lu directement depuis l'instantané, sans aucune inférence.

  2. Fortement déduit

    Inféré à partir de multiples observations cohérentes.

  3. Modérément déduit

    Inféré à partir de preuves limitées mais cohérentes.

  4. Faiblement déduit

    Inféré à partir de preuves rares ou partielles, avec les lacunes énoncées.

  5. Inféré historiquement

    Dérivé de l'historique du dépôt, là où il est présent et lisible.

  6. Ambigu

    Les preuves soutiennent plus d'une lecture, mis en évidence comme ambiguïté, pas résolu par supposition.

  7. Invérifiable

    Une question à laquelle un instantané statique ne peut structurellement répondre.

  8. Inconnue

    Aucune preuve dans un sens ou dans l'autre, consigné explicitement, jamais inféré clos.

Chaque valeur de confiance peut être expliquée : ce qui a été observé, ce qui a été inféré, et pourquoi elle n'est pas tenue plus fermement que cela.

Préservation des inconnues

Les inconnues sont préservées, jamais cachées.

Là où les preuves s'épuisent, RepoTruth consigne la question plutôt que de combler une réponse.

La plupart des outils comblent discrètement ce qu'ils ne peuvent déterminer, ou l'omettent entièrement. RepoTruth traite l'inconnue comme une entité de premier plan, nommée, catégorisée, et mise en évidence avec la même importance que n'importe quel constat.

Une inconnue n'est pas un échec. Ce n'est pas du bruit. Ce n'est pas un faible risque. C'est une question non évaluée, et souvent la chose la plus utile du dossier, parce qu'elle dit à vos équipes exactement quoi demander ensuite.

  1. Inconnue

    Consignée explicitement là où les preuves sont absentes, avec sa catégorie et qui pourrait la résoudre.

  2. Examinée

    Mise en évidence pour vos équipes comme une question qu'il vaut la peine d'enquêter, jamais évacuée par inférence.

  3. Résolue

    Retirée uniquement lorsque des preuves ou un humain fournissent la réponse, jamais par RepoTruth comblant la lacune.

Flux de travail de la revue humaine

Les humains demeurent terminaux.

RepoTruth soutient la revue. Vos équipes demeurent responsables de la décision.

  1. Observer

    Vos équipes lisent les preuves, les priorités, la confiance et les inconnues.

  2. Interpréter

    Elles apportent un contexte que RepoTruth ne peut avoir, et forment un jugement à partir des preuves.

  3. Contester

    Tout constat peut être remis en question. Parce que les sorties citent leurs preuves et leur confiance, elles peuvent être vérifiées.

  4. Décider

    La décision est prise par des personnes ayant l'autorité de la prendre, jamais par la plateforme.

Frontières constitutionnelles

La méthodologie s'exécute à l'intérieur de frontières permanentes.

Ce sont des propriétés de la façon dont RepoTruth est construit, pas des options qu'on peut configurer pour les outrepasser.

  • Lecture seule

    Il n'écrit rien dans votre environnement.

  • Fondé sur un instantané

    Il analyse une copie inerte, figée dans le temps, jamais un système en direct.

  • Aucun identifiant

    Il n'en stocke, n'en demande et n'en réutilise aucun.

  • Aucun accès à la production

    Il ne se connecte jamais à un système en cours d'exécution.

  • Aucune exécution

    Il n'exécute aucun code de votre dépôt.

  • Aucune correction

    Il ne change, ne corrige et ne patche rien.

  • Aucune autorité

    Il n'approuve, ne certifie et ne décide rien.

  • Revue humaine requise

    Chaque sortie est conçue pour qu'un humain décide.

Flux de génération du diagnostic

Des preuves au livrable, une étape explicable à la fois.

Chaque étape s'appuie sur la précédente, et rien n'est affirmé plus fermement que ce que les preuves permettent.

  1. Preuves

    Ce qui a été directement observé, cité à sa source.

  2. Signaux

    Des motifs dérivés des preuves, des lectures sur lesquelles un humain peut raisonner.

  3. Scores

    Urgence d'enquête sur une région, où regarder en premier, jamais à quel point c'est grave.

  4. Confiance

    Avec quelle fermeté chaque observation est tenue, et pourquoi, explicable, jamais opaque.

  5. Inconnues

    Ce qui n'a pas pu être déterminé, consigné explicitement et reporté.

  6. Priorités d'examen

    Un ordonnancement de là où l'attention humaine est le mieux investie en premier.

  7. Dossier de diagnostic

    Tout assemblé en un seul livrable prêt pour la décision, avec son propre énoncé de limites.

FAQ méthodologie

Comment la méthode tient, en termes clairs.

Comment les scores sont-ils calculés ?

Les scores sont dérivés de manière déterministe à partir des preuves observées, par exemple, à quel point d'autres parties du code dépendent d'une région, ou à quel point la connaissance disponible est mince. Ils expriment uniquement l'urgence d'enquête, et chacun porte sa propre confiance. Le même instantané produit toujours les mêmes scores, et chaque score peut être retracé jusqu'aux preuves qui le sous-tendent.

Que se passe-t-il si la confiance est faible ?

Une faible confiance est rapportée, jamais cachée. Une observation à faible confiance est incertaine, pas erronée, c'est un appel à regarder de plus près, accompagné d'un énoncé honnête de pourquoi nous ne la tenons pas plus fermement. Un constat n'est jamais affirmé au-delà de ce que les preuves soutiennent.

Comment les inconnues devraient-elles être interprétées ?

Comme des questions, pas comme des lacunes. Une inconnue est non évaluée, pas un faible risque et pas sûre. Une région dense d'inconnues est précisément là où l'enquête humaine est la plus précieuse. Les inconnues sont résolues uniquement par des preuves ou un humain, jamais inférées closes.

Les sorties peuvent-elles être automatisées ?

Les sorties de RepoTruth sont conçues pour la revue humaine et sont non actionnables par construction. Elles ne sont pas conçues pour conditionner un pipeline, déclencher une action ou se substituer à une décision. Le dossier informe les personnes ; les personnes décident.

RepoTruth peut-il approuver des décisions architecturales ?

Non. RepoTruth produit des preuves et des points d'attention potentiels pour le jugement d'un architecte. Il n'approuve rien et ne décide rien. Les décisions architecturales sont prises par des personnes ayant l'autorité de les prendre.

Pourquoi RepoTruth évite-t-il les recommandations ?

Parce que l'interprétation n'est pas une recommandation. Une recommandation intègre une décision que RepoTruth n'a aucune légitimité à prendre, il lui manque votre contexte, vos contraintes et votre autorité. En produisant plutôt des preuves, des priorités et des inconnues, RepoTruth laisse le jugement, et la responsabilité, à vos équipes.

Comprenez comment RepoTruth parvient à ses conclusions, et ses limites.

Un diagnostic en lecture seule, cadré sur votre décision.

Dites-nous la décision à laquelle vous faites face. Nous cadrerons un Dossier de diagnostic dessus, produit par la méthode de cette page, en lecture seule et fondé sur un instantané, chaque constat portant ses preuves, sa confiance et ses inconnues.

Des preuves, pas des verdicts. La revue humaine demeure terminale.