# monorepo-architect

monorepo-architect is a Claude Code skill for planning monorepos and their build systems. It activates during repository consolidation, workspace setup, or CI work.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 50 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/monorepo-architect
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/monorepo-architect

## What it does

The skill helps choose a monorepo tool, lay out projects, and plan build workflows. Its scope includes Nx, Turborepo, Bazel, and Lerna, along with build caches, dependency graphs, and change detection for CI.

It starts by considering codebase size and team structure, then maps out workspace configuration and task pipelines. It also covers shared libraries and dependency rules. Detailed examples are in `resources/implementation-playbook.md`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/monorepo-architect
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill monorepo-architect -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/monorepo-architect/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/monorepo-architect/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill monorepo-architect -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/monorepo-architect/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill monorepo-architect -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/monorepo-architect/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates cli-tool/components/skills/development/monorepo-architect
```

2. **Manually: put the files in place**
- File: `.github/skills/monorepo-architect/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill monorepo-architect -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/monorepo-architect
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/monorepo-architect/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/monorepo-architect

## When to use it
- choose tooling for a new monorepo
- move separate repositories into a shared workspace
- configure build caching and CI change detection
- organize shared libraries and project dependencies

## Example prompts
- Plan a monorepo structure for these applications and explain the tooling choice.
- Help move our separate repositories into one monorepo.
- Review this slow CI pipeline and suggest change detection for affected projects.

## Similar
- [monorepo-ci-optimizer](https://affpapa.org/en/nevibecode/skills/monorepo-ci-optimizer.md) — skill · 264 installs
- [monorepo-manager](https://affpapa.org/en/nevibecode/plugins/monorepo-manager.md) — plugin · ★ 2858 repo stars
- [monorepo-management](https://affpapa.org/en/nevibecode/skills/monorepo-management.md) — skill · 14548 installs
- [turborepo-monorepo](https://affpapa.org/en/nevibecode/skills/turborepo-monorepo.md) — skill · 4300 installs
- [nx-monorepo](https://affpapa.org/en/nevibecode/skills/nx-monorepo.md) — skill · 4000 installs
- [monorepo](https://affpapa.org/en/nevibecode/skills/monorepo.md) — skill · 741 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
