# Design and Optimize Your Monorepo

Complex repositories often suffer from unclear boundaries, slow builds, and inefficient continuous integration. This skill creates practical architecture and optimization plans for scalable monorepos.

## Install

```bash
npx skillstore add sickn33/monorepo-architect
```

## Metadata

- Status: approved
- Slug: sickn33-monorepo-architect
- Skillstore revision: r2
- Version status: missing
- Tree hash: 7aae22fa67f035a12a3a7b885501e10489c9e485a1509614a43b682295cef058
- Author: sickn33
- GitHub username: sickn33
- License: MIT
- Repository: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/monorepo-architect
- Ref: 81e05e636292629114b76cbb3922fbe57672fc02
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/sickn33-monorepo-architect
- Manifest: https://skillstore.pages.dev/api/skills/sickn33-monorepo-architect/manifest

## Capabilities

- Compares Nx, Turborepo, Bazel, and Lerna against repository and team requirements.
- Proposes workspace structures with clear application and library boundaries.
- Plans local and remote build caching strategies.
- Designs affected-project detection and task pipelines for continuous integration.
- Recommends dependency constraints, naming conventions, and code ownership practices.
- Creates migration steps for moving from multiple repositories into one monorepo.

## Use Cases

- Plan a New Product Workspace: Select a monorepo tool and define project boundaries, shared libraries, task pipelines, and caching.
- Accelerate Continuous Integration: Identify affected-project workflows, parallel tasks, and remote caching opportunities for a slow pipeline.
- Migrate Consolidated Repositories: Create a phased migration plan that preserves ownership, dependency boundaries, release workflows, and team autonomy.

## Prompt Templates

### Choose a Monorepo Tool

```
Compare Nx, Turborepo, Bazel, and Lerna for [project types], [team size], and [build constraints]. Recommend one option with clear tradeoffs.
```

### Design the Workspace

```
Design a monorepo structure for [applications] and [shared domains]. Define project boundaries, naming conventions, dependency rules, and ownership.
```

### Optimize the Build Pipeline

```
Review this build workflow: [workflow summary]. Propose task dependencies, affected-project detection, parallel execution, and local and remote caching.
```

### Plan a Polyrepo Migration

```
Create a phased migration from [current repositories] to one monorepo. Address dependency mapping, releases, ownership, testing, caching, rollback, and success metrics.
```

## Limitations

- It provides architecture guidance but does not execute migrations or validate builds.
- Recommendations require repository details, team constraints, and infrastructure context.
- The referenced implementation playbook is not included in this skill package.
- Remote caching guidance still requires provider-specific security and access review.

## Best Practices

- Provide repository size, languages, package managers, deployment model, and team ownership before requesting recommendations.
- Validate proposed boundaries against real dependency graphs and release responsibilities.
- Measure clean builds, cached builds, and affected workflows before and after changes.

## Anti Patterns

- Do not select tooling only from popularity or feature lists.
- Do not centralize unrelated code without explicit ownership and dependency boundaries.
- Do not enable remote caching before reviewing credentials, access controls, and data retention.

## Security Audit

- Audited at: 2026-08-04T14:54:32.756\+00:00
- Summary: The only static finding is a false positive caused by Markdown backticks around a relative documentation path. No executable code, command invocation, prompt injection, or malicious intent was found.

## Stats

- Views: 90
- Downloads: 10
- Favorites: 0
- Popularity score: 0