---
name: sync-rules
description: Synchronize shared rules into agent context files and headers.
version: 1.1.0
tags: [rules, governance, sync]
owner: orchestration
status: active
---
# Sync Rules Skill
Synchronize shared rules from `shared-rules/` to all agent context files.
## Overview
This skill propagates rules from the central `shared-rules/` directory to:
- `CLAUDE.md` (this file)
- Project-level context files
- Agent-specific overrides
## Usage
```
/sync-rules
```
## Prerequisites
- Python environment available to run `scripts/sync-rules.py`.
## How It Works
1. **Read shared rules**:
```
shared-rules/
├── core-rules.md
├── coding-standards.md
├── guardrails.md
├── cli-reference.md
├── lessons-learned.md
└── agent-overrides/
└── claude.md
```
2. **Assemble CLAUDE.md**:
- Start with claude-specific header
- Append shared rules in order
- Add lessons learned at end
3. **Update timestamp**:
```markdown
<!-- AUTO-GENERATED from shared-rules/ -->
<!-- Last synced: 2026-01-22 12:00:00 -->
```
## Execution
```bash
python scripts/sync-rules.py
```
Or manually:
1. Read all files from `shared-rules/`
2. Concatenate in order
3. Write to `CLAUDE.md`
## File Order
1. `agent-overrides/claude.md` - Claude-specific rules (header)
2. `core-rules.md` - Core workflow rules
3. `coding-standards.md` - Coding guidelines
4. `guardrails.md` - Safety guardrails
5. `cli-reference.md` - CLI tool reference
6. `lessons-learned.md` - Lessons from past issues
## Validation
After sync, verify:
- [ ] CLAUDE.md updated
- [ ] Timestamp current
- [ ] No merge conflicts
- [ ] Rules are complete
## Outputs
- Updated `CLAUDE.md` and any derived context files.
## Error Handling
- If sync fails, stop and fix the script or inputs before continuing.
- If timestamps are stale, rerun the sync to avoid mismatched rules.
## Examples
```
/sync-rules
```
## Related Skills
- `/add-lesson` - Add a lesson before syncing rules
## When to Sync
Run sync after:
- Adding a new lesson learned
- Updating shared rules
- Before starting a new workflow
- After pulling changes from git
