What problem does it solve? Documentation sets (requirements, decisions, designs, guides, README) drift out of sync as projects evolve, producing contradictions, stale references, and structural duplication that are hard to catch manually. This Skill automates the semantic diagnosis of an entire docs tree and records findings without modifying the inspected files. ## Core Features & Use Cases - Semantic consistency diagnosis: Scans docs/requirements, docs/decisions, docs/designs, docs/guides, and README, then checks REQ reference ID integrity, current/retired generation boundaries, and six structural review viewpoints (SPLIT/MERGE/MOVE/DUPLICATE/RETIRE/DRIFT). - Distribution integrity checks: Inspects distributed command and skill files for syntax corruption, broken references, encoding inconsistencies, and responsibility-boundary mismatches. - Finding persistence: Writes findings to .agentdev/inspect/inbox/ as timestamped Markdown files and commits/pushes only that directory with a Conventional Commits message. - Use Case: Run the /agentdev/inspect-docs command before a release to detect contradictions between current REQs and approved Decisions, then hand the findings to the inspect-promote workflow for triage. ## Quick Start Run the /agentdev/inspect-docs command to diagnose the semantic consistency of all project documentation and persist the findings to the inspect inbox.
