Feature: Symlink Management & Synchronization

[stevei101]

Symlink Management System

Create and maintain symlinks to distributed governance documents across agent locations.

Functionality

• Create symlinks from master AGENTS.md to agent-specific locations
• Validate symlink integrity
• Synchronize all symlinks to latest master
• Detect and fix broken symlinks
• Support custom symlink targets

Supported Targets

• CLAUDE.md - Claude agent guidance
• .cursor/rules/swarm.mdc - Cursor IDE rules
• AGENTS.md - Codex guidance
• .github/copilot-instructions.md - GitHub Copilot
• GEMINI.md - Google Gemini
• .agent/rules/orchestration.md - Custom agents

Implementation

• src/governance/symlinks.rs - Core symlink operations
• src/governance/validator.rs - Validation & health checks
• CLI commands: sync, validate, status

Requirements

• Cross-platform (macOS, Linux, Windows if possible)
• Atomic operations (no partial syncs)
• Clear error messages on failures
• Undo capability for rollback

Testing

• Unit tests for symlink creation/validation
• Integration tests with real files
• Edge cases (broken links, permissions, etc.)

---

Related: #30 (Epic), #32 (Phase 2)
Labels: governance, symlinks, sync