gov-instruction-surface-synchronization

To synchronize instruction files across AI editors, this Skill reads a canonical source and inserts sentinel-marked blocks into CLAUDE.md, .github/copilot-instructions.md, and .cursor/rules/repository.mdc, ensuring byte-for-byte consistency across all generated instruction surfaces.

Preventing policy drift in editor-specific instruction files requires propagating updates from a central canonical source. This Skill centralizes governance changes and applies format-aware wrapping to update only the generated blocks, preserving surrounding content.

You can enforce instruction file consistency in CI pipelines using the --check mode. This mode exits non-zero when it detects drift between the canonical instructions and the generated editor files, allowing automated enforcement during maintenance or audits.

To preview canonical instruction updates before applying them, you can run the synchronization script with the --dry-run flag. This allows you to verify the sentinel-marked blocks and format-aware wrappers before modifying CLAUDE.md or copilot-instructions.md.

The synchronization process preserves existing content in copilot-instructions.md and repository.mdc files by applying file-type specific wrappers. It inserts sentinel-marked canonical blocks and updates only the generated sections while leaving surrounding content untouched.

You need to update instruction surfaces for AI tool integrations during repository-wide governance changes, audits, or editor integration modifications. Synchronizing from the canonical source ensures identical execution-mode policies across all generated instruction files.