gov-instruction-surface-synchronization

What problem does it solve?

Repository-wide policy and guidance changes often lead to inconsistent, duplicated, or drifting instruction surfaces across editor and tool integrations, creating governance gaps and unpredictable AI behavior; this Skill centralizes updates so a single canonical source propagates reliably to all generated instruction files.

Core Features & Use Cases

• Canonical-to-surface synchronization: Reads docs/guidelines/canonical-instructions.md and inserts a sentinel-marked canonical block into CLAUDE.md, .github/copilot-instructions.md, .cursor/rules/repository.mdc, and optional GitHub instruction files.
• Safe preview and CI enforcement: Supports --dry-run previews and a --check mode that exits non-zero on drift, enabling enforcement in CI pipelines.
• Format-aware wrapping: Applies file-type specific wrappers (plain markdown, MDC frontmatter, GitHub instruction frontmatter) to preserve surrounding content while updating only the generated block.
• Use Case: When a governance change (for example, an execution-mode policy) must be reflected identically across all editor-specific instruction surfaces before a release or audit.

Quick Start

Run the sync script to update all generated instruction surfaces from the canonical source and verify results with the check mode.