ネイティブワークスペース(推奨)
サブディレクトリごとに個別のブループリントを作成します。各ワークスペースにはそれぞれ専用の initialize、maintenance、Knowledge セクションがあり、作業ディレクトリは自動的にそのサブディレクトリに設定されます。
サブシェル
1 つのブループリント内で
(cd dir && command) を使ってサブディレクトリでコマンドを実行します。パッケージ数が少ない小規模なモノレポでは、こちらのほうがシンプルです。ネイティブワークスペース
ほとんどのモノレポに推奨されます。 ネイティブワークスペースでは、各サブディレクトリに、セットアップ、Knowledge、作業ディレクトリが分離された専用のブループリントが用意されます。パッケージ数が増えても、サブシェルを使うより整理しやすく、保守も簡単です。
cd やサブシェルは不要です。
ルートブループリント
ネイティブワークスペースを利用するすべてのリポジトリでは、ルートブループリントが必要です。ルートブループリントはリポジトリルートから実行され、ワークスペース単位のブループリントより前に実行されます。これは、実行環境やグローバルツールのインストール、ルートレベルでの依存関係のインストールなど、リポジトリ全体に共通するセットアップに利用します。ワークスペースの作成
- Settings > Environment > Blueprints に移動します
- リポジトリをクリックします
- Workspaces タブを開き、Add ブループリント をクリックします
- サブディレクトリのパス (例:
packages/frontend) を入力します - そのワークスペース用のブループリントを記述します
例
React のフロントエンドと Python のバックエンドを含むモノレポです。ルートブループリントで共有ツールをインストールし、その後は各ワークスペースがそれぞれの依存関係を管理します。- ルート
- packages/frontend
- packages/backend
knowledge エントリは、そのサブディレクトリにスコープされています。Devin が packages/frontend で作業しているときは、バックエンド用ではなく、フロントエンドの lint/test/dev コマンドを参照します。
ネイティブワークスペースを利用する場面
- サブディレクトリごとに使用する言語やパッケージマネージャーが異なる
- 各パッケージごとに専用のKnowledge エントリ (lint、テスト、ビルドコマンド) が必要
- セットアップを分離したい — 1 つのワークスペースのブループリントが壊れていても、ほかのワークスペースには影響しない
- パッケージ数が増えており、単一のブループリントでは管理しづらくなっている
サブシェル
比較的シンプルなモノレポであれば、各ステップ内で必要なサブディレクトリに移動することで、単一のブループリント内ですべてを管理できます。cd が有効なのはそのステップの終わりまでです。括弧 (cd ... && ...) はサブシェルを作成するため、同じステップ内の残りの行でも作業ディレクトリは元に戻ります。
サブシェルが重要な理由
単独のcd は同じ run 内の後続の行にも引き継がれます。そのため、1 つのステップ内でディレクトリを複数回変更する場合は、サブシェルを利用してください。
packages/frontend の中で packages/backend を探すことになり、失敗します。
subshellsを利用するケース
- モノレポ内のパッケージ数が少なく、セットアップがシンプル
- すべてのパッケージで同じ言語とパッケージマネージャーを使っている
- パッケージごとのKnowledgeエントリは不要
モノレポ向けのKnowledgeエントリ
ネイティブ ワークスペースとサブシェルのどちらを利用する場合でも、適切に構成されたKnowledgeエントリがあれば、Devinはコードベースを把握しやすくなります。使用例
Turborepo / Nx ワークスペース
Turborepo や Nx のようなモノレポ向けビルドツールで管理されるワークスペースでは、依存関係をルートにインストールし、パッケージごとの処理はツールに任せます。複数のJDKバージョン
サービスごとに必要なJDKバージョンが異なるJavaモノレポ:共有ツール向けの org ブループリント
モノレポ内の複数のパッケージで同じツールを共有する場合は、org-wide ブループリントに一度だけインストールします。Settings > Environment > Blueprints に移動し、Configuration セクションの Organization blueprint 行で Edit をクリックします:ベストプラクティス
複雑なモノレポではネイティブワークスペースを優先する
複雑なモノレポではネイティブワークスペースを優先する
各サブディレクトリで使用する言語、パッケージマネージャー、buildプロセスが異なる場合は、ネイティブワークスペースを使うことで各ブループリントを明確に切り分け、独立性を保てます。サブシェルは、少数のパッケージだけを扱うシンプルなケースに限って使用してください。
1 つのステップ内でディレクトリを複数回変更する場合はサブシェルを使用する
1 つのステップ内でディレクトリを複数回変更する場合はサブシェルを使用する
build中、各ステップはブループリントの作業ディレクトリから開始されるため、
cd が次のステップに引き継がれることはありません。1 つのステップ内では、cd コマンドを括弧で囲んでください: (cd dir && command)。これにより、ある行でのディレクトリ変更がそれ以降の行に影響するのを防げます。共有ツールは org ブループリントに置く
共有ツールは org ブループリントに置く
複数のリポジトリで使用する language runtimes や パッケージマネージャー は、org-wide ブループリントに含めるべきです。これにより重複を避けられ、repo ブループリントをプロジェクト固有のセットアップに集中させられます。
maintenance のステップは依存関係順に並べる
maintenance のステップは依存関係順に並べる
パッケージ A が、先にbuildされたパッケージ B に依存する場合は、
maintenance で A のインストールステップより前に B のbuildステップを記載してください。ブループリント のステップは、記載された順に順次実行されます。構造を示すナレッジエントリを追加する
構造を示すナレッジエントリを追加する
ディレクトリと使用する言語・ツールの対応を示す
structure という名前のナレッジエントリがあると、Devin がコードベースを把握しやすくなります。各サブディレクトリで使用する パッケージマネージャー と、パッケージ間の依存関係も含めてください。パッケージごとのナレッジエントリを使う
パッケージごとのナレッジエントリを使う
1 つの大きなナレッジエントリにする代わりに、各パッケージごとに個別のエントリ (例:
frontend、backend、ml-pipeline) を作成してください。ネイティブワークスペースでは、各ワークスペースに専用の knowledge セクションが組み込まれています。maintenance は増分的に保つ
maintenance は増分的に保つ
pnpm install --force ではなく pnpm install を、rm -rf .venv && uv sync ではなく uv sync を使ってください。増分更新のコマンドの方が、定期的な rebuild 時に高速です。関連ページ
- 宣言型環境設定
- ブループリント リファレンス
- テンプレート ライブラリ — すぐに使えるモノレポテンプレートを収録

