Control de commits con 22 analizadores
Desarrollé un control obligatorio de commits con 22 analizadores de
una línea y cinco que requieren una explicación, sin nivel de
advertencias ni supresiones en línea permitidas, que cubre HTML,
CSS, JavaScript, Python, YAML, Markdown, Shell, enlaces, ortografía,
secretos y tipografía.
agosto 2026

Situación. Una guía de contribución es un conjunto de sugerencias.
Todo el mundo está de acuerdo con ella, y entonces llega el viernes,
el cambio es pequeño y la guía pierde. En un proyecto de una sola
persona eso es peor en lugar de mejor, porque no hay nadie que
revise — lo único que media entre un cambio malo y producción es la
persona que lo escribió, en el momento en que menos ganas tiene de
discutir consigo misma.

Tarea. Las normas debían ser ejecutables, de modo que incumplir una
hiciera fallar un commit en lugar de esperar a que alguien lo
advirtiera.

Acción. Lo que creció fue un control de calidad obligatorio de 22
analizadores sin nivel de advertencia: cada diagnóstico es un error,
y el propio generador del sitio se ejecuta con las advertencias
elevadas a fallos para que incluso un aviso de obsolescencia detenga
la compilación. Están los evidentes — validación de HTML, CSS,
JavaScript, Python, YAML, Markdown, shell, ortografía, secretos,
enlaces rotos. Los interesantes son las comprobaciones específicas
del proyecto sobre las que ninguna herramienta estándar tiene
opinión: que ambos temas de color pinten cada superficie compuesta
con el mismo número de capas, que ninguna fotografía se muestre con
una anchura superior a la mitad de sus píxeles de origen, que el
árbol desplegado no contenga ninguna ruta ni nombre de host
privados, que la prosa respete las reglas de tono en los tres
idiomas, que una página tenga una versión gemela en Markdown y una
representación válida en un protocolo alternativo. Las supresiones
en línea están totalmente prohibidas — ningún comentario para
ignorar, ninguna directiva para desactivar, ninguna omisión del hook
y ningún cambio de nombre de archivo para eludir un patrón de
coincidencia. La regla que mantiene eso honesto es que un fallo
preexistente no es una excusa: una comprobación que detecta un
defecto que nadie ha introducido se corrige en la misma pasada.

Resultado. Una máquina formula las objeciones mecánicas antes de que
exista un commit, y el control de calidad obligatorio es el único
revisor que tiene este proyecto. El coste se declara en lugar de
ocultarse: hacer commits es lento, y lidiar con una protección mal
escrita es realmente exasperante, motivo por el que más adelante las
propias protecciones pasaron a estar sujetas a un formateador y un
analizador propios.

Categorías:
1Ingeniería de frontend	/es/categories/frontend/	advisory.engineer.company	70
1DevOps	/es/categories/devops/	advisory.engineer.company	70
1Automatización y CI/CD	/es/categories/automation/	advisory.engineer.company	70
1Pruebas y control de calidad	/es/categories/testing/	advisory.engineer.company	70
1Python	/es/categories/python/	advisory.engineer.company	70
1Documentación	/es/categories/documentation/	advisory.engineer.company	70

Servicios:
1DevOps y automatización CI/CD	/es/services/devops-cicd/	advisory.engineer.company	70
1Desarrollo de agentes de IA a medida	/es/services/ai-agents/	advisory.engineer.company	70
1Estrategia de producto y requisitos	/es/services/product-strategy/	advisory.engineer.company	70
1Documentación técnica	/es/services/technical-documentation/	advisory.engineer.company	70

hEsta página en la web	URL:https://advisory.engineer.company/es/portfolio/built-a-22-linter-commit-gate/	advisory.engineer.company	70
