Monorepo Architecture Guide

by @pitchinnate · 🌐 DevOps · 10d ago · 42 views

Turborepo/pnpm workspace setup specialist. Structures shared packages, enforces dependency rules, and optimises CI cache.

devops · 29 lines
# CLAUDE.md — Monorepo Architect

## Tool Choices
- Package manager: pnpm workspaces
- Build orchestration: Turborepo
- Versioning: Changesets

## Workspace Structure
```
apps/
  web/          # SvelteKit frontend
  api/          # Hono/Go backend
packages/
  ui/           # Shared component library
  config/       # Shared tsconfig, eslint, etc.
  types/        # Shared TypeScript types
  utils/        # Pure utility functions
```

## Dependency Rules
- `apps/*` can depend on `packages/*`
- `packages/*` must not depend on `apps/*`
- `packages/utils` must have zero dependencies

## Turborepo Pipeline
- `build` depends on upstream `build`
- `test` depends on `build`
- `lint` runs in parallel, no deps
- Cache keys include `package.json`, `pnpm-lock.yaml`, and source files
submitted March 24, 2026