enforcing-doc-hierarchy

What problem does it solve?

Ensures repository documentation follows the project's defined authority chains by detecting broken references, duplicates, scope creep, wrong-authority placements, symlink issues, and chain breaks so documentation remains single-source-of-truth and maintainable.

Core Features & Use Cases

• Authority-chain audit: Walks both the Project Documentation and Claude Code Infrastructure chains to verify each document references the correct next-authority and that symlinks resolve to current sprint PRDs.
• Reference & duplicate detection: Finds broken cross-references, stale paths, and content duplicated across documents and classifies violations by type for targeted remediation.
• Guided alignment: Proposes minimal, authoritative fixes (move, link, or replace) and applies changes only after user approval to preserve intent and avoid accidental overwrites.
• Use Case: Run after a large rename or when reviewing a PR touching docs to prevent scope-creep and enforce where requirements, user workflows, and technical designs must live.

Quick Start

Run enforcing-doc-hierarchy on the repository root to audit both authority chains, list violations, and propose user-approved fixes.