agent-standards-kit

Version your team's AI coding standards as code. Keep your skills and rules in git, auto-sync them into Cursor, Claude Code, and GitHub Copilot, and review changes like any other code.

agent-standards-as-code is a small, opinionated starter template for teams who use AI coding agents across many repos and want everyone's agent to follow the same standards — without copy-pasting instruction files around and watching them drift.

v0.2 — now multi-tool (Cursor, Claude Code, Copilot, Codex) and cross-platform (PowerShell + bash). The freshness loop and system-level memory arrive in v0.3-v0.4 (see Roadmap).

---

Why not just .cursorrules / CLAUDE.md?

A single instructions file is fine for one repo and one tool. With a team, a fleet of repos, and multiple AI tools it breaks down: it doesn't scale, it drifts, it's unversioned, and it's locked to one tool's format. This kit makes standards a git-versioned source of truth that syncs into whatever tools each developer uses.

---

Quick start (< 5 minutes)

# 1. "Use this template" above, or clone:
git clone https://github.com/prathakmalik/agent-standards-kit.git
cd agent-standards-kit

# 2. Run setup for your OS:
#    Windows:      ./scripts/setup.ps1
#    macOS/Linux:  ./scripts/setup.sh

# 3. Restart your AI tool(s). Skills + rules are live.

Setup syncs skills/ and rules/ into every installed tool (it detects ~/.cursor, ~/.claude, ~/.copilot, ~/.codex), using junctions on Windows / symlinks on Unix — no admin. Git hooks re-sync on every git pull.

---

How it works

flowchart LR
    SoT["Git repo (source of truth)<br/>skills/ + rules/ + AGENTS.md"] --> Sync["setup.ps1 / setup.sh<br/>+ git hooks"]
    Sync -->|junction/symlink| Cursor[".cursor/skills + .cursor/rules"]
    Sync -->|symlink| Claude["~/.claude/skills + CLAUDE.md"]
    Sync -->|symlink| Copilot["~/.copilot/skills + .github/copilot-instructions.md"]
    Sync -->|symlink| Codex["~/.codex/skills + AGENTS.md"]

Loading

• skills/ — task workflows in the open Agent Skills SKILL.md format. One skill folder works across all four tools.
• rules/ — Cursor .mdc standing guidance.
• AGENTS.md — the portable, tool-agnostic base that Claude / Codex / Copilot read.
• adapters/ — where each tool expects its files (details).
• scripts/ — cross-platform setup / sync / hooks (.ps1 + .sh).

---

Roadmap

Version	Theme	Status
v0.1	Core mechanism, Cursor	done
v0.2 (this one)	Multi-tool + cross-platform	done
v0.3	nudge -> skill -> PR freshness loop + "make it yours"	next
v0.4	System-level memory: ecosystem map + post-mortems	planned

---

Contributing

See CONTRIBUTING.md. Skills are portable SKILL.md; CI validates frontmatter.

License

MIT.