Calidad de Ingeniería

La Calidad de Ingeniería mide si están implantadas las prácticas básicas de ingeniería y documentación: integración continua, pruebas automatizadas, disciplina de lint y formato, y una documentación de la que un recién llegado pueda realmente aprender. Son las prácticas que hacen que el cambio sea seguro — para los contribuyentes humanos y, cada vez más, para los agentes de codificación con IA.

La categoría aporta el 20% del índice de salud general.

Métricas de esta categoría

Las prácticas de ingeniería son una lista de verificación ponderada de evidencia de higiene: flujos de trabajo de CI, una suite de pruebas, configuración de linter, hooks de pre-commit y un .editorconfig. La documentación mide si el proyecto se explica a sí mismo: README, un directorio o sitio de documentación, descripción del repositorio, topics y wiki.

Qué mide deliberadamente esta categoría

Las señales se basan en la presencia: confirman que la infraestructura existe, no cuán buena es. Esa contención es intencionada — calificar la calidad de las pruebas o la prosa de la documentación desde fuera sería conjetura presentada como medición. Las señales de presencia son baratas de verificar, difíciles de discutir y ya separan notablemente bien los proyectos disciplinados de los que no lo son. Las señales más profundas (cobertura, tasas de éxito de la CI) figuran en la hoja de ruta de la metodología y llegarán con un cambio de versión.

Cómo leer el valor de la categoría

• Un valor bajo aquí rara vez engaña: la ausencia de CI y la ausencia de pruebas son hechos visibles, no juicios de valor.
• Un valor alto significa que el andamiaje de la calidad está presente. No certifica que el código que contiene sea bueno — véase señales, no garantías.
• La documentación pesa un 40%: un proyecto bien probado que no explica nada a los recién llegados es mensurablemente menos adoptable, y la categoría lo refleja.

Cómo mejorar la Calidad de Ingeniería

• Añadir una CI que ejecute la suite de pruebas en cada push y pull request — los dos componentes de mayor peso de las prácticas de ingeniería.
• Confirmar en el repositorio la configuración de linter y formateador; añadir hooks de pre-commit y un .editorconfig para la puntuación completa.
• Mantener un README real, un directorio docs/ o sitio de documentación, una descripción del repositorio y topics — cada uno es un componente con peso propio de la documentación.

Relacionado: Preparación para IA · el índice de salud