Engineer loops to improve project quality, aligning your team and agents on what quality means for what matters most.
What is QUALITY.md?
QUALITY.md is anopen file formatfor declaring a project quality model: a holistic rubric of the desired quality characteristics (security, maintainability, code quality, test/spec quality, etc.), their quality requirements (guides, sensors, principles, standards, rules, specs), and the context (mission/purpose, user/stakeholder needs, risks, etc.) for why they matter.
The QUALITY.md formatspecificationis designed to be agent, tool, and vendor agnostic. The companion /quality agent skilland qualitymd CLIserve as both a reference implementation and starter kit for working with QUALITY.md files, including the ability to create a comprehensivequality evaluation reportwith prioritizedimprovement recommendationsready for handoff or further review, useful for engineering quality loops or augmenting your existing workflow.
Why QUALITY.md?
Ensure stakeholders are aligned on what matters most and why
Identify the most impactful and low risk quality improvements
Build agentic control loops to continuously maintain and improve quality
Manage quality proactively instead of reactively
Tackle intent, comprehension, and technical debt
... continue reading