What problem does it solve? Repository instruction files like AGENTS.md, READMEs, and codemaps drift over time, accumulating stale, duplicated, or misplaced guidance that wastes context and confuses both humans and AI agents. This Skill audits, migrates, and refreshes the entire documentation governance system so critical rules stay always-on while reference material lives in authoritative on-demand locations. ## Core Features & Use Cases - Three Operating Modes: Audit (inspect and recommend without editing), Migration (implement an accepted redistribution of instructions), and Refresh (sync documentation claims with current repository reality). - Classification Model: Routes every rule to its correct home, whether root AGENTS.md, nested guides, codemaps, task-specific skills, or architecture docs, and removes duplicated or superseded content. - Verification Contract: Validates SKILL.md frontmatter, checks referenced paths exist, tests skill discovery with opencode debug, and confirms no critical invariant depends only on optional skill loading. - Use Case: A repository's root AGENTS.md has grown to hundreds of lines mixing safety invariants with stale route lists and duplicated catalogs. Run an audit to classify each section, then migrate topology facts to the codemap and procedures into focused skills while preserving every critical rule. ## Quick Start Audit this repository's AGENTS.md files, codemaps, and documentation indexes, then recommend a governance restructure without making any edits.
