Document Refinement

Structured review to answer: "Is this document clear and ready for the next phase?"

Audience: Engineers reviewing brainstorm outputs, plans, or PRDs before handoff. Goal: Catch vagueness and gaps early. Auto-fix minor issues, flag substantive ones.

Assessment Criteria

Score each 1-5:

Criterion	1 (Fail)	3 (Acceptable)	5 (Excellent)
Clarity	Vague language, undefined terms	Mostly clear, few ambiguities	Every statement is actionable and specific
Completeness	Missing required sections	Has all sections, some thin	All sections substantive with no gaps
Specificity	"Handle errors appropriately"	Some concrete details	Exact behaviors, values, and boundaries defined
YAGNI	Speculative features, gold-plating	Minor scope creep	Every item traces to a stated requirement
User Intent Fidelity	Drifted from original request	Mostly aligned	Precisely captures what user asked for

document-refinement

Document Refinement

Assessment Criteria