hyper-docs-sync

What problem does it solve?

This Skill prevents docs from going stale by syncing documentation to match recent code changes in APIs, schemas, CLI flags, and architecture.

Core Features & Use Cases

• Detects code changes for a targeted doc update: Computes the changed file set and diffs for a range of invocation scopes (empty since main, uncommitted, specific commit SHA, or a ref range).
• Maps code changes to documentation via a CLAUDE mapping table: Reads CLAUDE.md and/or AGENTS.md to find a Code-to-Docs mapping table and uses it for precise routing.
• Uses safe heuristics with confidence reporting: Applies name-similarity heuristics only when appropriate, and skips low-confidence matches while reporting possible candidates.
• Creates or updates affected docs using a documenter agent: Dispatches the documenter agent per affected target doc (create mode if the doc file is missing, otherwise update mode) and aggregates multiple code diffs to avoid redundant dispatches.

Quick Start

Run /hyperclaude:hyper-docs-sync after your implementation work to automatically update the impacted documentation files to reflect the current code state.