| name | repository-drift-control |
| description | Enforce coordinated updates across specs, templates, prompts, samples, and docs to prevent repository guidance drift. |
| version | 1.0.0 |
| allowed-tools | ["Read","Edit"] |
| metadata | {"source_docs":"AGENTS.md, README.md, specs/context_aware_ai_session_spec.md","workflow_type":"governance"} |
Repository Drift Control
Purpose
Prevent divergence between authoritative specification, operational prompts/templates, and repository-facing documentation.
When To Use
- Use this skill when specification or governance files change.
- Use this skill during repo-wide refactors affecting canonical paths or precedence rules.
- Do not use this skill for isolated content edits without cross-artifact impact.
How to Invoke
Load or attach this file's contents into your AI session to activate the workflow (paste, upload, or reference with #file:skills/repository-drift-control/SKILL.md in VS Code Copilot Chat). In Claude Projects, add it to project knowledge. See Invoking Skills in the README for full platform guidance.
Required Inputs
- Changed authoritative artifact(s), especially
specs/context_aware_ai_session_spec.md.
- Current canonical path map.
- List of dependent files expected to be audited.
Workflow
- Identify source-of-truth changes and affected dependency set.
- Audit templates, prompts, samples, README, and AGENTS for alignment.
- Apply consistent terminology and path references.
- Verify policy and precedence remain coherent after updates.
- Record drift-control outcomes in commit/PR summary.
Output Expectations
- Aligned artifacts with no stale references.
- Stable canonical paths and precedence documentation.
- Clear audit trail of what was updated and why.
Resources
- Governance contract:
../../AGENTS.md
- Repository guide:
../../README.md
- Authoritative model:
../../specs/context_aware_ai_session_spec.md
Constraints And Safety
- Treat specification as authoritative when conflicts exist.
- Keep guidance provider-neutral.
- Preserve canonical path stability unless explicitly migrating.
- Avoid partial updates that leave dependent artifacts inconsistent.