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:

   <!-- AUTO-GENERATED from shared-rules/ -->
   <!-- Last synced: 2026-01-22 12:00:00 -->
   

Execution

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