meta-document

What problem does it solve?

Living code bases often drift from their documentation, making it hard for new contributors and stakeholders to understand system behavior and decisions. The meta-document skill automatically generates and synchronizes living documentation from code changes, PRs, and commits, ensuring the docs reflect the latest implementation.

Core Features & Use Cases

• Auto-generation from changes: Scans commits and PRs to extract patterns, anti-patterns, and architecture updates, creating or updating docs in docs/patterns and CLAUDE.md.
• Self-validating living docs: Includes executable detection scripts and tests that verify docs stay aligned with code, with nightly checks where applicable.
• Real-world references and governance: Maintains references to PRs, issues, and related incidents, aiding governance and onboarding.
• Immediate quick-start workflows: Provides commands to sync from code, validate patterns, and derive docs from recent changes.

Quick Start

Use the meta-document tool to generate or refresh living documentation from code changes:

• Sync from code: /meta-document --sync-from-code
• Validate existing patterns: /meta-document --validate-patterns
• Generate from PR: /meta-document --from-pr <PR_NUMBER>