Docs Sync

•
18
•

Synchronizes Docusaurus wiki documentation with canonical agent manifests and repository guides using automated drift detection and MDX transforms.

Docs Sync automates the maintenance of Docusaurus documentation by keeping wiki mirrors perfectly aligned with canonical agent definitions, skill files, and core repository documents. Built as a lightweight, pure-Python utility, it provides zero-LLM drift detection that wires directly into Claude Code's Stop hook to alert developers whenever source files drift from their wiki counterparts. When applied, it executes deterministic transformations such as trimming frontmatter, escaping problematic MDX tags, injecting agent badges, and pruning orphan pages whose canonical files were deleted, eliminating manual documentation maintenance across your agent stack.

Key Features

01Transforms canonical agent and skill definitions into MDX-safe Docusaurus documents
0218 GitHub stars
03Escapes tags like `<example>` and `<commentary>` to prevent MDX rendering failures
04Detects documentation drift instantly with zero LLM costs using fast Python checks
05Integrates seamlessly with Claude Code Stop hooks to flag unsynced changes at session end
06Prunes orphaned wiki pages automatically when canonical source files are removed

Use Cases

01Preventing documentation rot across multi-agent codebases with automated Stop hook reminders
02Previewing and applying deterministic MDX formatting transformations without manual editing
03Mirroring agent manifests and skill definitions directly into a public Docusaurus knowledge base