Paul Jialiang Wu agentic-portfolio English 中文 한국어 日本語✉️ Lista gratuita
← Volver al portafolio

Serie AI-Native · ANDON · Revisión agéntica de PR y CI/CD · Episodio 3 de 5

Reglas de revisión de PR como datos: la regla que no puede desviarse

Revisión agéntica de PR y CI/CD, episodio 3. En 1956, Western Electric publicó las reglas para leer una carta de control, de modo que un operario de línea y un ingeniero leyeran la misma carta de la misma manera. La mayoría de los repositorios guarda sus reglas de revisión en prosa, donde cada revisor las lee de forma distinta y un revisor de IA las parafrasea. Este episodio es la D de ANDON. Traslada las reglas de revisión de PR de un repositorio a tres archivos de datos, renderiza la página para humanos a partir de ellos, y añade una verificación, ejecutada en CI en cada PR, que falla en el momento en que la página y los datos discrepan. El 9 de septiembre de 2026, tres días después de que la verificación se lanzara, la hice ponerse en rojo a propósito.

Por Paul Jialiang Wu · futuremake.io · 2026-09-09 · Episodio 3 de 5

Cover: white ground with a black left rail. Eyebrow ANDON · AGENTIC PR REVIEW & CI/CD · EPISODE 3 OF 5 · DATA, NOT PROSE above the two-line serif title PR Review Rules as Data: the Rule That Cannot Drift, two grey lines: Western Electric wrote the rules down in 1956 so everyone read the chart the same way. A review rule that lives in prose stops being true; one that lives in a file can be checked. Three grey cards: WHAT IT IS, the D in ANDON, built, three files, one renderer, one check; WHO IT IS FOR, anyone with a contributing guide, engineers, founders, the curious student; WHAT YOU LEAVE WITH, a rules-as-data contract, source, render, check, plus the 5 Whys. A black band: THE ONE FINDING · ONE REPOSITORY · 2026-09-09 — 29 rules in one file, docs table rendered from it, one hand-edited id turned the check red. Prose can be wrong for a year and nobody knows. A file can be wrong for one commit.
El único hallazgo, con su alcance: un repositorio, un día, una edición manual.

Resumen de 1 minuto — con qué te vas a quedar

Qué es esto. Episodio 3 de ANDON, una serie de cinco partes sobre revisión agéntica de PR y CI/CD. Este episodio trata sobre la regla datos, no prosa, incorporada en un repositorio real como PR review rules as data: las reglas de fusión, los umbrales de tamaño y la política de respuesta viven cada una en un archivo JSON; el revisor, las compuertas y la página de documentación de cara al equipo humano leen todos de esos archivos; y un check de CI vuelve a renderizar la tabla de la documentación a partir de los datos y falla si la página se ha desviado.

Por qué importa. Para un ingeniero: una regla en prosa la hace cumplir quien la recuerde, que en un repositorio de la era de los agentes cada vez es nadie, y el modelo la va a parafrasear hacia algo parecido pero distinto. Para un fundador: el censo de políticas de 2026 encontró que la mayoría de los repositorios top ya permiten contribuciones de IA y que casi la mitad exige divulgarlo; en mi lectura de esas políticas, están escritas en prosa, y una política que solo un humano puede interpretar no escala frente a una inundación. Para un estudiante: es la misma jugada que hizo Western Electric en 1956 y Shewhart en 1931, aplicada a una guía de contribución.

Qué puedes hacer después de leer esto. Pon cada regla de revisión, cada umbral y cada excepción en un archivo de datos con un id, un nivel, la compuerta que la hace cumplir y una razón por escrito. Genera la página humana a partir del archivo y nunca la tipees a mano. Agrega un check que vuelva a renderizar y comparar, y luego rómpelo a mano una vez, para haberlo visto en rojo con tus propios ojos.

ANDON — la espina de la serie
  1. A · Assess — La inundación de PRs se mide, no se siente episodio 1
  2. N · Nunca silenciosa — Jidoka para repositorios episodio 2
  3. D · Data, not prose — La regla que no puede desviarse este episodio
  4. O · Solo en el perímetro — El radio de impacto es una lista de rutas episodio 4
  5. N · Prueba negativa — Una compuerta solo se instala después de haber marcado error a propósito episodio 5

Qué cubre este episodio, y por qué las reglas de revisión de PR como datos llegan en tercer lugar

El episodio 1 midió la inundación y puso primero la compuerta de máquina. El episodio 2 le dio a cada compuerta un tercer estado, para que "no se pudo ejecutar" quede publicado en vez de silenciado. Los dos episodios asumieron algo que este tiene que ganarse: que las reglas que las compuertas hacen cumplir son las mismas reglas que los humanos creen estar haciendo cumplir. En la mayoría de los repositorios ese supuesto es falso, de forma silenciosa. Las reglas viven en una guía de contribución, en una plantilla de pull request, en una página de wiki y en los hábitos de un puñado de revisores; la configuración de CI hace cumplir algún subconjunto de ellas con números que no aparecen en ningún lugar de la guía; y el revisor de IA, si existe uno, recibe un prompt que parafrasea la guía de memoria. Tres lectores, tres reglamentos.

La era de los agentes hace esto costoso, no simplemente desprolijo. El censo de 2026 sobre 281 políticas de contribución de IA en los dos mil repositorios más importantes de GitHub encontró que el 83,3 por ciento permite el uso de IA, el 48,8 por ciento exige divulgarlo, y el 14,9 por ciento lo prohíbe [1]. Mi propia observación, fuera del censo: las políticas que he leído son prosa que un humano tiene que interpretar PR por PR. Un estudio de 23.247 PRs redactados por agentes encontró que el 1,7 por ciento presentaba una alta inconsistencia entre lo que decía el PR y lo que hacía el código, y el primer episodio de la serie ya registró que los PRs mal descritos igual se fusionan un 28 por ciento de las veces [2]. Cuando la descripción puede estar equivocada y el revisor suele ser un bot, las reglas que deciden la fusión no pueden ser un párrafo.

Así que la regla de este episodio es: una regla es datos primero, y la prosa se renderiza a partir de ella. El ejemplo de trabajo es el mismo repositorio de los episodios 1 y 2, donde 29 reglas de revisión, cuatro umbrales de tamaño y una política de respuesta viven ahora en tres archivos, y donde, tres días después de que se lanzara la verificación de deriva, edité a mano el id de una regla para probar que la verificación podía ponerse en rojo. Y así fue, en una corrida local, con el código de salida registrado.

La versión más antigua de la regla: escribirla para que dos personas la lean igual

El registro de 300 años es un registro de trasladar el juicio de la cabeza de una persona a un objeto sobre el que dos personas pueden coincidir. La demostración de Honoré Blanc en Vincennes el 8 de julio de 1785, tal como la reconstruye Roser, fue que "he disassembled 50 locks, picked pieces for 25 locks at random, and … assembled them again" (Traducción: desarmó 50 cerraduras, tomó piezas de 25 cerraduras al azar y … las volvió a armar) [3]: la intercambiabilidad demostrada mediante un experimento que cualquiera podía repetir, no mediante una afirmación. Las instrucciones de artillería que Bomford dictó en 1821 exigían "two plugs for the bore diameter, with one to pass through the barrel and the other not to enter" (Traducción: dos calibres para el diámetro del ánima, uno que debía pasar por el cañón y el otro que no debía entrar) [4]: una regla que es un par de objetos físicos, y una aprobación sin margen para la opinión. Los estándares de Joseph Whitworth llegaron antes que los límites; la nota del Science Museum sobre su calibre de alambre registra que "The concept of tolerance or specification by limits of acceptability had not at that time been established." (Traducción: el concepto de tolerancia o especificación por límites de aceptabilidad aún no se había establecido en esa época.) [5] Un estándar dice cuál es el valor correcto. Un límite dice qué hacer cuando el valor está mal. Las compuertas necesitan límites.

Shewhart aportó la definición sobre la que corrió el resto del siglo. En 1931 escribió que "A phenomenon will be said to be controlled when through the use of past experience, we can predict, at least within limits, how the phenomenon may be expected to vary" (Traducción: se dirá que un fenómeno está controlado cuando, mediante el uso de la experiencia pasada, podamos predecir, al menos dentro de ciertos límites, cómo se espera que varíe.) [6]. El control es predicción dentro de límites escritos. Y luego el manual de 1956 de Western Electric puso por escrito las reglas de decisión para leer su gráfico. La razón declarada sobrevive en el registro secundario como una sola frase: "Their purpose was to ensure that line workers and engineers interpret control charts in a uniform way." (Traducción: su propósito era asegurar que los operarios de línea y los ingenieros interpretaran los gráficos de control de manera uniforme.) [7] Esa frase es este episodio. El gráfico ya existía; lo que 1956 añadió fue el reglamento, para que la persona junto a la máquina y la persona en la oficina dejaran de discrepar sobre lo que decía el gráfico.

El mismo movimiento se repite una y otra vez. El manual de Juran se publicó por primera vez en 1951 [8]; la norma ISO 9001 se publicó en 1987 como descendiente de una especificación militar [9]; y en 2009 la lista de verificación de seguridad quirúrgica, una regla escrita como puntos en una tarjeta, se midió en 7688 pacientes de ocho hospitales: las muertes cayeron de 1,5 a 0,8 por ciento y las complicaciones de 11 a 7 por ciento [10]. Ninguna de ellas es software. Todas son la misma afirmación: una regla que vive en un artefacto supera a la misma regla viviendo en la pericia de alguien, porque el artefacto se lee igual todas las veces.

La imagen de la cocina del episodio 1 sigue siendo válida. Un solo cocinero guarda la receta en su cabeza. Un restaurante la escribe en una tarjeta. Una cadena la escribe como una especificación, en gramos y grados, porque mil cocinas deben leerla igual y ninguna puede improvisar. La tarjeta no es una forma inferior de la receta. Es la única forma que se puede verificar.

CocinaRepositorio
La tarjeta de especificación: gramos, grados, la única sustitución permitida, firmada y aprobadaLos tres archivos de datos: las reglas con id, nivel, compuerta y verificación; los umbrales; la política de respuesta con sus excepciones y sus razones
El menú impreso, generado a partir de la ficha, jamás tipeado a manoLa tabla de reglas de la página de documentación, generada a partir del JSON entre dos marcadores
El conteo nocturno que confirma que el menú sigue coincidiendo con la fichaLa verificación de deriva en CI: volver a renderizar, comparar, salir con código 1 ante cualquier diferencia
Alguien cambia el menú con un marcadorLa edición manual de un id de regla que hizo que la verificación de deriva se pusiera en rojo el 2026-09-09 (una ejecución local; el mismo comando que corre CI)
Table titled THE SERIES SPINE · FOUR HORIZONS · WHAT EACH ONE SETTLED ABOUT GATES with columns HORIZON, LANDMARKS (VERIFIED), THE PRINCIPLE A 2026 GATE INHERITS. Rows: 300 years (1785 to 2009): Blanc's 50 locks, the 1821 Ordnance bore plugs one to pass the other not to enter, the 1896 Toyoda loom that stops itself, the 1924 Shewhart control-chart memo, the 1950 andon cord, 1956 Western Electric rules, the 2009 WHO checklist; principle: go or no-go, never looks fine, the machine halts itself, anyone may pull the cord, rules written so two people read the chart the same way. 30 years (1999 to 2023): Beck and Fowler daily integration, Bacchelli and Bird 2013, bors, McIntosh 2014, Micco 2017 84 percent flakes, Google 2018 24 lines under 4 hours, SLSA and sigstore 2021, merge queue 2023; principle: small, fast, always-green main, test the merge result, separate flake from fault, a green build is not provenance. 30 months (2024-03 to 2026-08): Devin, Copilot agent, Octoverse 518.7M PRs, GitHub 25M to 90M per month, Stripe 1,000 agent PRs per week, enterprise 2.09x with human review 89 to 68 percent, agent PRs merge 68 to 80 percent, mis-described PRs merge at 28 percent, kernel humans sign; principle: the bottleneck moved to judging, provenance is a trailer nobody checks, no one formalised a review SLA, the merge queue is next. 30 days (2026-08-09 to 09-09), boxed in black: 09-01 Copilot can approve, 09-02 Agent Merge, 08-12 CodeRabbit 143M, 09-07 policy census 83.3 permit 48.8 disclose 14.9 forbid; principle: the AI reaches the merge button, whether it may press it is a repository setting, so the setting is the design. Footer: every landmark is in the series dossier with a verification status.
El eje de la serie, sin cambios desde el episodio 1. Este episodio vive en la primera fila, en 1956, y en la última, en el censo de políticas.

La versión de 30 años: Google escribió por escrito el estándar de su revisor, y es una sola oración

El linaje del software de la misma idea es más corto y tiene un ejemplo canónico. Las prácticas de ingeniería públicas de Google enuncian el estándar del revisor en una sola oración: "reviewers should favor approving a CL once it is in a state where it definitely improves the overall code health of the system" (Traducción: los revisores deberían inclinarse por aprobar un CL una vez que se encuentra en un estado que definitivamente mejora la salud general del código del sistema) [11]. Esa oración es prosa, y funciona en Google porque existe dentro de una cultura de revisión que exige revisión para casi todo cambio, y una cultura de herramientas construida en torno a cambios pequeños [12]. Es la ficha de recetas de un restaurante con una cocina muy buena. Copia esa oración en un repositorio con dos mantenedores y un revisor de IA, y vuelve a ser un gráfico de control sin reglas: los dos mantenedores leerán "definitivamente mejora" de manera distinta, y el modelo lo leerá de una tercera manera en cada corrida.

Lo que necesita el repositorio más pequeño no es una mejor oración. Necesita que esa oración se descomponga en cosas que se puedan verificar: qué condiciones son decidibles por máquina y bloquean, cuáles son juicios que la IA puede plantear con una cita, y cuáles solo un humano puede responder. Esa descomposición es una estructura de datos, y en cuanto es una estructura de datos, la página de documentación, el prompt del revisor y las compuertas pueden generarse todas a partir de ella en lugar de parafrasearla.

La construcción: tres archivos, un renderizador, una verificación

1. El archivo de reglas

Las reglas de fusión del repositorio viven en un solo archivo JSON, 29 reglas al día de escribir esto. Cada regla lleva seis campos: un id, un nivel, un título, el documento fuente del que proviene la regla, la compuerta que la impone y la verificación que hace esa compuerta. El nivel es uno de tres. Diez reglas son block: aislamiento de inquilinos y permisos de escritura, nada de secretos en el diff, un cambio de modelo sin migración, un documento bilingüe cambiado de un solo lado, el contrato de autoprueba del episodio 5. Estas se imponen mediante scripts y una en rojo no puede fusionarse. Trece reglas son ai: las preguntas que el revisor de IA puede plantear, cada una con una cita, incluidos los tres principios de ingeniería que el equipo agregó en un PR el 2026-09-06 —diseño orientado a objetos, ingeniería de bucles e ingeniería de grafos—. Seis reglas son human: las preguntas que ningún script ni ningún modelo puede responder —el escenario de negocio, el dueño de calidad, el nodo de aprobación, los criterios de cierre, las métricas, y si conviene fusionar ahora—, lo cual solo puede juzgar el cofundador del dominio.

El mismo archivo lleva el sobre de auto-fusión del artículo precursor: los prefijos y sufijos de ruta dentro de los cuales un PR totalmente verde, totalmente medido y sin hallazgos puede fusionarse sin un humano, y la lista de denegación que prevalece sobre cualquier permiso. El sobre es datos por la misma razón que lo son las reglas. Cuando alguien pregunta "¿puede la IA fusionar un cambio al directorio de flujos de trabajo?", la respuesta es una línea en un archivo, no el recuerdo de una conversación.

2. Los umbrales y la política

Los números de la compuerta de tamaño viven en un segundo archivo. Advertencia al llegar a 400 líneas efectivas, bloqueo en 3.000 líneas o 60 archivos, bloqueo de un PR redactado por un agente en 1.500 líneas, y el conteo de líneas efectivas se hace tras excluir lockfiles, activos minificados, snapshots, imágenes, fuentes y datos de casos generados. El propio campo de documentación del archivo cita la base: el hallazgo de 2006 según el cual la eficacia de la revisión se derrumba pasadas unas pocas centenas de líneas, y la norma de Google sobre cambios pequeños. Un umbral que cita su razón se puede discutir en un PR. Una constante en un script, no.

El reloj de respuesta del episodio 2 lee un tercer archivo: 48 horas para una primera respuesta, siete días para una decisión, la lista de mantenedores, los marcadores de comentario que no cuentan como respuesta, y los PR exentos. Cada excepción lleva una razón escrita: el PR heredado de antes de que existieran las compuertas, y el PR de prueba negativa deliberadamente abierto. El cargador rechaza toda excepción sin razón. Esa frase era falsa cuando el revisor de este artículo leyó el primer borrador: el requisito vivía en el propio campo de documentación del archivo, como prosa, y el cargador aceptaba una cadena vacía. Que la tesis del episodio fallara dentro de su propio ejemplo es justo el tipo de hallazgo para el que existe la regla de revisor distinto de autor, y la verificación se añadió y se fusionó ese mismo día, con una autoprueba que demuestra que rechaza.

3. El renderizador y la verificación

La página humana que explica las reglas de revisión al equipo de dominio se genera. Un comando renderiza el archivo de reglas como una tabla en Markdown; la tabla se pega entre dos marcadores de comentario HTML en la página de documentación; todo lo que queda fuera de los marcadores es prosa que escribió una persona, y todo lo que queda dentro son datos que escribió un script. Un segundo comando vuelve a renderizar la tabla y la compara con lo que hay entre los marcadores. Cualquier diferencia imprime una instrucción de una línea para regenerar y termina con código de salida 1. Ese comando corre en CI en cada PR y es el tercer criterio estructural de la auditoría de bucles del episodio 2.

El 2026-09-09 lo demostré de la única manera en que se puede demostrar una compuerta: abrí la página de documentación, encontré la fila de la regla de ingeniería de bucles dentro de los marcadores, cambié su id de R12 a R12x, y ejecuté la verificación. Imprimió el mensaje de desvío y terminó con código de salida 1. Restauré el archivo y lo ejecuté de nuevo. Terminó con código de salida 0. Ese par de códigos de salida es la evidencia de la afirmación del título; sin ella, "la regla no puede desviarse" sería, en sí misma, prosa.

Diagram titled DATA, NOT PROSE · THREE FILES ARE THE RULES · EVERYTHING ELSE IS RENDERED FROM THEM. Top row, SOURCE OF TRUTH · CHANGED ONLY BY PR, three black cards: ai_review_rules.json, 29 rules, G1 to G10 block, R1 to R13 AI, H1 to H6 human, each with id, level, title, source, gate, check, plus auto_merge envelope with allow and deny prefixes, deny wins; gate_thresholds.json, size warn 400, block 3,000 lines, 60 files, agent-authored block at 1,500, exclude lockfiles, snapshots, images, case data, provenance markers; sla_policy.json, first response 48 h hard, decision 7 d soft, maintainers, comments that do not count, exempt PRs each with a written reason, label names, dashboard title. Arrows down to the middle row, READ BY CODE · NEVER RETYPED, three grey cards: the reviewer plus the docs page, ai_review.py loads the rules into the prompt, render-rules prints the Markdown table pasted between rules begin and end markers; the size and provenance gates, check_pr_ready.py reads the thresholds, check_provenance.py reads the markers, no number lives in a script; the response clock, pr_sla.py classifies against the policy, a threshold change is a diff a human reads, the loader refuses an exemption with no reason. A dashed box: THE CHECK THAT MAKES PROSE HONEST · RUNS IN CI ON EVERY PR, ai_review.py check-doc re-renders the table from the JSON and compares it to the docs page, different means exit 1; proven on 2026-09-09, one rule id hand-edited inside the markers R12 to R12x gives red, restored gives green, the loop audit lists it as S3 and F3. Footer quote: Western Electric 1956, rules written down so that line workers and engineers interpret control charts in a uniform way.
Los tres archivos son las reglas; el revisor, las compuertas y la página de documentación se renderizan todos a partir de ellos; una verificación mantiene la página honesta.

Qué cambió cuando las reglas se volvieron datos

En el repositorio pasaron tres cosas que no habrían pasado con una guía en prosa. Primero, las reglas adquirieron un conteo. Veintinueve es un número que se puede observar: el criterio de acumulación de la auditoría de bucles lo lee del historial de git y reporta que pasó de 0 a 29 entre la línea base del 1 de septiembre y el día de redacción de este texto, junto con las pruebas y las lecciones. Una guía no tiene conteo, así que no tiene tendencia. Segundo, las reglas adquirieron una columna de origen. Cada una de las 29 nombra el documento del que proviene; la regla de ingeniería de bucles, por ejemplo, cita el archivo de lecciones y la propuesta de respuesta. Cuando el cofundador de dominio pregunta por qué el revisor marcó la falta de una autoprueba, la respuesta es una fila, no un recuerdo. Tercero, las reglas se convirtieron en algo que la IA lee al pie de la letra. El prompt del revisor se construye a partir del mismo archivo del que se renderiza la página de documentación, así que al modelo se le entrega la misma tabla de 29 filas en cada corrida, 13 de las cuales le corresponde responder, y los humanos pueden ver exactamente qué se le entregó. La regla del artículo precursor de que todo hallazgo debe llevar una cita ahora tiene una contraparte: toda pregunta que se le hace al modelo lleva un id.

Vale la pena decir qué no cambió. La prosa alrededor de la tabla, la parte que le explica las tres capas a un nuevo miembro del equipo con la analogía de la cocina, sigue siendo prosa, y puede seguir siéndolo. Los datos reemplazan la prosa donde la prosa fingía ser una regla. No reemplazan la explicación.

Cinco porqués: por qué una regla de revisión debe ser datos antes de ser una regla

#¿Por qué?PorqueEvidencia
1¿Por qué no dejar las reglas en la guía de contribución?Porque una guía la lee cada revisor de forma distinta, y el modelo la lee de forma distinta en cada corrida, así que el repositorio tiene tantos libros de reglas como lectores.El propósito declarado de Western Electric al poner las reglas por escrito [7]; el estándar de una sola frase de Google solo funciona dentro del entrenamiento y las herramientas de Google [11]
2¿Por qué la era de los agentes empeora esto?Porque el lector humano está cada vez más ausente y la descripción del PR puede estar equivocada: la mayoría de las políticas de IA permiten su uso y, según mi lectura, son prosa; y los PR mal descritos igual se fusionan.[1, 2]; las cifras de cobertura del episodio 1
3¿Por qué renderizar la documentación a partir de los datos en vez de escribir ambas cosas?Porque dos copias escritas a mano de una regla son dos reglas que divergirán, y esa divergencia no da ninguna señal; una copia renderizada tiene exactamente una sola fuente.La verificación de desvío solo existe porque la página está renderizada; una página escrita a mano no se puede comparar contra nada
4¿Por qué el chequeo debe ejecutarse en CI y no en un script de release?Porque se aplica la regla del episodio 2: un chequeo que corre en un lugar donde la decisión de fusión no mira, no cuenta como verificado. La deriva descubierta en el momento del lanzamiento ya se fusionó.El chequeo es un paso de CI y un criterio de la auditoría de bucles; la prueba de la edición manual produjo un código de salida 1 en la misma forma de ejecución que usa CI
5¿Por qué se exige una razón escrita en cada excepción y en cada umbral?Porque "controlled" (Traducción: controlado) de Shewhart significa predecible dentro de límites escritos; un límite sin una razón no puede revisarse, solo anularse, y anular es la forma en que la prosa vuelve a crecer dentro de los datos.[6]; el archivo de umbrales cita sus fuentes de 2006 y de Google; las dos excepciones de la política llevan cada una su razón

La raíz, en una sola frase: una regla que nadie puede diferenciar es una regla que nadie puede demostrar que sigue vigente, y en un repositorio donde el revisor puede ser un modelo, una regla que no puede demostrarse vigente no es una regla.

Constrúyelo en 30 minutos: el contrato de reglas como datos

Treinta minutos es el presupuesto del contrato para un lector que lo copia; no es un tiempo que yo haya medido.

ElementoEspecificación
Archivo de reglasUn solo archivo JSON. Cada regla: id, level ∈ {block, ai, human}, title, source (el documento o la decisión de la que proviene), gate (el script o el paso que la aplica, o "human"), check (lo que realmente se comprueba). Ninguna regla sin una compuerta; una regla con compuerta "none" es un deseo, y los deseos van en la prosa.
Archivo de umbralesCada número contra el que compara una compuerta, con un campo _doc que nombra su fundamento. Listas de exclusión para archivos generados. Ningún literal numérico dentro de un script de compuerta.
Archivo de políticaTiempos de respuesta, la lista de mantenedores, los marcadores de comentario que no cuentan, excepciones como un mapa de id a razón escrita. El cargador rechaza una razón vacía; una autoprueba lo demuestra.
RenderizadorUn comando que imprime la tabla legible por humanos a partir del archivo de reglas. La página de documentación contiene dos marcadores; la tabla vive entre ellos; nada más ocupa ese espacio.
Verificación de derivaUn comando que vuelve a renderizar y compara el texto entre los marcadores. Si hay diferencias ⇒ imprime la instrucción para regenerar y sale con código de salida 1. Se ejecuta en CI en cada PR.
ConsumidoresEl revisor de IA construye su prompt a partir del archivo de reglas. Las compuertas cargan los umbrales. El bot de respuesta carga la política. Ninguno de ellos contiene una copia propia.
PruebaAntes de que la verificación entre en operación real, edita a mano un id entre los marcadores, ejecútala, registra el código de salida 1, restaura el archivo y registra el código de salida 0. Guarda ambos códigos de salida en el changelog.
Deliberadamente ausenteNada de motor de reglas, nada de lenguaje de esquemas, nada de anclas YAML, ninguna plantilla más allá de una tabla. Cada uno de esos elementos sería un segundo lugar donde una regla podría vivir.
# The whole contract fits in the shape of the file and one comparison (ids real; text abridged).
{
  "rules": [
    {"id": "G1",  "level": "block", "title": "tenant isolation + write permission",
     "source": "AGENTS S1/S2", "gate": "check_tenant_perm.py", "check": "every query filtered by company; every write behind a role"},
    {"id": "R12", "level": "ai",    "title": "loop engineering",
     "source": "docs/05 §8.24 · proposal §3.4", "gate": "ai_review.py", "check": "does the change close a loop or open one?"},
    {"id": "H1",  "level": "human", "title": "business scenario",
     "source": "docs/01", "gate": "human", "check": "domain co-founder only"}
  ],
  "auto_merge": {"allow_prefixes": ["docs/", "plan/"], "deny_prefixes": [".github/", "scripts/"]}
}

# ai_review.py --check-doc
rendered = render_rules(load("scripts/ai_review_rules.json"))
current  = between(DOC.read_text(), "<!-- rules:begin -->", "<!-- rules:end -->")
sys.exit(0 if rendered.strip() == current.strip() else 1)   # different ⇒ red

La misma historia, cinco salidas

LectorLa única decisiónLa única acción
EstudianteUna regla que no puedes verificar es solo un consejo.Toma una regla de cualquier guía que sigas y escríbela como id, nivel, compuerta y verificación.
IngenieroLos datos primero; la prosa se renderiza después.Traslada tus reglas de revisión a un solo archivo, genera la tabla de documentación a partir de él y añade a CI la verificación que compara y sale con error.
FundadorTu política de IA es prosa, y la prosa no escala frente a una avalancha.Pregunta cuáles de tus reglas de contribución podría verificar hoy mismo un script, y ponlas en un archivo esta semana.
Ejecutivo1956 fue el año en que las reglas salieron de la cabeza de los ingenieros.Pide ver el archivo donde viven tus reglas de revisión. Si la respuesta es un documento, tienes el gráfico y no las reglas.
InversionistaUn equipo cuyas reglas tienen un conteo tiene una tendencia que puedes leer.Pregunta cuántas reglas de revisión tiene un equipo y cuándo cambió el número por última vez.

Patrones, antipatrones y el primer principio

Patrones que se mantuvieron. Un archivo por tipo de regla. Seis campos por regla, con la compuerta y la fuente como obligatorios. Umbrales con una base documentada. Exenciones que no pueden escribirse sin una razón. Una página renderizada entre marcadores. Una verificación que compara y termina con error. Una prueba de edición manual antes de confiar en la verificación.

Antipatrones que esto reemplazó. Una guía de contribución que enumeraba reglas que ningún script aplicaba. Límites de tamaño que existían solo como constantes dentro de un script de compuerta. Un prompt de revisor que parafraseaba la guía. Una tabla de documentación que se habría escrito a mano, sin nada contra qué compararla.

El mecanismo, nombrado. Existe exactamente una copia de cada regla, y cualquier otra aparición de ella es una función de esa copia; la verificación de deriva es la función aplicada dos veces y comparada, así que una diferencia solo puede significar que alguien evadió la función.

El primer principio, en una sola frase. Una regla es aquello que puedes diferenciar (diff); todo lo demás es comentario sobre ella.

Misión de realidad

El episodio 2 prometió que, para el episodio 3, la auditoría de bucles se habría vuelto a ejecutar sobre una rama main en verde, con su reporte ya en un commit. Hecho: la auditoría se fusionó con su primer reporte, sus propios dos valores por defecto silenciosos se corrigieron el mismo día, la ejecución de la rama main quedó en verde, y el reporte actualizado llegó en un PR de solo documentación que el sobre clasificó correctamente y que un humano fusionó. Veintiún criterios pasan, ninguno falla, dos siguen sin medirse: la IA aún no ha medido un PR, y Tier-1 aún no ha fusionado ninguno. Los tres PR de los cofundadores todavía llevan la etiqueta de primera respuesta, y así lo sigue mostrando el tablero.

Marcador de la temporadaEpisodio 1 (2026-09-09, 14:00 UTC)Ahora (2026-09-09, 17:00 UTC)
El PR abierto más antiguo sin primera respuesta57 horas (tres PR)siguen siendo esos tres; etiquetados, en el tablero
Compuertas con una autoprueba que demuestra que pueden ponerse en rojo0 de 69 de 9, las nueve que enumera el criterio S5 de la auditoría, aplicadas por un runner en CI
Commits asistidos por agentes desde el 1 de septiembre que llevan un trailer de trazabilidadno medido11 de 21; la compuerta de procedencia ahora lo exige en los commits nuevos
Criterios de la auditoría sin medirtodavía no es una auditoría2 de 23, ambos a la espera de cosas ajenas al código

Para el episodio 4, el sobre de auto-fusión en el archivo de reglas se habrá probado contra un PR real de solo-documentación, con el estado de branch-protection reportado con honestidad: en el plan gratuito el sobre clasifica pero todavía no puede fusionar, y el artículo dirá cuál.

Sigue leyendo

Episodio 3 de ANDON · Agentic PR Review and CI/CD. Cada número está acotado donde aparece; la cocina es un modelo, no una medición. Los tres archivos de datos, el renderizador, la verificación y la prueba de edición manual existen en un repositorio privado; sus formas se reproducen en el contrato para que nada dependa de tener acceso a él. El dosier de cuatro horizontes que cita este episodio queda registrado en el directorio de planes del portafolio.

Referencias

  1. Hora, Robbes, Zacchiroli, "We Permit the Use of AI, but […]" (Traducción: "Permitimos el uso de IA, pero […]"), arXiv:2609.07542, 2026-09-07. arxiv.org
  2. Gong et al., Message-Code Inconsistency in Agent-Authored PRs, arXiv:2601.04886, 2026-01-08. arxiv.org
  3. Roser, 230 Years of Interchangeable Parts, AllAboutLean, 2015-07-08. allaboutlean.com
  4. Raber, Malone, Gordon, Cooper, Conservative Innovators and Military Small Arms: Springfield Armory 1794–1968, NPS 1989/2006, p. 138. npshistory.com
  5. Science Museum Group, Whitworth standard wire gauge, objeto co59414. collection.sciencemuseumgroup.org.uk
  6. Shewhart, Economic Control of Quality of Manufactured Product, Van Nostrand, 1931 (copia escaneada en archive.org). archive.org
  7. Reglas de Western Electric, Wikipedia (citando el Statistical Quality Control Handbook, 1956). de Western Electric) en.wikipedia.org
  8. (fuente secundaria; el manual no se consultó directamente)Juran Institute, . juran.com
  9. Quality Digest, 25 Years of ISO 9001, 2012-04-12. qualitydigest.com
  10. Harvard Gazette sobre Haynes et al., NEJM 360:491-9, 2009-01. news.harvard.edu
  11. Google Engineering Practices, The Standard of Code Review. google.github.io
  12. Software Engineering at Google, capítulo 9, Code Review, 2020. abseil.io