Welcome - QUALITY.md

Open formatAgent skillCLI

Engineer loops to improve project quality, aligning your team and agents on what quality means for what matters most.

Getting startedEngineer quality loopsRead the spec

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 /qualityagent skilland qualitymdCLIserve 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
• Move judgement and taste up the loop stack
• Compound learning at the highest leverage point

Philosophy

Maintaining the quality of a thing is caring for it. When a thing exists for the benefit of another, caring for it well is caring for the other well.

The aim of QUALITY.md is to help others care well by making the practice of maintenance accessible to humans and agents.

How to use QUALITY.md?

FAQ