Motor de 268 controles para el repositorio
Desarrollé el motor de comprobaciones del repositorio — 268
controles de commit registrados, 277 reglas de análisis estático y
15 reglas ESLint propias —, además de 146 pruebas de los propios
controles, para que la compilación haga cumplir el criterio de
calidad.
2025

Situación. Las normas escritas en una guía de contribución son
sugerencias. Todo el mundo está de acuerdo con ellas, hasta que
llega el viernes, el cambio es pequeño y la guía acaba perdiendo. El
criterio de cero advertencias solo iba a mantenerse si lo sostenía
algo más que la buena voluntad. Además, los analizadores que
acompañan a cada lenguaje se quedan muy lejos de las reglas propias
del proyecto que realmente importan: las que definen cómo debe
funcionar este código en concreto.

Tarea. Las reglas importantes para el proyecto debían poder
ejecutarse, de modo que incumplir una hiciera fallar el commit en
lugar de esperar a que una persona revisora tuviera tiempo y se
acordara de detectarlo.

Acción. De ahí surgió un motor de controles. Hay 274 scripts de
comprobación, 268 registrados en los hooks de commit, junto con 277
analizadores JavaScript, 96 validadores Shell y 17 Python. Cubren lo
que las herramientas generales no examinan: que una migración pueda
revertirse, que una clave de traducción exista en ambos idiomas, que
una ruta registrada aparezca en la descripción OpenAPI o que nadie
añada discretamente una supresión en línea. Quince reglas ESLint
propias mantienen los patrones del proyecto en TypeScript. Una regla
merece mencionarse por separado: cualquier commit con prefijo fix:
debe incluir una prueba que falle sin la corrección, lo que
proporciona una comprobación ejecutable de esa regresión. Y como un
control averiado es peor que ninguno — lo aprueba todo sin que nadie
lo descubra —, los controles tienen 146 pruebas propias.

Resultado. Las personas revisoras podían dedicar más tiempo al
diseño porque las comprobaciones automáticas se ocupaban de las
reglas mecánicas que codificaban antes de enviar la rama al remoto.
La contrapartida es real y debe decirse: confirmar cambios es lento
y trabajar alrededor de un control mal escrito puede resultar
realmente exasperante. Esas 146 pruebas existen porque eso ocurrió.

Categorías:
1DevOps	/es/categories/devops/	software.engineer.company	70
1Automatización y CI/CD	/es/categories/automation/	software.engineer.company	70
1Pruebas y control de calidad	/es/categories/testing/	software.engineer.company	70
1Dirección técnica	/es/categories/technical-leadership/	software.engineer.company	70
1Documentación	/es/categories/documentation/	software.engineer.company	70

Servicios:
1DevOps y automatización CI/CD	/es/services/devops-cicd/	software.engineer.company	70
1Desarrollo de agentes de IA a medida	/es/services/ai-agents/	software.engineer.company	70
1Dirección técnica y consultoría	/es/services/technical-leadership/	software.engineer.company	70
1Documentación técnica	/es/services/technical-documentation/	software.engineer.company	70

hEsta página en la web	URL:https://software.engineer.company/es/portfolio/built-a-268-check-guard-engine-for-the-repo/	software.engineer.company	70
