Arquitectura del método
The Joins Framework
La validez de una cifra vive en sus enlaces, no en sus dígitos. Esta es la estructura que los registra —y AIMétodo, el sistema que la implementa.
Primero, la distinción
Framework, implementación, instancia
Tres cosas distintas que suelen confundirse. Separarlas permite que el método sobreviva al capítulo que lo originó.
| Capa | Qué es | Analogía |
|---|---|---|
| Framework | Las reglas, sin contenido. Define qué piezas existen, qué relaciones pueden tener y cuándo dos cifras pueden combinarse. No sabe nada de educación, ni de Puerto Rico, ni de presupuestos. Es una especificación reutilizable: cualquier investigación puede construirse sobre ella. | El código de construcción: qué debe cumplir cualquier edificio. |
| Implementación · AIMétodo | El sistema que aplica esas reglas. Los tipos en código, el modelo de datos, el registro de fuentes, las validaciones, la capa visible que permite recorrer una conclusión hacia atrás. Es una construcción concreta de la especificación —podrían existir otras. | El sistema constructivo de una firma: cómo esa firma cumple el código. |
| Instancia | La investigación real. El capítulo de educación: seis unidades, sus fuentes, sus cálculos, sus límites. El contenido que corre sobre la implementación. | Un edificio específico, ya levantado. |
Por qué importa la separación: si el método vive dentro del capítulo de educación, muere con él. Si vive por encima, la próxima investigación —vivienda, salud, transporte— no tiene que volver a discutir la arquitectura.
La confusión más común
Esto no sustituye la verificación de datos
Verificar datos comprueba afirmaciones contra sus fuentes: una vez, antes de publicar, sin dejar estructura detrás. Un buen verificador atrapa varios de estos fallos —restar una cifra presupuestada de una ejecutada es un error clásico que cualquier periodista de presupuesto busca—. La diferencia está en otro sitio.
Algunos empalmes inválidos son invisibles en la prosa. «El índice subió 2.3 puntos» es una oración verdadera sobre un valor correctamente calculado. No hay fuente externa contra la cual comprobarla, porque la fuente es el propio cálculo del proyecto. El error vive en si esas dos cifras eran la misma clase de cosa —y esa pregunta no aparece en el texto.
| Diferencia | Verificación de datos | Este marco |
|---|---|---|
| Posición | Trabaja sobre el texto terminado. | Trabaja sobre el modelo, antes de que exista prosa —el único lugar donde una base incompatible sigue siendo visible. |
| Persistencia | Es un evento. Atrapa un error, se corrige, y nada impide que reaparezca el próximo trimestre. | Es una estructura. Una vez que el campo basis existe, mezclar bases se vuelve una operación rechazada, no una omisión posible. La regla sobrevive a quien la conocía. |
| Visibilidad | Invisible por diseño: el lector solo ve el resultado. | El hallazgo se publica. No es una diferencia metodológica sino editorial —y es buena parte de por qué un lector lo encuentra convincente. |
Son complementarios. Este marco no reemplaza a un verificador; le da un lugar donde sus hallazgos se vuelven permanentes.
Diagrama 1
La pila
De lo abstracto a lo publicado. Cada capa depende de la anterior y no la contradice.
Capa 1 · Framework
The Joins Framework
Tipos de pieza · tipos de relación · reglas de combinación · taxonomía de fallos · restricciones de proceso. Neutral respecto al tema.
Capa 2 · Implementación
AIMétodo
Modelo de datos tipado, registro de fuentes de primera clase, estados separados (valor · base · revisión), validación de integridad referencial, renderizado de la trazabilidad.
Capa 3 · Instancia
Capítulo Educación
Seis unidades: medir el aprendizaje · medir la inversión · cruzarlas · historia del gasto · declarar lo que falta · preguntar si algo se movió.
Capa 4 · Superficies públicas
Expediente · Método · Correcciones
Tres lecturas del mismo trabajo, para tres lectores distintos.
El reglamento · Capa 2
¿Cuándo pueden combinarse dos valores?
Las diez reglas de combinación, condensadas. Cada una se extrajo de un espécimen real — por eso son exigibles y no piadosas. La fuente de verdad es docs/joins-framework.md; esta lista existe para que cada cifra del sitio pueda apuntar a la regla que la vigila (los «chips» del modo procedencia enlazan aquí).
- Misma base. Valores en marcos contables o de medición distintos no se restan, dividen ni promedian. Si una base es única para un insumo, el resultado es un estimado y lo dice.
- Misma población. Una estimación toma su cambio de la población que describe. Prestarse la tendencia de otra población es inválido por muy parecidas que parezcan.
- Mismo constructo. Una observación no llena una casilla que nunca midió — ni entre edades, ni grados, ni instrumentos, ni definiciones.
- Se transfiere el cambio, no el nivel. El puente aporta el delta; el ancla aporta la escala. El valor absoluto del puente nunca es el del ancla.
- Las proyecciones no alimentan nada. Un valor proyectado entre instrumentos puede ilustrar un vacío; no entra en un índice, una coordenada, una serie ni una comparación ordenada.
- Un compuesto exige una sola regla de composición. Si sus miembros se construyen distinto, no es una medida — son varias presentadas como una.
- Las medidas relativas no describen cambio por sí solas. Si la referencia también se mueve, la razón se mueve sin que el sujeto cambie. Se reportan ambos movimientos o ninguno.
- Los estimados no ordenan. Pueden ilustrar magnitud; no pueden establecer un ranking.
- Significancia antes que dirección. No se describe un cambio como subida o bajada hasta que la fuente establece que excede su propio error. «No cambió de forma medible» es un hallazgo, no un fallo.
- Las ausencias se tipifican. «No aplica», «no participó» y «sin dato reciente» son cosas distintas. La única opción inaceptable es la omisión silenciosa.
Práctica · triangulación (§4). Un estimado no está terminado cuando se etiqueta: se busca una segunda construcción independiente que llegue a la misma cantidad por otra ruta. Si existe, se registra como validatedBy; si no existe, se registra eso. El requisito no es dos fuentes — es que la búsqueda ocurrió y su resultado es legible.
Diagrama 2
El recorrido de una cifra, y dónde se detiene
La cadena que toda conclusión debe poder recorrer hacia atrás. A la derecha, las compuertas: los puntos donde el sistema rechaza una operación aunque todos los números sean correctos.
La cadena
Pregunta
La persona formula o selecciona; la IA ayuda a descomponerla en unidades verificables.
Fuente
Documento con localizador, fecha, periodo, población, primaria o secundaria.
Dato observado
El valor tal como aparece en su fuente. Con su base declarada.
Método / supuesto
El procedimiento, con su supuesto escrito en una oración defendible.
Cálculo
La operación visible, con sus insumos enlazados.
Resultado
Lo que produce la operación. Hereda la certeza del eslabón más débil.
Interpretación → Claim
Lo que se le ofrece al lector.
Límite / contraevidencia
Viaja con el claim. No puede debilitarse ni omitirse.
Revisión humana
Aprobación explícita antes de publicar. No es automática ni delegable.
Compuertas · dónde se detiene
Compuerta · localizador¿El documento citado contiene realmente esta cifra? Si no, la cita no sobrevive el rastreo.
Compuerta · base¿Ejecutado o presupuestado? ¿Nominal o PPP? Dos bases distintas no se restan ni se promedian.
Compuerta · supuestoSi la oración que sostiene la estimación no puede escribirse y defenderse, la estimación no procede.
Compuerta · composición¿Todos los miembros del compuesto se construyen con la misma regla? Si no, no es una medida: son varias presentadas como una.
Compuerta · referencia móvil¿El denominador también se movió? Entonces el cociente no describe el cambio por sí solo.
Compuerta · significancia¿La fuente establece que el cambio supera su propio margen de error? Sin eso, no se afirma dirección.
Compuerta · ordenUna estimación puede ilustrar magnitud. No puede ordenar ni rankear.
Salida · decisiónSi una operación resulta inválida, el agente se detiene y reporta. No elige el arreglo: reclasificar un dato es una decisión de investigación.
Ausencias tipadas. Cuando falta un dato, la cadena no se rellena en silencio: se declara NO APLICA (la medición no cubre a ese sujeto), NO PARTICIPÓ (era elegible y no lo hizo —eso también es un hallazgo) o SIN DATO RECIENTE (participó antes).
Diagrama 3
Dónde vive cada cosa
El repositorio es la fuente de verdad. La separación de carpetas refleja la separación de capas: material de investigación, modelo, presentación y documentación no se mezclan.
repo/ ├── docs/ — nunca se publica; el método y sus reglas │ ├── joins-framework.md CAPA 1 · el framework, neutral │ ├── metodo-referencias-cruzadas.md reglas §1–§10 + especímenes │ ├── pagina-el-metodo.md spec de la superficie pública │ └── future-education-editorial-agent.md restricciones del agente futuro │ ├── data/ — datasets, cada uno con su procedencia │ ├── README.md índice de datasets │ └── <dataset>/ │ ├── README.md fuente, base, periodo, transformaciones │ └── *.csv │ ├── sources/ — documentos primarios archivados │ ├── reports/ PDFs oficiales (NAEP, PISA, OGP…) │ └── clippings/ notas de prensa │ ├── src/data/ CAPA 2 · el modelo │ └── educationResearchPrototype.ts ResearchUnit · ResearchItem · Source[] │ ├── src/components/ CAPA 2 · el renderizado │ └── ResearchItem.astro una pieza, con su estado y su sustento │ ├── src/pages/ CAPA 4 · las superficies │ ├── pruebas/… el expediente (borradores) │ ├── metodo el método, para lectores │ └── correcciones el registro de errores │ └── scripts/ — procesamiento y validación └── integrity-check.mjs npm run integrity · refs · anchors · PROVISIONAL
Regla de entrada: todo dataset nuevo llega con su procedencia escrita —fuente, base, periodo, población, transformaciones aplicadas— o no entra. Una cifra sin origen documentado no puede sostener nada aguas abajo.
Diagrama 4
Tres superficies, tres lectores
El mismo trabajo, leído de tres maneras. Ninguna sustituye a las otras.
Para verificar
El expediente
- Todas las piezas, todas las relaciones
- Cada cifra con su estado y su fuente
- Exhaustivo, no editorial
- Lector: quien quiera comprobar
Para entender
El método
- Un ejemplo completo, de principio a fin
- El mismo procedimiento, mal aplicado
- Las reglas en lenguaje llano
- Lector: quien decide si confiar
Para confiar
Las correcciones
- Qué se afirmaba · qué estaba mal
- Cómo se detectó · qué cambió
- También las verificaciones que confirmaron
- Lector: cualquiera
Las tres existen: el expediente en /pruebas, el método en /metodo y las correcciones en /correcciones.
La cadena limpia parece una afirmación. El error atrapado parece un sistema. Por eso el registro de correcciones es la superficie más persuasiva de las tres —y la que casi nadie publica.
Adopción
El orden que funciona
No se construye todo antes de empezar. Los pasos 1 y 2 entregan la mayor parte del valor; lo demás es enforcement, salvo el paso 7, que requiere una migración de datos y espera.
| # | Paso | Qué atrapa |
|---|---|---|
| 1 | Fuentes como objetos de primera clase — sacar las citas de la prosa a registros tipados: localizador, fecha, periodo, población, primaria. | Citas que no sobreviven el rastreo |
| 2 | basis como campo de primera clase — varias dimensiones ortogonales, nivel de ítem, mixed de primera clase. | Conflictos de base entre ítems; la base mixta dentro de un ítem solo cuando un humano la marca mixed |
| 3 | Relaciones tipadas: derivedFrom, assumes, citesSource. | Supuestos no enunciados |
| 4 | Estado de revisión y certeza, separados del estado del valor. | Fuente primaria confundida con valor verificado |
| 5 | Correcciones estructuradas con supersedes e impacto aguas abajo. | Errores que reaparecen |
| 6 | Validación automática — las reglas se vuelven código. | Todo lo anterior, sin depender de la memoria |
| 7 | inputs estructurados en ítems de cálculo — valor + base por operando. Diferido: migración grande con riesgo de transcripción. | La base mixta dentro de un cálculo, en el punto de la operación |