Check-Refs Skill

Purpose: Audit cross-reference integrity across all planning and documentation artifacts in docs/. Finds broken links, inconsistent frontmatter back-links, and orphaned documents.

Overview

The planning pipeline creates linked artifacts:

docs/sketches/ ←→ docs/specs/ ←→ docs/plans/ ←→ docs/adr/

Each file should have frontmatter cross-links (e.g., next-spec:, source-sketch:). This skill validates all such links are consistent and that no markdown links point to missing files.

Step 1: Discover All Docs

Glob all markdown files:

docs/**/*.md