monorepo-single-dependency-versions — Claude Code rule
monorepo-single-dependency-versions is a Claude Code rule that pins identical dependency versions across monorepo packages. It stops bundle bloat and runtime version clashes.
AGPL-3.0 ★ 88 updated 2026-11-17
.claude/rules/monorepo-single-dependency-versions.mdWhat monorepo-single-dependency-versions does
The rule instructs the coding agent to drop semver ranges like ^ and ~ in favor of exact release numbers. Discrepancies between workspace packages duplicate library code inside distribution builds and cause runtime behavior conflicts.
Enforcing this policy relies on tools such as syncpack or root-level overrides in npm and pnpm, as well as resolutions in yarn. Without pinned root declarations, nested subpackages quickly drift out of alignment.
What it helps with
- prevent duplicate packages in production bundles
- pin exact dependency versions without semver ranges
- align shared module versions across workspace packages
- configure package manager overrides in root package.json
Example prompts for the agent
- Add react-native-reanimated to packages/app and packages/ui with a single pinned version
- Audit all package.json files and strip caret and tilde version prefixes
- Set up root pnpm overrides to enforce uniform dependency releases
How to install monorepo-single-dependency-versions
Manually: put the files in place
.claude/rules/monorepo-single-dependency-versions.mdThe paths frontmatter field limits the files
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/monorepo-single-dependency-versions.mdcFrontmatter: description, globs, alwaysApply
Manually: put the files in place
.github/instructions/monorepo-single-dependency-versions.instructions.mdThe applyTo field sets which files it applies to
Manually: put the files in place
.devin/rules/monorepo-single-dependency-versions.mdManually: put the files in place
.clinerules/monorepo-single-dependency-versions.mdStep by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use
Questions about monorepo-single-dependency-versions
How to install monorepo-single-dependency-versions in Claude Code?
Place the rule file at .claude/rules/monorepo-single-dependency-versions.md in your project.
What does monorepo-single-dependency-versions do?
It guides the assistant to apply uniform, exact package versions across every workspace package, avoiding version ranges.
How does the rule resolve version conflicts?
It suggests checking versions with syncpack or adding root overrides and resolutions to package.json to lock a single version.