agent-ruleslisted

# Agent Rules - Single Source of Truth Every AI coding agent reads its own rules file and its own skills directory. This skill keeps one real copy of each and points the rest at it with symlinks. ## Quick Start ```bash /agent-rules # create or repair links in the current project /agent-rules --check # verify; exits 1 when something is broken /agent-rules --status # report only, never fails /agent-rules --minimal # skip links agents no longer need /agent-rules --root <path> # operate on a project other than $PWD ``` The target project is the git toplevel of your working directory (or `$PWD` outside a repo), **not** wherever this skill happens to be installed. ## Single Source of Truth Two sources, edited by hand: 1. **Rules** — `AGENTS.md` at the project root 2. **Skills** — `.agents/skills/<skill-name>/SKILL.md` Everything else is a symlink into those two. ``` AGENTS.md ← edit rules here .agents/skills/ ← edit skills here ↓ symlinks ↓ CLAUDE.md → AGENTS.md .gemini/GEMINI.md → ../AGENTS.md .github/copilot-instructions.md → ../AGENTS.md (legacy) .cursor/rules/main.md → ../../AGENTS.md (legacy) .kiro/steering/main.md → ../../AGENTS.md (legacy) .claude/skills/ → ../.agents/skills .kiro/skills/ → ../.agents/skills .github/skills/ → ../.agents/skills (legacy) .cod