turborepo

Turborepo スキル

JavaScript／TypeScript のモノレポ向けビルドシステムです。Turborepo はタスクの出力をキャッシュし、依存関係グラフに基づいてタスクを並列実行します。

重要：ルートタスクではなくパッケージタスクを作成する

ルートタスクは作成しないでください。必ずパッケージタスクを作成してください。

タスク／スクリプト／パイプラインを作成するときは、必ず次の手順に従ってください。

1. 関連する各パッケージの package.json にスクリプトを追加します
2. ルートの turbo.json にタスクを登録します
3. ルートの package.json からは turbo run <task> を呼び出します

タスクのロジックをルートの package.json に記述しないでください。 そうすると、Turborepo の並列化が機能しなくなります。

// DO THIS: Scripts in each package
// apps/web/package.json
{ "scripts": { "build": "next build", "lint": "eslint .", "test": "vitest" } }

// apps/api/package.json
{ "scripts": { "build": "tsc", "lint": "eslint .", "test": "vitest" } }

// packages/ui/package.json
{ "scripts": { "build": "tsc", "lint": "eslint .", "test": "vitest" } }

// turbo.json - register tasks
{
  "tasks": {
    "build": { "dependsOn": ["^build"], "outputs": ["dist/**"] },
    "lint": {},
    "test": { "dependsOn": ["build"] }
  }
}

// Root package.json - ONLY delegates, no task logic
{
  "scripts": {
    "build": "turbo run build",
    "lint": "turbo run lint",
    "test": "turbo run test"
  }
}

// DO NOT DO THIS - defeats parallelization
// Root package.json
{
  "scripts": {
    "build": "cd apps/web && next build && cd ../api && tsc",
    "lint": "eslint apps/ packages/",
    "test": "vitest"
  }
}

ルートタスク（//#taskname）は、パッケージ内に作成できないタスク（まれなケース）に限って使用します。

副次的なルール：turbo run と turbo

コマンドをコードに記述するときは、必ず turbo run を使用してください。

// package.json - ALWAYS "turbo run"
{
  "scripts": {
    "build": "turbo run build"
  }
}

# CI workflows - ALWAYS "turbo run"
- run: turbo run build --affected

短縮形の turbo <tasks> は、人間またはエージェントがターミナルに直接入力する単発のコマンドに限って使用します。package.json、CI、スクリプトに turbo build を記述しないでください。

簡単な判断フロー

「タスクを設定したい」

Configure a task?
├─ Define task dependencies → references/configuration/tasks.md
├─ Lint/check-types (parallel + caching) → Use Transit Nodes pattern (see below)
├─ Specify build outputs → references/configuration/tasks.md#outputs
├─ Handle environment variables → references/environment/RULE.md
├─ Set up dev/watch tasks → references/configuration/tasks.md#persistent
├─ Package-specific config → references/configuration/RULE.md#package-configurations
└─ Global settings (cacheDir, daemon) → references/configuration/global-options.md

「キャッシュが機能していない」

Cache problems?
├─ Tasks run but outputs not restored → Missing `outputs` key
├─ Cache misses unexpectedly → references/caching/gotchas.md
├─ Need to debug hash inputs → Use --summarize or --dry
├─ Want to skip cache entirely → Use --force or cache: false
├─ Remote cache not working → references/caching/remote-cache.md
└─ Environment causing misses → references/environment/gotchas.md

「変更されたパッケージだけを実行したい」

Run only what changed?
├─ Changed packages + dependents (RECOMMENDED) → turbo run build --affected
├─ Custom base branch → --affected --affected-base=origin/develop
├─ Manual git comparison → --filter=...[origin/main]
└─ See all filter options → references/filtering/RULE.md

変更されたパッケージだけを実行するには、--affected を使用するのが基本です。 デフォルトブランチとの差分を自動的に比較し、依存先のパッケージも含めます。

「パッケージをフィルタリングしたい」

Filter packages?
├─ Only changed packages → --affected (see above)
├─ By package name → --filter=web
├─ By directory → --filter=./apps/*
├─ Package + dependencies → --filter=web...
├─ Package + dependents → --filter=...web
└─ Complex combinations → references/filtering/patterns.md

「環境変数が機能していない」

Environment issues?
├─ Vars not available at runtime → Strict mode filtering (default)
├─ Cache hits with wrong env → Var not in `env` key
├─ .env changes not causing rebuilds → .env not in `inputs`
├─ CI variables missing → references/environment/gotchas.md
└─ Framework vars (NEXT_PUBLIC_*) → Auto-included via inference

「CI を設定したい」

CI setup?
├─ GitHub Actions → references/ci/github-actions.md
├─ Vercel deployment → references/ci/vercel.md
├─ Remote cache in CI → references/caching/remote-cache.md
├─ Only build changed packages → --affected flag
├─ Skip unnecessary builds → turbo-ignore (references/cli/commands.md)
└─ Skip container setup when no changes → turbo-ignore

「開発中に変更を監視したい」

Watch mode?
├─ Re-run tasks on change → turbo watch (references/watch/RULE.md)
├─ Dev servers with dependencies → Use `with` key (references/configuration/tasks.md#with)
├─ Restart dev server on dep change → Use `interruptible: true`
└─ Persistent dev tasks → Use `persistent: true`

「パッケージを作成／構成したい」

Package creation/structure?
├─ Create an internal package → references/best-practices/packages.md
├─ Repository structure → references/best-practices/structure.md
├─ Dependency management → references/best-practices/dependencies.md
├─ Best practices overview → references/best-practices/RULE.md
├─ JIT vs Compiled packages → references/best-practices/packages.md#compilation-strategies
└─ Sharing code between apps → references/best-practices/RULE.md#package-types

「モノレポはどのように構成すればよいですか？」

Monorepo structure?
├─ Standard layout (apps/, packages/) → references/best-practices/RULE.md
├─ Package types (apps vs libraries) → references/best-practices/RULE.md#package-types
├─ Creating internal packages → references/best-practices/packages.md
├─ TypeScript configuration → references/best-practices/structure.md#typescript-configuration
├─ ESLint configuration → references/best-practices/structure.md#eslint-configuration
├─ Dependency management → references/best-practices/dependencies.md
└─ Enforce package boundaries → references/boundaries/RULE.md

「アーキテクチャ上の境界を強制したい」

Enforce boundaries?
├─ Check for violations → turbo boundaries
├─ Tag packages → references/boundaries/RULE.md#tags
├─ Restrict which packages can import others → references/boundaries/RULE.md#rule-types
└─ Prevent cross-package file imports → references/boundaries/RULE.md

重大なアンチパターン

コードで turbo の短縮形を使用する

package.json のスクリプトや CI パイプラインでは、turbo run の使用を推奨します。 短縮形の turbo <task> は、対話的なターミナル操作を目的としています。

// WRONG - using shorthand in package.json
{
  "scripts": {
    "build": "turbo build",
    "dev": "turbo dev"
  }
}

// CORRECT
{
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev"
  }
}

# WRONG - using shorthand in CI
- run: turbo build --affected

# CORRECT
- run: turbo run build --affected

Turbo を経由しないルートスクリプト

ルートの package.json スクリプトは、タスクを直接実行するのではなく、必ず turbo run を呼び出してください。

// WRONG - bypasses turbo entirely
{
  "scripts": {
    "build": "bun build",
    "dev": "bun dev"
  }
}

// CORRECT - delegates to turbo
{
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev"
  }
}

&& を使って Turbo のタスクを連結する

Turbo のタスクを && で連結しないでください。オーケストレーションは Turbo に任せてください。

// WRONG - turbo task not using turbo run
{
  "scripts": {
    "changeset:publish": "bun build && changeset publish"
  }
}

// CORRECT
{
  "scripts": {
    "changeset:publish": "turbo run build && changeset publish"
  }
}

依存パッケージを手動でビルドする prebuild スクリプト

他のパッケージを手動でビルドする prebuild のようなスクリプトは、Turborepo の依存関係グラフを経由しません。

// WRONG - manually building dependencies
{
  "scripts": {
    "prebuild": "cd ../../packages/types && bun run build && cd ../utils && bun run build",
    "build": "next build"
  }
}

ただし、修正方法はワークスペースの依存関係が宣言されているかどうかによって異なります。

1. 依存関係が宣言されている場合（例：package.json に "@repo/types": "workspace:*" と記載されている場合）、prebuild スクリプトを削除します。Turbo の dependsOn: ["^build"] が自動的に処理します。

2. 依存関係が宣言されていない場合、依存関係がないと ^build が実行されないため、prebuild が存在しています。次の手順で修正します。

   • package.json に依存関係を追加します："@repo/types": "workspace:*"
   • 次に、prebuild スクリプトを削除します

// CORRECT - declare dependency, let turbo handle build order
// package.json
{
  "dependencies": {
    "@repo/types": "workspace:*",
    "@repo/utils": "workspace:*"
  },
  "scripts": {
    "build": "next build"
  }
}

// turbo.json
{
  "tasks": {
    "build": {
      "dependsOn": ["^build"]
    }
  }
}

重要なポイント： ^build は、依存関係として指定されたパッケージでのみビルドを実行します。依存関係の宣言がなければ、ビルド順序は自動的に設定されません。

範囲が広すぎる globalDependencies

globalDependencies はすべてのパッケージのすべてのタスクに影響します。具体的に指定してください。

// WRONG - heavy hammer, affects all hashes
{
  "globalDependencies": ["**/.env.*local"]
}

// BETTER - move to task-level inputs
{
  "globalDependencies": [".env"],
  "tasks": {
    "build": {
      "inputs": ["$TURBO_DEFAULT$", ".env*"],
      "outputs": ["dist/**"]
    }
  }
}

繰り返しの多いタスク設定

まとめられるタスク間の重複設定がないか確認してください。Turborepo は設定を共有するパターンに対応しています。

// WRONG - repetitive env and inputs across tasks
{
  "tasks": {
    "build": {
      "env": ["API_URL", "DATABASE_URL"],
      "inputs": ["$TURBO_DEFAULT$", ".env*"]
    },
    "test": {
      "env": ["API_URL", "DATABASE_URL"],
      "inputs": ["$TURBO_DEFAULT$", ".env*"]
    },
    "dev": {
      "env": ["API_URL", "DATABASE_URL"],
      "inputs": ["$TURBO_DEFAULT$", ".env*"],
      "cache": false,
      "persistent": true
    }
  }
}

// BETTER - use globalEnv and globalDependencies for shared config
{
  "globalEnv": ["API_URL", "DATABASE_URL"],
  "globalDependencies": [".env*"],
  "tasks": {
    "build": {},
    "test": {},
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

グローバル設定とタスクレベルの設定の使い分け：

• globalEnv／globalDependencies — すべてのタスクに影響するため、本当に共有する設定に使用します
• タスクレベルの env／inputs — 特定のタスクだけが必要とする場合に使用します

アンチパターンではないもの：大きな env 配列

大きな env 配列（50 個以上の変数を含む場合でも）は問題ではありません。通常は、ビルドの環境依存関係をユーザーが丁寧に宣言していることを示します。これを問題として指摘しないでください。

--parallel フラグを使用する

--parallel フラグは、Turborepo の依存関係グラフを迂回します。タスクを並列実行する必要がある場合は、代わりに dependsOn を正しく設定してください。

# WRONG - bypasses dependency graph
turbo run lint --parallel

# CORRECT - configure tasks to allow parallel execution
# In turbo.json, set dependsOn appropriately (or use transit nodes)
turbo run lint

ルートの turbo.json でのパッケージ固有のタスクオーバーライド

複数のパッケージで異なるタスク設定が必要な場合は、ルートの turbo.json に package#task のオーバーライドを詰め込むのではなく、パッケージ設定（各パッケージの turbo.json）を使用してください。

// WRONG - root turbo.json with many package-specific overrides
{
  "tasks": {
    "test": { "dependsOn": ["build"] },
    "@repo/web#test": { "outputs": ["coverage/**"] },
    "@repo/api#test": { "outputs": ["coverage/**"] },
    "@repo/utils#test": { "outputs": [] },
    "@repo/cli#test": { "outputs": [] },
    "@repo/core#test": { "outputs": [] }
  }
}

// CORRECT - use Package Configurations
// Root turbo.json - base config only
{
  "tasks": {
    "test": { "dependsOn": ["build"] }
  }
}

// packages/web/turbo.json - package-specific override
{
  "extends": ["//"],
  "tasks": {
    "test": { "outputs": ["coverage/**"] }
  }
}

// packages/api/turbo.json
{
  "extends": ["//"],
  "tasks": {
    "test": { "outputs": ["coverage/**"] }
  }
}

パッケージ設定のメリット：

• 設定を、影響を受けるコードの近くに配置できます
• ルートの turbo.json をすっきり保ち、基本パターンに集中できます
• 各パッケージ固有の設定を把握しやすくなります
• $TURBO_EXTENDS$ を使って、配列を継承・拡張できます

ルートで package#task を使う場合：

• 1 つのパッケージに固有の依存関係が必要な場合（例："deploy": { "dependsOn": ["web#build"] }）
• 移行中の一時的なオーバーライド

詳しくは references/configuration/RULE.md#package-configurations を参照してください。

inputs で ../ を使ってパッケージの外に移動する

パッケージ外のファイルを参照するために、../ のような相対パスを使わないでください。代わりに $TURBO_ROOT$ を使用してください。

// WRONG - traversing out of package
{
  "tasks": {
    "build": {
      "inputs": ["$TURBO_DEFAULT$", "../shared-config.json"]
    }
  }
}

// CORRECT - use $TURBO_ROOT$ for repo root
{
  "tasks": {
    "build": {
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/shared-config.json"]
    }
  }
}

ファイルを生成するタスクに outputs がない

outputs がないと指摘する前に、タスクが実際に何を生成するのかを確認してください。

1. パッケージのスクリプトを読みます（例："build": "tsc"、"test": "vitest"）
2. ディスクにファイルを書き込むのか、stdout に出力するだけなのかを判断します
3. キャッシュすべきファイルをタスクが生成する場合に限り、指摘してください

// WRONG: build produces files but they're not cached
{
  "tasks": {
    "build": {
      "dependsOn": ["^build"]
    }
  }
}

// CORRECT: build outputs are cached
{
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    }
  }
}

フレームワークごとの一般的な出力：

• Next.js：[".next/**", "!.next/cache/**"]
• Vite/Rollup：["dist/**"]
• tsc：["dist/**"] またはカスタムの outDir

TypeScript の --noEmit でもキャッシュファイルが生成されることがあります：

tsconfig.json で incremental: true の場合、tsc --noEmit は JS を出力しなくても .tsbuildinfo ファイルを書き込みます。出力がないと決めつける前に、tsconfig を確認してください。

// If tsconfig has incremental: true, tsc --noEmit produces cache files
{
  "tasks": {
    "typecheck": {
      "outputs": ["node_modules/.cache/tsbuildinfo.json"] // or wherever tsBuildInfoFile points
    }
  }
}

TypeScript タスクに適切な outputs を判断するには：

1. tsconfig で incremental または composite が有効になっているか確認します
2. カスタムキャッシュの場所を指定する tsBuildInfoFile を確認します（デフォルト：outDir と同じ場所、またはプロジェクトルート）
3. インクリメンタルモードでなければ、tsc --noEmit はファイルを生成しません

^build と build の混同

{
  "tasks": {
    // ^build = run build in DEPENDENCIES first (other packages this one imports)
    "build": {
      "dependsOn": ["^build"]
    },
    // build (no ^) = run build in SAME PACKAGE first
    "test": {
      "dependsOn": ["build"]
    },
    // pkg#task = specific package's task
    "deploy": {
      "dependsOn": ["web#build"]
    }
  }
}

環境変数がハッシュ化されない

// WRONG: API_URL changes won't cause rebuilds
{
  "tasks": {
    "build": {
      "outputs": ["dist/**"]
    }
  }
}

// CORRECT: API_URL changes invalidate cache
{
  "tasks": {
    "build": {
      "outputs": ["dist/**"],
      "env": ["API_URL", "API_KEY"]
    }
  }
}

.env ファイルが inputs に含まれていない

Turbo は .env ファイルを読み込みません。読み込むのはフレームワークです。ただし、Turbo は変更を把握する必要があります。

// WRONG: .env changes don't invalidate cache
{
  "tasks": {
    "build": {
      "env": ["API_URL"]
    }
  }
}

// CORRECT: .env file changes invalidate cache
{
  "tasks": {
    "build": {
      "env": ["API_URL"],
      "inputs": ["$TURBO_DEFAULT$", ".env", ".env.*"]
    }
  }
}

モノレポのルートにある .env ファイル

リポジトリのルートに .env ファイルを置くのはアンチパターンです。小規模なモノレポやスターターテンプレートでも同様です。パッケージ間に暗黙の依存関係が生じ、どのパッケージがどの変数に依存しているのかが不明確になります。

// WRONG - root .env affects all packages implicitly
my-monorepo/
├── .env              # Which packages use this?
├── apps/
│   ├── web/
│   └── api/
└── packages/

// CORRECT - .env files in packages that need them
my-monorepo/
├── apps/
│   ├── web/
│   │   └── .env      # Clear: web needs DATABASE_URL
│   └── api/
│       └── .env      # Clear: api needs API_KEY
└── packages/

ルートの .env に関する問題：

• どのパッケージがどの変数を使用しているのかが不明確です
• すべてのパッケージが、必要のない変数も含め、すべての変数を取得します
• キャッシュの無効化が大まかになります（ルートの .env の変更で、すべてのキャッシュが無効になります）
• セキュリティリスクがあります。他のパッケージ向けの機密変数に、パッケージが誤ってアクセスする可能性があります
• 悪い習慣は小さなところから始まります。スターターテンプレートでは、適切なパターンを示すべきです

変数を共有する必要がある場合は、globalEnv を使って共有する内容を明示し、その理由を記載してください。

Strict モードでの CI 変数のフィルタリング

デフォルトでは、Turborepo は環境変数を env／globalEnv に指定されたものだけに絞り込みます。CI 変数が見つからない場合があります。

// If CI scripts need GITHUB_TOKEN but it's not in env:
{
  "globalPassThroughEnv": ["GITHUB_TOKEN", "CI"],
  "tasks": { ... }
}

または、--env-mode=loose を使用してください（本番環境では推奨しません）。

アプリ内の共有コード（パッケージにすべきもの）

// WRONG: Shared code inside an app
apps/
  web/
    shared/          # This breaks monorepo principles!
      utils.ts

// CORRECT: Extract to a package
packages/
  utils/
    src/utils.ts

パッケージ境界を越えてファイルにアクセスする

// WRONG: Reaching into another package's internals
import { Button } from "../../packages/ui/src/button";

// CORRECT: Install and import properly
import { Button } from "@repo/ui/button";

ルートの依存関係が多すぎる

// WRONG: App dependencies in root
{
  "dependencies": {
    "react": "^18",
    "next": "^14"
  }
}

// CORRECT: Only repo tools in root
{
  "devDependencies": {
    "turbo": "latest"
  }
}

一般的なタスク設定

標準的なビルドパイプライン

{
  "$schema": "https://turborepo.dev/schema.v2.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

キャッシュ無効化を伴う並列実行が必要なタスクがある場合は、transit タスクを追加してください（下記を参照）。

^dev パターンを使用した Dev タスク（turbo watch 用）

ルートの turbo.json で、dependsOn: ["^dev"] と persistent: false を指定した dev タスクは珍しく見えるかもしれませんが、turbo watch ワークフローでは正しい設定です。

// Root turbo.json
{
  "tasks": {
    "dev": {
      "dependsOn": ["^dev"],
      "cache": false,
      "persistent": false  // Packages have one-shot dev scripts
    }
  }
}

// Package turbo.json (apps/web/turbo.json)
{
  "extends": ["//"],
  "tasks": {
    "dev": {
      "persistent": true  // Apps run long-running dev servers
    }
  }
}

この設定が機能する理由：

• パッケージ（例：@acme/db、@acme/validators）の "dev": "tsc" は、すぐに完了するワンショットの型生成タスクです。
• アプリでは、実際の開発サーバー（Next.js など）を起動するために persistent: true を指定して上書きします。
• turbo watch は、ソースファイルが変更されるとワンショットのパッケージ dev スクリプトを再実行し、型を同期した状態に保ちます。

想定される使い方： turbo run dev ではなく、turbo watch dev を実行します。ウォッチモードでは、永続タスクを実行したまま、ファイルの変更時にワンショットのタスクを再実行します。

別のパターン： 意図をより明確にするには、ワンショットの依存関係ビルドに prepare や generate などの別のタスク名を使います。

{
  "tasks": {
    "prepare": {
      "dependsOn": ["^prepare"],
      "outputs": ["dist/**"]
    },
    "dev": {
      "dependsOn": ["prepare"],
      "cache": false,
      "persistent": true
    }
  }
}

キャッシュ無効化を伴う並列タスクのための中継ノード

一部のタスクは並列で実行できます（依存関係のビルド出力を必要としません）が、依存関係のソースコードが変更されたときにキャッシュを無効にする必要があります。

dependsOn: ["^taskname"] の問題：

• 順次実行が強制されます（低速です）。

dependsOn: []（依存関係なし）の問題：

• 並列実行が可能になります（高速です）。
• ただし、キャッシュが正しく無効化されません。依存関係のソースを変更してもキャッシュが無効になりません。

中継ノードなら、どちらの問題も解決できます。

{
  "tasks": {
    "transit": { "dependsOn": ["^transit"] },
    "my-task": { "dependsOn": ["transit"] }
  }
}

transit タスクは、実際のスクリプトに一致しない依存関係を作成するため、タスクを並列で実行しながら、キャッシュを正しく無効化できます。

このパターンが必要なタスクを見分ける方法： 依存関係のソースファイルを読み込むものの、そのビルド出力を必要としないタスクを探します。

環境変数を使用する場合

{
  "globalEnv": ["NODE_ENV"],
  "globalDependencies": [".env"],
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"],
      "env": ["API_URL", "DATABASE_URL"]
    }
  }
}

リファレンスを読み込むタイミング

references/configuration/ を読み込む場合：

• RULE.md：turbo.json の構造の概要が必要な場合
• tasks.md：タスク設定（dependsOn、outputs、inputs、env、cache）を定義する場合
• global-options.md：globalEnv、globalDependencies、cacheDir、daemon を設定する場合
• gotchas.md：想定外の設定動作に遭遇した場合

references/caching/ を読み込む場合：

• RULE.md：キャッシュハッシュの仕組みを理解する場合
• remote-cache.md：Vercel Remote Cache またはセルフホスト可能なキャッシュを設定する場合
• gotchas.md：キャッシュミスのデバッグや、--summarize／--dry フラグの使用に関する場合

references/environment/ を読み込む場合：

• RULE.md：環境変数（env、globalEnv、passThroughEnv）を設定する場合
• modes.md：strict モードと loose モードの選択、フレームワークの推論に関する場合
• gotchas.md：.env ファイルや CI 環境の問題をトラブルシューティングする場合

references/filtering/ を読み込む場合：

• RULE.md：--filter の構文の概要が必要な場合
• patterns.md：選択的な実行のための複雑なフィルターパターンを作成する場合

references/ci/ を読み込む場合：

• RULE.md：一般的な CI の原則とキャッシュ戦略に関する場合
• github-actions.md：GitHub Actions ワークフローを一通り設定する場合
• vercel.md：turbo-ignore を使った Vercel デプロイを設定する場合
• patterns.md：--affected フラグのパターンを実装し、最適化する場合

references/cli/ を読み込む場合：

• RULE.md：turbo run コマンドの基本的な使い方が必要な場合
• commands.md：turbo-ignore やフラグを含む CLI の全リファレンスが必要な場合

references/best-practices/ を読み込む場合：

• RULE.md：モノレポの構造と構成の概要が必要な場合
• structure.md：リポジトリのレイアウト、ワークスペース設定、TypeScript／ESLint の設定に関する場合
• packages.md：内部パッケージの作成、JIT とコンパイル方式の選択、エクスポートに関する場合
• dependencies.md：依存関係の管理パターンやバージョン同期に関する場合

references/watch/ を読み込む場合：

• RULE.md：開発ワークフロー向けに turbo watch を設定する場合

references/boundaries/ を読み込む場合：

• RULE.md：experimental boundaries 機能でパッケージの分離を強制する場合

リファレンス一覧

設定

ファイル	目的
configuration/RULE.md	turbo.json の概要、パッケージ設定
configuration/tasks.md	dependsOn、outputs、inputs、env、cache、persistent
configuration/global-options.md	globalEnv、globalDependencies、cacheDir、daemon、envMode
configuration/gotchas.md	よくある設定ミス

キャッシュ

ファイル	目的
caching/RULE.md	キャッシュの仕組み、ハッシュ入力
caching/remote-cache.md	Vercel Remote Cache、セルフホスト可能、ログイン／リンク
caching/gotchas.md	キャッシュミスのデバッグ、--summarize、--dry

環境変数

ファイル	目的
environment/RULE.md	env、globalEnv、passThroughEnv
environment/modes.md	Strict モードと Loose モード、フレームワークの推論
environment/gotchas.md	.env ファイル、CI の問題

フィルタリング

ファイル	目的
filtering/RULE.md	--filter 構文の概要
filtering/patterns.md	よく使われるフィルターパターン

CI/CD

ファイル	目的
ci/RULE.md	CI の一般原則
ci/github-actions.md	GitHub Actions の完全なセットアップ
ci/vercel.md	Vercel のデプロイ、turbo-ignore
ci/patterns.md	--affected、キャッシュ戦略

CLI

ファイル	目的
cli/RULE.md	turbo run の基本
cli/commands.md	turbo run のフラグ、turbo-ignore、その他のコマンド

ベストプラクティス

ファイル	目的
best-practices/RULE.md	モノレポのベストプラクティスの概要
best-practices/structure.md	リポジトリ構成、ワークスペース設定、TypeScript/ESLint の設定
best-practices/packages.md	内部パッケージの作成、JIT とコンパイル済みの比較、エクスポート
best-practices/dependencies.md	依存関係の管理、インストール、バージョンの同期

ウォッチモード

ファイル	目的
watch/RULE.md	turbo watch、中断可能なタスク、開発ワークフロー

境界（実験的）

ファイル	目的
boundaries/RULE.md	パッケージの分離を強制し、タグベースの依存関係ルールを適用

ソースドキュメント

このスキルは、Turborepo の公式ドキュメントに基づいています。

• ソース：Turborepo リポジトリ内の apps/docs/content/docs/
• ライブ：https://turborepo.dev/docs