Reader Resources
Reader Resources
Repo Hygiene Checklist
Before Merge
- Have you updated stale docs?
- Are there any broken reference paths?
- Does manuscript or docs still contain absolute-path references?
- Is the verify script aligned with the actual repo state?
- Is wording normalized against
docs/glossary.mdas the source of truth? - Are the canonical spellings of
Prompt Contract,Progress Note, andverification harnessstable? - If the diff touches an approval boundary, does
Evidence / Approvalname the approver and the decision inputs? - Is the
needs-human-approvalwording aligned withsample-repo/docs/harness/done-criteria.md? - Are
verify log,trace, andevidence bundleused as separate terms rather than mixed together? - Have you confirmed that the evidence used in review comes from the current run?
- Have you avoided leaving artifacts that still require redaction or privacy handling untouched?
- Does each chapter's
Source Notes / Further Readingstay aligned withmanuscript-en/backmatter/00-source-notes.md? - Does
manuscript-en/backmatter/00-source-notes.mdcover CH01 through CH12 without omissions? - Are
Output Contractreport fields normalized toGoal,Scope and Non-goals,Changed Files,Verification,Evidence / Approval, andRemaining Gaps? - Are local verify, CI, and evidence terms consistent across chapters and checklists?
Weekly Cleanup
- Are there any orphaned task briefs?
- Are stale Progress Notes still lingering?
- Is
AI slopaccumulating as stale docs or unused artifacts? - Are trace or evidence references left stale or expired?
- Are multiple artifacts now explaining the same thing under different names?
- Are owners and cadence for
repo hygieneandentropy cleanupstill explicit? - Did only one of source notes, reading guide, or index seed change and create backmatter drift?
Escalate When
- the source of truth conflicts
- stale artifacts are spreading across multiple chapters or tasks
- cleanup is no longer enough and structural rework is required