Metodología
Metodología diseñada para la confianza en la decisión.
RepoTruth explica no solo lo que observa, sino también los límites de esas observaciones.
La transparencia de la metodología es fundamental para la confianza. Debería poder ver cómo se alcanza cada salida, cuánta confianza tiene y dónde termina su conocimiento, para que sus personas puedan apoyarse en la evidencia y cuestionarla. Esta página explica, en términos llanos, cómo llega RepoTruth a lo que produce.
- Evidencia, no veredictos
- Acotado por confianza
- Incógnitas preservadas
- Explicable
- Revisión humana obligatoria
Cómo funciona RepoTruth
De una instantánea a un paquete listo para la decisión, en cinco pasos.
Cada paso es observable, explicable y de solo lectura.
-
Instantánea
Se proporciona una copia de solo lectura y de un momento concreto de la base de código. Nada se conecta y nada se ejecuta.
-
Extracción de la realidad del repositorio
El sistema se observa tal como es realmente, estructura, dependencias, historia, y se registran los límites de lo que se puede ver.
-
Inteligencia para la decisión
A partir de la evidencia, RepoTruth deriva dónde investigar primero, cuánta confianza tiene cada observación y qué permanece como incógnita.
-
Generación del Paquete de diagnóstico
Todo se ensambla en un único entregable estructurado, con su propia declaración explícita de límites.
-
Revisión humana
Sus personas leen, interpretan y deciden. RepoTruth no concluye nada en su nombre.
La distinción fundacional
Interpretación ≠ Autoridad.
RepoTruth está diseñado para interpretar la evidencia. RepoTruth no tiene permitido ejercer autoridad.
La interpretación es obligatoria, sin ella, la evidencia es solo datos. La autoridad está prohibida, la decisión, y la responsabilidad, siguen siendo de sus personas. Todo lo que RepoTruth produce vive dentro de esa única distinción.
La interpretación es obligatoria. La autoridad está prohibida.
Ontología de la inteligencia para la decisión
RepoTruth produce inteligencia, no decisiones.
La plataforma genera un conjunto fijo de salidas basadas en evidencia, y nada que se parezca a un veredicto.
-
Evidencia
Observaciones del sistema, citadas a su fuente y acotadas por confianza.
-
Posibles puntos de atención
Observaciones estructurales planteadas para el juicio de un arquitecto, posibles puntos de atención para revisión, nunca veredictos.
-
Corredores de investigación
Rutas sugeridas a través del sistema para la revisión humana, una manera de mirar, no una manera de actuar.
-
Prioridades de revisión
Dónde investigar primero, ordenado por urgencia de investigación y emparejado con confianza.
-
Inventarios de incógnitas
Un registro explícito de lo que no pudo determinarse, expuesto, no supuesto para descartarlo.
RepoTruth interpreta la evidencia y ordena dónde mirar. La autoridad de la decisión siempre sigue siendo humana.
Constitución de las puntuaciones
Las puntuaciones indican urgencia de investigación, no verdad.
Cada puntuación responde a una pregunta, ¿dónde deben mirar primero los humanos?, y nada más.
-
Puntuación ≠ Verdad
Una puntuación refleja dónde se emplea mejor la atención, no un hecho sobre el sistema.
-
Puntuación ≠ Gravedad
Mide la urgencia de investigación, nunca la seriedad o el peligro de un hallazgo.
-
Puntuación ≠ Recomendación
Una puntuación alta invita a una mirada más atenta. Nunca instruye a nadie a actuar.
-
Sin puntuación global de salud
No hay un único número para un repositorio. Un veredicto de una sola cifra no se produce deliberadamente.
El único número sobre el que un comprador o una compuerta automatizada más querría actuar es el número que esta metodología se niega a calcular.
Modelo de confianza
Cada observación porta confianza.
La confianza acota cada observación, comunica sus limitaciones y se mantiene explicable, nunca una caja negra.
-
Directamente observado
Leído directamente de la instantánea, sin inferencia.
-
Fuertemente derivado
Inferido a partir de múltiples observaciones consistentes.
-
Moderadamente derivado
Inferido a partir de evidencia limitada pero consistente.
-
Débilmente derivado
Inferido a partir de evidencia escasa o parcial, con los vacíos declarados.
-
Inferido históricamente
Derivado de la historia del repositorio, donde está presente y es legible.
-
Ambiguo
La evidencia admite más de una lectura, expuesto como ambigüedad, no resuelto por conjetura.
-
No verificable
Una pregunta que una instantánea estática no puede responder estructuralmente.
-
Incógnita
Sin evidencia en ningún sentido, registrada de forma explícita, nunca inferida para cerrarla.
Cada valor de confianza puede explicarse: qué se observó, qué se infirió y por qué no se sostiene con más firmeza que esa.
Preservación de incógnitas
Las incógnitas se preservan, nunca se ocultan.
Donde se agota la evidencia, RepoTruth registra la pregunta en lugar de rellenar una respuesta.
La mayoría de las herramientas rellenan en silencio lo que no pueden determinar, o lo omiten por completo. RepoTruth trata la incógnita como una entidad de primer orden, nombrada, categorizada y expuesta con la misma prominencia que cualquier hallazgo.
Una incógnita no es un fracaso. No es ruido. No es bajo riesgo. Es una pregunta no evaluada, y a menudo lo más útil del paquete, porque le dice a sus personas exactamente qué preguntar a continuación.
-
Incógnita
Registrada de forma explícita donde la evidencia está ausente, con su categoría y quién podría resolverla.
-
Revisada
Expuesta a sus personas como una pregunta que vale la pena investigar, nunca inferida para descartarla.
-
Resuelta
Retirada solo cuando la evidencia o un humano aporta la respuesta, nunca por RepoTruth rellenando el vacío.
Flujo de trabajo de revisión humana
El humano sigue siendo terminal.
RepoTruth apoya la revisión. Sus personas siguen siendo responsables de la decisión.
-
Observar
Sus personas leen la evidencia, las prioridades, la confianza y las incógnitas.
-
Interpretar
Aportan un contexto que RepoTruth no puede tener, y forman un juicio a partir de la evidencia.
-
Cuestionar
Cualquier hallazgo puede ponerse en duda. Como las salidas citan su evidencia y confianza, pueden comprobarse.
-
Decidir
La decisión la toman las personas con autoridad para tomarla, nunca la plataforma.
Fronteras constitucionales
La metodología se ejecuta dentro de fronteras permanentes.
Son propiedades de cómo está construido RepoTruth, no opciones que puedan configurarse para sortearlas.
Solo lectura
No escribe nada en su entorno.
Basada en instantánea
Analiza una copia inerte y de un momento concreto, nunca un sistema en vivo.
Sin credenciales
No almacena, solicita ni reutiliza ninguna.
Sin acceso a producción
Nunca se conecta a un sistema en marcha.
Sin ejecución
No ejecuta ningún código de su repositorio.
Sin reparación
No cambia, arregla ni parchea nada.
Sin autoridad
No aprueba, certifica ni decide nada.
Revisión humana obligatoria
Cada salida está construida para que un humano decida sobre ella.
Flujo de generación del diagnóstico
De la evidencia al entregable, una etapa explicable a la vez.
Cada etapa se apoya en la anterior, y nada se afirma con más firmeza de la que permite la evidencia.
-
Evidencia
Lo que se observó directamente, citado a su fuente.
-
Señales
Patrones derivados de la evidencia, lecturas sobre las que un humano puede razonar.
-
Puntuaciones
Urgencia de investigación sobre una región, dónde mirar primero, nunca cuán malo es.
-
Confianza
Con cuánta firmeza se sostiene cada observación, y por qué, explicable, nunca opaca.
-
Incógnitas
Lo que no pudo determinarse, registrado de forma explícita y llevado adelante.
-
Prioridades de revisión
Un ordenamiento de dónde se emplea mejor primero la atención humana.
-
Paquete de diagnóstico
Todo ensamblado en un único entregable listo para la decisión, con su propia declaración de límites.
Preguntas frecuentes de metodología
Cómo se sostiene el método, en términos llanos.
¿Cómo se calculan las puntuaciones?
Las puntuaciones se derivan de forma determinista de la evidencia observada, por ejemplo, con cuánta fuerza otro código depende de una región, o cuán escaso es el conocimiento disponible. Expresan únicamente urgencia de investigación, y cada una porta su propia confianza. La misma instantánea siempre arroja las mismas puntuaciones, y cada puntuación puede rastrearse hasta la evidencia que la respalda.
¿Qué pasa si la confianza es baja?
La confianza baja se informa, nunca se oculta. Una observación de baja confianza es incierta, no incorrecta, es una llamada a mirar más de cerca, junto a una declaración honesta de por qué no la sostenemos con más firmeza. Un hallazgo nunca se afirma más allá de lo que la evidencia respalda.
¿Cómo deben interpretarse las incógnitas?
Como preguntas, no como vacíos. Una incógnita es no evaluada, ni bajo riesgo ni segura. Una región densa en incógnitas es precisamente donde la investigación humana es más valiosa. Las incógnitas se resuelven solo por evidencia o por un humano, nunca inferidas para cerrarlas.
¿Pueden automatizarse las salidas?
Las salidas de RepoTruth están construidas para la revisión humana y son no accionables por construcción. No están diseñadas para condicionar una canalización, disparar una acción ni sustituir a una decisión. El paquete informa a las personas; las personas deciden.
¿Puede RepoTruth aprobar decisiones arquitectónicas?
No. RepoTruth produce evidencia y posibles puntos de atención para el juicio de un arquitecto. No aprueba nada y no decide nada. Las decisiones arquitectónicas las toman las personas con autoridad para tomarlas.
¿Por qué RepoTruth evita las recomendaciones?
Porque la interpretación no es recomendación. Una recomendación incorpora una decisión que RepoTruth no tiene legitimidad para tomar, carece de su contexto, sus restricciones y su autoridad. Al producir en su lugar evidencia, prioridades e incógnitas, RepoTruth mantiene el juicio, y la responsabilidad, en sus personas.
Comprenda cómo RepoTruth alcanza sus conclusiones, y sus límites.
Un diagnóstico de solo lectura, acotado a su decisión.
Cuéntenos la decisión a la que se enfrenta. Acotaremos un Paquete de diagnóstico a ella, producido por el método de esta página, de solo lectura y basado en instantánea, con cada hallazgo portando su evidencia, su confianza y sus incógnitas.
Evidencia, no veredictos. La revisión humana sigue siendo terminal.