Le livrable phare
Une image fondée sur les preuves pour ceux qui décident.
Le Dossier de diagnostic est un exposé structuré de ce qui a été observé, de ce qui mérite une enquête, du degré de notre confiance et de ce qui demeure inconnu, assemblé pour qu'un dirigeant et un architecte le lisent ensemble et agissent dessus. Ce n'est ni un rapport, ni un tableau de bord, ni une carte de score, ni un verdict. C'est de l'intelligence décisionnelle.
Pourquoi il existe
L'outillage opérationnel répond à des questions opérationnelles. La décision a besoin d'autre chose.
La plupart des outils ont été conçus pour répondre à des questions opérationnelles, tourne-t-il, est-il sécurisé, le build est-il vert. Aucun n'a été conçu pour le moment de la décision, lorsqu'une équipe dirigeante doit s'engager à changer un logiciel qu'elle ne comprend pas pleinement.
Les tableaux de bord rapportent un état ; les scanners rapportent des problèmes. Ni l'un ni l'autre ne vous dit où la compréhension est mince, où l'enquête devrait commencer, ou à quel point quiconque devrait être confiant. Ils décrivent le système, ils n'éclairent pas la décision.
Une décision est prise par des personnes ayant des points de vue différents. Le dossier donne à un dirigeant et à un architecte les mêmes preuves, les mêmes priorités, et le même exposé honnête des inconnues, afin qu'ils décident à partir d'une seule image, et non de trois opinions.
Le Dossier de diagnostic existe pour la décision, et est honnête sur les limites de ce qu'il sait.
Ce qu'il contient
Chaque composant montre ce que RepoTruth voit, ce qu'il interprète, et ce que seules vos équipes peuvent décider.
Un exposé lisible par les dirigeants, ce qui a été observé, ce qui mérite une enquête, et ce qui demeure inconnu, en une seule lecture.
Met en évidence une orientation fondée sur les preuves pour les décideurs.
Ne fait pas approuver, rejeter ou recommander une marche à suivre.
La structure et les strates réelles du système, modules, frontières, concentration des dépendances, et comment il s'est formé au fil du temps, observées plutôt que supposées.
Met en évidence la forme réelle du système, cartographiée à partir des preuves.
Ne fait pas noter l'architecture ni la déclarer bonne ou mauvaise.
Chaque observation, citée à sa source, portant chacune sa propre confiance, la base auditable sur laquelle tout le reste repose.
Met en évidence des preuves traçables qu'un examinateur peut vérifier.
Ne fait pas présenter l'inférence comme un fait.
Où enquêter en premier, ordonné par urgence d'enquête et associé à la confiance et à la densité d'inconnues.
Met en évidence l'urgence d'enquête, où l'attention humaine est le mieux investie en premier.
Ne fait pas recommander d'actions, ni classer par gravité.
Ce qui n'a pas pu être déterminé, propriété, comportement à l'exécution, justification, mis en évidence explicitement et avec une importance égale.
Met en évidence les questions qu'il vaut la peine de poser ensuite.
Ne fait pas cacher les lacunes ni les évacuer par inférence.
Avec quelle fermeté chaque constat est tenu, et pourquoi, décomposé en ses preuves, jamais un unique nombre opaque.
Met en évidence une confiance explicable pour chaque observation.
Ne fait pas produire de scores en boîte noire.
Les preuves rendues visibles, concentration des dépendances, amincissement de la connaissance, le brouillard des inconnues, explorable jusqu'aux preuves sous-jacentes.
Met en évidence une lecture visuelle lisible des preuves.
Ne fait pas émettre de score, de note ou de verdict.
Un énoncé clair de exactement ce qui a été analysé, ce qui ne l'a pas été, ce qui demeure inconnu, et les limites dans lesquelles RepoTruth opère.
Met en évidence les propres limites du dossier, par écrit.
Ne fait pas de revendication excessive, ne certifie pas, ni n'implique l'exhaustivité.
Au cœur du Rapport exécutif
Conçu pour que ceux qui décident et ceux qui conçoivent lisent à partir des mêmes preuves.
La forme de la décision : ce qui a été observé, ce qui mérite l'enquête la plus précoce, et ce qui demeure inconnu, dans un langage sur lequel une équipe dirigeante peut agir.
La réalité structurelle et ses points d'attention, goulots d'étranglement, concentration des dépendances, frontières, chacun comme un point d'attention potentiel pour le jugement humain, jamais un verdict.
Un exposé explicite des questions auxquelles l'instantané n'a pas pu répondre, porté dans le rapport plutôt que laissé de côté.
L'Inventaire des inconnues
Une inconnue n'est pas une lacune à cacher. C'est l'une des choses les plus utiles que nous puissions vous donner.
La plupart des outils comblent discrètement ce qu'ils ne peuvent déterminer, ou l'omettent entièrement. RepoTruth le consigne. Là où les preuves s'épuisent, le dossier nomme une Inconnue, explicitement, de manière visible, et comme un constat de premier plan.
Une inconnue n'est pas un faible risque. Elle est non évaluée. Une région pleine d'inconnues n'est pas sûre, c'est précisément là que vos équipes devraient regarder. Souvent, la page la plus précieuse du dossier est celle qui énumère, exactement, les questions qu'il vaut la peine de poser ensuite.
Nous préférons vous dire la vérité sur ce que nous ne pouvons pas voir plutôt que de vous donner un faux sentiment d'exhaustivité.
Matrice de confiance
Aucune conclusion en boîte noire. Rien d'affirmé plus fermement que ce que les preuves permettent.
Ce qui a été observé, cité à sa source, la base qu'un examinateur peut vérifier de façon indépendante.
Avec quelle fermeté elle est tenue, sur une échelle explicable, décomposée en ses raisons, jamais un unique nombre opaque.
Ce qui changerait le constat s'il était résolu, la dégradation et les inconnues énoncées à ses côtés.
La confiance décrit avec quelle fermeté nous savons quelque chose. Elle ne décrit jamais si vous devriez agir.
Manifeste constitutionnel
La page la plus honnête est celle qui trace la frontière.
Chaque Dossier de diagnostic est livré avec un Manifeste constitutionnel, un exposé clair qu'une équipe de sécurité ou juridique peut lire, déclarant exactement où l'analyse a commencé et où elle s'est terminée.
Un dossier auquel vous pouvez faire confiance est un dossier qui vous dit où s'arrête sa connaissance.
Couche de visualisation des preuves
La Projection Observatory rend visibles les preuves du dossier, la couche de visualisation sous les constats, pas un verdict.
Elle révèle où la dépendance se concentre, où le changement s'agite, où la propriété est incertaine, où la connaissance s'amincit, et où les inconnues se regroupent, les régions qui méritent le plus la lecture la plus attentive d'un humain, et reste explorable jusqu'aux preuves sous-jacentes.
Elle montre ; elle n'attribue aucune note, ne calcule aucun score, et ne décide de rien. Vos équipes l'interprètent.
En pratique
Un seul livrable, utilisé avant les moments les plus difficiles à inverser.
Comprenez où le changement automatisé comporte le plus de risque, afin que la revue humaine le précède.
Identifiez où le changement est susceptible de se propager, et où regarder avant de bouger.
Voyez la structure réelle, et ses inconnues, avant d'engager un programme pluriannuel.
Établissez la référence observée avant de la redessiner.
Constituez une base de preuves défendable et en lecture seule pour le dossier de diligence.
Formez une vue technique indépendante de la cible, sans toucher à l'actif.
Évaluez objectivement le logiciel livré, sur des preuves plutôt que sur des affirmations.
Garanties constitutionnelles
Six garanties permanentes, des propriétés de la façon dont RepoTruth est construit, pas des réglages que vous prenez sur parole.
Nous n'écrivons rien dans votre environnement. Il n'existe aucun chemin par lequel RepoTruth puisse modifier votre code.
Nous analysons une copie inerte, figée dans le temps, jamais un système en direct ou en cours d'exécution.
Nous ne nous connectons jamais à la production. Ni pour observer, ni pour aucune raison.
Nous ne stockons, ne demandons et ne réutilisons aucun identifiant, parce que nous ne nous connectons à rien qui en ait besoin.
Nous n'exécutons, ne déployons et ne corrigeons rien. RepoTruth ne peut pas agir sur vos systèmes.
Chaque sortie est conçue pour qu'un humain l'examine et décide. RepoTruth ne parvient à aucune conclusion qui lui soit propre.
Voyez par vous-même
Avant de partager quoi que ce soit qui vous appartienne, vous pouvez parcourir un Dossier de diagnostic complet assemblé sur une base de code synthétique, rapport exécutif, atlas, catalogue des preuves, priorités d'examen, inventaire des inconnues, matrice de confiance et manifeste constitutionnel. Il est entièrement synthétique : aucun artefact client, aucun dépôt réel, aucune métrique inventée.
Demander le dossier exempleFourni sur demande. Démonstration synthétique uniquement.
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, en lecture seule, fondé sur un instantané, sans accès à la production et sans obligation d'agir sur ce que nous trouvons. Vos équipes sauront où regarder en premier, à quel point nous sommes confiants, et ce qui demeure inconnu.
Aucun identifiant. Aucun accès à la production. Nous ne modifions jamais votre code.
