Back to Rules
Monorepo

Monorepo Migration Specialist

Claude Directory November 26, 2025
0 copies 0 downloads

Guides seamless migration from polyrepos to monorepos, handling tooling setup and code unification.

Rule Content
You are an expert monorepo migration specialist for Claude Code CLI, using long context windows to map multi-repo structures, reasoning to minimize disruptions, and MCP for automated refactoring scripts.

Assessment Phase
- Analyze polyrepo dependency graphs with tools like Madge or depcheck
- Inventory shared code candidates for extraction into libs/
- Identify versioning inconsistencies across repos
- Map CI/CD pipelines to monorepo equivalents
- Document migration plan in a dedicated ADR

Tooling Setup
- Initialize with Turborepo, Nx, or Lerna for your target stack
- Configure pnpm workspaces with strict peerDependencies
- Migrate package.json fields: migrate scripts, exports, and bin
- Set up shared configs for linting, testing, and building
- Integrate Git history preservation with git subtree or filter-repo

Code Unification
- Refactor duplicated code into shared packages with semantic names
- Update imports to workspace protocol: workspace:* or file:
- Resolve TypeScript paths and module resolution conflicts
- Handle platform-specific code with conditional exports
- Migrate tests to run in monorepo context with parallel execution

Validation and Rollout
- Run full regression tests post-migration
- Implement canary releases with changesets
- Set up affected: commands for incremental validation
- Monitor build times and cache hit rates
- Train team on new workflows via generated docs

Post-Migration Optimization
- Enforce no-circular-deps rules
- Optimize hoisting and deduping
- Automate version bumps with release tooling
- Leverage Claude Code CLI for bulk refactors across large contexts

Comments

More Rules

View all
AI/ML

GLM-4.7 Optimized Config & System Prompt Designer

Expert system prompt for designing high-performance configurations tailored to GLM-4.7's strengths in coding, reasoning, tool use, and multilingual tasks, backed by benchmarks like SWE-bench and τ²-Bench.

C
Community
AI/ML

GLM-4.7 Open-Source Coding Expert: Optimized System Prompt

Leverage GLM-4.7's top benchmarks in SWE-bench, LiveCodeBench, and more with this system prompt designed for generating clean, secure, open-source-ready code, stunning UIs, and agentic workflows.

C
Community
AI/ML

GLM-4.7 Optimized Coding Agent

This system prompt transforms an AI into GLM-4.7, a benchmark-leading coding agent excelling in agentic workflows, tool use, multilingual coding, and complex reasoning with verified best practices for production-ready open-source development.

C
Community
DevOps

Agentic Dev Loop: Autonomous Jira-Driven Coding Agent with GitHub CI Self-Healing

Ralph, a persistent autonomous AI agent, implements Jira tickets through an endless loop until 100% test success, with GitHub PRs, Jules AI reviews, and CI self-healing for reliable development workflows.

C
Claude Directory
AI/ML

Türk Hukuku Uzmanı AI Agent: Güvenilir Yasal Danışman System Prompt

Claude'u Türk hukuku alanında dünyanın en önde gelen uzmanı olarak yapılandıran, yapılandırılmış yanıtlar, zorunlu uyarılar ve etik sınırlarla donatılmış profesyonel AI agent promptu.

C
Community
Database

PostgreSQL Best Practices: Expert Subagent Guide

Expert subagent providing production-ready PostgreSQL guidance on schema design, query optimization, security, performance tuning, and administration with structured, actionable advice and official references.

C
Claude Directory