monorepo ナビゲーションパターン
ワークフロー中級
数十のパッケージを持つmonorepoはClaude Codeにナビゲーションの課題を生みます。ガイドなしでは、無関係なパッケージの読み込みでコンテキストを浪費します。このパターンはCLAUDE.mdを使ってパッケージマップ、依存関係グラフ、ルーティングルールを提供し、Claudeが正確にどこを見るべきか把握できるようにします。パッケージ間の変更、共有型の更新、パッケージ固有のオーバーライドのコンベンションを含みます。
monorepoナビゲーションTurborepoワークスペース
パターンコード
# Monorepo Navigation Pattern
## Root CLAUDE.md — Package Map
```markdown
# Monorepo: Acme Platform
## Package Map
| Package | Path | Purpose | Owner |
|---------|------|---------|-------|
| @acme/web | apps/web | Next.js frontend | frontend-team |
| @acme/api | apps/api | Express API server | backend-team |
| @acme/admin | apps/admin | Admin dashboard | frontend-team |
| @acme/ui | packages/ui | Shared UI components | design-system |
| @acme/types | packages/types | Shared TypeScript types | all |
| @acme/db | packages/db | Database client + schema | backend-team |
| @acme/auth | packages/auth | Auth utilities | security-team |
| @acme/config | packages/config | Shared configs (ESLint, TS) | infra-team |
## Dependency Graph (simplified)
web → ui, types, auth, config
api → types, db, auth, config
admin → ui, types, auth, config
ui → types, config
db → types, config
## Routing Rules
- UI changes: start in packages/ui, then check apps/{web,admin}
- Type changes: update packages/types, then fix ALL consumers
- Auth changes: update packages/auth, verify in apps/api first
- Schema changes: packages/db first, then packages/types, then apps/api
## Cross-Package Change Checklist
1. Update the source package
2. Run `turbo build --filter=...^...` to check dependents
3. Update consumers if the public API changed
4. Run `turbo test` from root to verify everything
```
## Package-Level CLAUDE.md (apps/api/CLAUDE.md)
```markdown
# @acme/api
## Entry Point
- src/index.ts (Express app setup)
- src/routes/ (route definitions, one file per resource)
## Testing
- Run: `pnpm --filter @acme/api test`
- Integration tests need DATABASE_URL set
## Local Dependencies
- @acme/types: import { User, Order } from "@acme/types"
- @acme/db: import { db } from "@acme/db"
- @acme/auth: import { verifyToken } from "@acme/auth"
```
このパターンをプロジェクト設定にコピーして適用してください。
実行プレビュー
monorepo ナビゲーションパターン
monorepo ナビゲーションパターンについて
Claude Codeパターンは、複雑な開発シナリオに対応するための実証済みアーキテクチャ設計とワークフロー構造です。monorepo ナビゲーションパターンは中級レベルのワークフローパターンで、プロジェクトに合わせて応用できるテスト済みの再現可能なアプローチを提供し、より効率的で一貫した成果を実現します。