QUALITY.md: an open format to help humans and agents maintain and continuously improve the quality of the systems they ship, operate, and maintain by making easier to attend to, align on, and care for what matters most. QUALITY.md is an open format with a quality model in the YAML frontmatter: the quality characteristics (security, accessibility, test quality, etc.) and their quality requirements (docs, guides, sensors, etc) and the context for why these matter in the markdown body.
No reviews yetBe the first to leave a review for QUALITY.md
Maker
📌
Hello all, I created QUALITY.md to help build a holistic quality evaluation process for my projects. Turns out it's also ideal for loop engineering. I'm hoping this provides a valuable contribution to the conversation around quality and craft and having AI help us in the effort. I hope to shift the mindset from a reactive/review/repair mindset to a proactive care mindset.
Report
how does this actually integrate with existing CI pipelines — does it run checks automatically or is it more of a documentation layer we have to wire up ourselves?
Report
How does this actually integrate with existing CI pipelines or agent workflows to surface gaps between the stated quality requirements and what's really shipping in the repo?
Report
love how QUALITY.md keeps the quality model in the YAML frontmatter but leaves the actual context in the markdown body. that split lets humans and agents parse the structure while still reading the why. feels like the kind of format that could quietly become a default.
how does this actually integrate with existing CI pipelines — does it run checks automatically or is it more of a documentation layer we have to wire up ourselves?
How does this actually integrate with existing CI pipelines or agent workflows to surface gaps between the stated quality requirements and what's really shipping in the repo?
love how QUALITY.md keeps the quality model in the YAML frontmatter but leaves the actual context in the markdown body. that split lets humans and agents parse the structure while still reading the why. feels like the kind of format that could quietly become a default.