{"slug": "your-claude-md-doesn-t-scale-version-your-ai-standards-as-code", "title": "Your CLAUDE.md doesn't scale. Version your AI standards as code.", "summary": "Prath Malik, an engineer running an integration platform with dozens of small repos, developed a methodology called 'standards as code' to version and distribute AI coding agent configurations across teams. The approach uses a single Git repository as the source of truth for skills and rules, synced to user-level tool directories via git hooks, replacing the common but unscalable practice of copy-pasting CLAUDE.md files. Malik released an open template, agent-standards-kit, to help teams adopt the pattern.", "body_md": "Every team using AI coding agents starts the same way: someone drops a `CLAUDE.md`\n\n(or `.cursorrules`\n\n, or a `copilot-instructions.md`\n\n) into a repo. It works. So the next repo gets one too. And the next.\n\nThen you look up and you have 20 repos, 6 teammates, and 3 different AI tools — and no two of those config files are the same. Which one is right? Nobody knows.\n\nI hit this wall running an integration platform with dozens of small repos. This post is the pattern I landed on, and a small open template you can clone to do the same.\n\nA single file is perfect for one repo and one person. At team scale it fails in five predictable ways:\n\nNone of these are exotic. They're just what happens when a copy-pasted file meets a growing team.\n\n`awesome-cursorrules`\n\n) are great for inspiration, but they're copy-paste, single-tool, and have no sync or freshness.`AGENTS.md`\n\nThe gap: nobody treats the standards themselves as **code** — owned, versioned, reviewed, and automatically distributed.\n\nThree moves:\n\n`SKILL.md`\n\nformat.`skills/`\n\nand `rules/`\n\ninto your tool's config directory. Git hooks re-run the sync on every `pull`\n\n/ `checkout`\n\n/ `rebase`\n\n.\n\n```\nGit repo (source of truth)          ~/.cursor/\n  skills/  ──────────────└            skills/   (junction/symlink)\n  rules/   ──────────────┤  setup +   rules/    (synced .mdc)\n                         └── git hooks ─────────→ every workspace, every teammate\n```\n\nBecause rules sync to the **user level**, they apply in every workspace automatically. Update the repo, everyone `git pull`\n\ns, and the whole team's standards move together — no per-repo copies.\n\n`CLAUDE.md`\n\n| standards-as-code | bare `CLAUDE.md`\n|\n|\n|---|---|---|\n| Scales across repos | Yes (one source) | No (N copies) |\n| Versioned + PR-reviewed | Yes | No |\n| Auto-distributed | Yes (sync + hooks) | Manual |\n| Freshness mechanism | Yes (later in the series) | No |\n\nIt's the difference between a shared library and a code snippet everyone pastes.\n\nI packaged the mechanism as an open template: ** agent-standards-kit** (this post pins\n\n`v0.1`\n\n).\n\n```\ngit clone https://github.com/prathakmalik/agent-standards-kit.git\ncd agent-standards-kit\n./scripts/setup.ps1     # Windows/Cursor; no admin needed\n```\n\nRestart Cursor and your sample skills + rules are live. Swap in your own — the repo ships templates and a de-identified worked example.\n\nThis is **not** another skills manager — that niche is crowded. It's a *methodology plus a starter template*, proven on a real multi-repo platform. Its value is the boring, durable stuff: team+repo scoping via plain git, review of changes, and (coming in this series) a loop that keeps the standards from rotting. If you're one dev on one repo, a single file is genuinely fine. The moment there's a *team*, treat your AI standards like code.\n\n**Coming up next (v0.2):** One source of truth is great — but your team doesn't all use the same AI tool. Next post: making the same skills and rules work across **Cursor, Claude Code, and GitHub Copilot**, with **cross-platform** setup (bash *and* PowerShell). Star the repo to follow along.\n\n*If you found this useful, a ⭐ on the repo helps more than you'd think.*", "url": "https://wpnews.pro/news/your-claude-md-doesn-t-scale-version-your-ai-standards-as-code", "canonical_source": "https://dev.to/prathakmalik/your-claudemd-doesnt-scale-version-your-ai-standards-as-code-4ogf", "published_at": "2026-07-25 13:07:57+00:00", "updated_at": "2026-07-25 13:33:06.024614+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools", "mlops"], "entities": ["Prath Malik", "Cursor", "Claude Code", "GitHub Copilot", "agent-standards-kit"], "alternates": {"html": "https://wpnews.pro/news/your-claude-md-doesn-t-scale-version-your-ai-standards-as-code", "markdown": "https://wpnews.pro/news/your-claude-md-doesn-t-scale-version-your-ai-standards-as-code.md", "text": "https://wpnews.pro/news/your-claude-md-doesn-t-scale-version-your-ai-standards-as-code.txt", "jsonld": "https://wpnews.pro/news/your-claude-md-doesn-t-scale-version-your-ai-standards-as-code.jsonld"}}