QUALITY.md es un formato de archivo abierto diseñado para declarar de forma explícita el modelo de calidad de un proyecto de software. El archivo agrupa en un mismo documento las características de calidad deseadas (seguridad, mantenibilidad, calidad del código, calidad de las pruebas), los requisitos que las materializan (guías, sensores, principios, estándares, reglas, especificaciones) y el contexto que justifica cada uno: misión del proyecto, necesidades de usuarios y stakeholders, y riesgos asociados.
La especificación es deliberadamente neutra respecto a agentes, herramientas y proveedores. Su estructura combina un frontmatter en YAML con un cuerpo en Markdown, y define un esquema para áreas, factores, requisitos y una escala de valoración. La conformidad es una propiedad del documento; la especificación no prescribe ni certifica ningún método de evaluación concreto.
Como implementación de referencia, el proyecto ofrece el skill de agente "/quality" y la CLI "qualitymd", distribuidos bajo licencia MIT. El flujo de uso se articula en cuatro pasos: configurar ("/quality setup") para generar un QUALITY.md a medida, evaluar ("/quality evaluate") para producir un informe de calidad con hallazgos, actuar ("/quality act") y mejorar ("/quality improve") para refinar el modelo a partir de los resultados. Los informes generados incluyen recomendaciones priorizadas, listas para entregarse a un agente o a un teammate.
QUALITY.md se posiciona como complemento de archivos como AGENTS.md o CLAUDE.md: mientras las reglas y skills guían el bucle interno de trabajo, QUALITY.md define la vara con la que se juzga el resultado y alimenta los bucles de evaluación y mejora.