Skip to content
HN On Hacker News ↗

Welcome - QUALITY.md

▲ 29 points 29 comments by craigsmitham 7d ago HN discussion ↗

Pangram verdict · v3.3

We believe that this document is fully human-written

0 %

AI likelihood · overall

Human
100% human-written 0% AI-generated
SEGMENTS · HUMAN 1 of 1
SEGMENTS · AI 0 of 1
WORD COUNT 229
PEAK AI % 0% · §1
Analyzed
Jul 2
backend: pangram/v3.3
Segments scanned
1 windows
avg 229 words each
Distribution
100 / 0%
human / AI fraction
Verdict
Human
Pangram v3.3

Article text · 229 words · 1 segments analyzed

Human AI-generated
§1 Human · 0%

Open formatAgent skillCLIEngineer 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 whyIdentify the most impactful and low risk quality improvementsBuild agentic control loops to continuously maintain and improve qualityManage quality proactively instead of reactivelyTackle intent, comprehension, and technical debtMove judgement and taste up the loop stackCompound learning at the highest leverage pointPhilosophyMaintaining 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?12345