- Un ADR es un documento que registra decisiones de diseño. El autor escribe que los ADR encargados a la IA fueron desarrollando con el tiempo estructuras de secciones desalineadas, y que el texto de las decisiones empezó a incluir detalles de código, como listas de menús de pantalla y constantes.
- El autor propone comprobar con un archivo de políticas las reglas estructurales que una máquina puede verificar, como el orden de las secciones, los valores de Status, las referencias entre ADR y la existencia de los archivos enlazados, de modo que una infracción haga fallar el CI. Las reglas semánticas, como si un documento parece una especificación, las juzga un LLM y solo quedan como advertencias en el PR.
- regomark es una herramienta de línea de comandos creada por el autor. Analiza Markdown y comprueba las reglas con OPA (una herramienta de evaluación de políticas). El autor indica que no existe una implementación específica para ADR y que las reglas se guardan en el archivo de políticas del repositorio que la utiliza.
- Al releer 7 repositorios propios, el autor informa de que todo lo que no coincidía con el código eran detalles que no necesitaban estar en el ADR, y que las decisiones y garantías que deben mantenerse no estaban desactualizadas. Esta es la observación de una sola persona, el autor.
O: Esto podría servir para un escenario en el que un desarrollador que quiere encargar la revisión de ADR a una IA y detectar automáticamente los desajustes de formato en cada PR coloca una política .regomark/policy en un solo repositorio y ejecuta regomark check en CI.
X: El autor indica directamente que la comprobación semántica la juzga un LLM, por lo que el mismo ADR puede obtener respuestas distintas en cada ejecución. Antes de decidir cuánto confiar en las advertencias, hace falta verificarlo.