Goal
Keep agent governance consistent across tools by editing canonical sources and regenerating shims.
Canonical sources (edit these)
- •
AGENTS.md - •
docs/agents/** - •
.agents/skills/** - •
scripts/agents/** - •
ci/**,schemas/**
Required workflow
- •Make the requested governance change in canonical sources.
- •Regenerate shims:
- •
python scripts/agents/sync_shims.py - •(if governance changed)
python scripts/agents/generate_cursor_rule.py
- •
- •Validate:
- •
python ci/validate_agent_assets.py
- •
- •If validation fails, fix the canonical source and regenerate shims again.
- •Update
docs/agents/CHANGELOG.md(add an Unreleased entry).
Boundaries
- •Do not add new dependencies unless explicitly asked.
- •Do not hand-edit shim directories (
.claude/,.gemini/,.agent/,.cursor/). - •Keep
AGENTS.mdshort; add detail todocs/agents/.