monorepo-architect

Guides Turborepo and pnpm monorepo structure, boundaries, pipelines, and caching conventions.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/SleyiW/iWana-neXt --skill monorepo-architect-sleyiw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monorepo-architect
Source: https://github.com/SleyiW/iWana-neXt/tree/main/.agents/skills/monorepo-architect
Command: npx skills add https://github.com/SleyiW/iWana-neXt --skill monorepo-architect-sleyiw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Structuring a Turborepo and pnpm monorepo without clear conventions leads to broken package boundaries, duplicated configuration, slow CI, and uncacheable pipelines. This Skill provides the concrete structure, boundary rules, and pipeline standards for the iWana neXt monorepo so new apps and packages stay consistent. ## Core Features & Use Cases - Monorepo Structure Guidance: Defines the real workspace layout (apps, packages, e2e, docs) with naming and responsibility rules for each package. - Boundary and Pipeline Rules: Enforces dependency boundaries between packages and cacheable, composable turbo.json pipelines for lint, typecheck, test, and build. - Package Checklist & Anti-patterns: Provides a checklist for creating new packages and lists anti-patterns to avoid, such as cyclic dependencies or oversized shared packages. - Use Case: When adding a new shared package to the monorepo, use this Skill to verify its public API, package.json cleanliness, turbo script alignment, and boundary compliance before merging. ## Quick Start Ask the assistant to review the monorepo structure and define the pipeline and boundaries for a new package using the monorepo-architect skill.

Frequently Asked Questions about monorepo-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a Turborepo monorepo with pnpm?

Organize apps under apps/ and shared code under packages/, with each package having a clear responsibility and minimal public API. Declare the packageManager field as [email protected] in the root package.json, which Turborepo 2.x requires.

How do I define cacheable pipelines in turbo.json?

Define clear tasks such as lint, typecheck, test, and build, and declare correct outputs for each so Turborepo can cache deterministic results. Prefer incremental, composable pipelines over scripts that mix many responsibilities.

What are package boundary rules in a monorepo?

Apps may depend on approved shared packages, but a package must never import internals of another package. Avoid cyclic dependencies and keep domain logic separate from generic utilities.

Should I use Nx, Bazel, or Lerna instead of Turborepo?

This Skill assumes Turborepo and pnpm are already decided and does not evaluate Nx, Bazel, or Lerna as alternatives. It focuses on structure, boundaries, and pipelines within the existing Turborepo setup.

When should I not apply monorepo-level guidance?

Skip it when the task is a feature inside a single package or when the main decision concerns backend or frontend architecture rather than workspace structure. It targets cross-package concerns only.