| name | documentation-quality-checklist |
| description | Quality validation checklist for generated documentation pages. Covers content completeness, evidence backing, markdown syntax, diagram validation, and cross-reference consistency. Use before finalizing any documentation page. |
| user-invocable | false |
Documentation Quality Checklist
Validation criteria for generated documentation pages. Run through this checklist before writing any page to disk.
Content Completeness
Evidence Backing
Markdown Syntax
Diagram Validation
Cross-References
Word Count Guidelines
| Page Type | Target Range | Notes |
|---|
| Overview pages | 500-1000 | Concise, high-level |
| Architecture pages | 1000-2000 | Detailed with diagrams |
| Component/service pages | 800-1500 | Focused on single topic |
| Workflow pages | 600-1200 | Step-by-step with diagrams |
| Reference pages | 300-800 | Tables and lists |
Quick Validation
For rapid checks, verify these critical items:
- Required content exists - All sections and diagrams present
- Evidence is real - Code examples from actual codebase
- Links work - Cross-references match sitemap
- Renders correctly - Markdown syntax is valid
Failure Criteria
A page should NOT be written if:
- Missing more than one required section
- No evidence sources cited
- Contains placeholder text (TODO, TBD, etc.)
- Markdown has syntax errors that break rendering
- Word count is below minimum for page type
Version: 1.0
Last Updated: 2026-01-22