Note: The
/qualityagent skill andqualitymdCLI can create a comprehensive quality evaluation with findings and actionable recommendations that are ideal for engineering a quality improvement loop based on how QUALITY.md models project quality.While not part of the formal spec, the skill and CLI demonstrate how a tool or system can build on the QUALITY.md standard. Future models, agents, and AI assistants can become more capable of using QUALITY.md to guide, evaluate, and improve their work products.
The rest of this guide demonstrates how the quality evaluation created by the skill and CLI can be integrated into workflows or agentic control loops to help maintain and improve project quality.
The quality loop
Basic form
- Observe: user and stakeholder needs, objectives, risks, internal and external feedback, conversations, changes to the environment, etc.
- Orient: refine or correct QUALITY.md based on observations and an
assessment of previous recommendation quality: credibility, utility, and risk;
then evaluate quality with
/quality evaluateto produce a comprehensive quality evaluation report with verifiable improvement recommendations for consideration. - Decide: determine recommendations that are ready for handoff or implementation.
- Act: hand off or implement actionable recommendations.