Skip to main content
モノレポと複数パッケージのワークスペースでは、サブディレクトリごとに異なる言語、パッケージマネージャー、依存関係の構成を利用する場合があるため、ブループリントで追加の考慮が必要です。Devin は 2 つの方法をサポートしています。

ネイティブワークスペース(推奨)

サブディレクトリごとに個別のブループリントを作成します。各ワークスペースにはそれぞれ専用の initialize、maintenance、Knowledge セクションがあり、作業ディレクトリは自動的にそのサブディレクトリに設定されます。

サブシェル

1 つのブループリント内で (cd dir && command) を使ってサブディレクトリでコマンドを実行します。パッケージ数が少ない小規模なモノレポでは、こちらのほうがシンプルです。

ネイティブワークスペース

ほとんどのモノレポに推奨されます。 ネイティブワークスペースでは、各サブディレクトリに、セットアップ、Knowledge、作業ディレクトリが分離された専用のブループリントが用意されます。パッケージ数が増えても、サブシェルを使うより整理しやすく、保守も簡単です。
ネイティブワークスペースでは、各サブディレクトリに専用のブループリントが割り当てられます。そのブループリント内のコマンドは、作業ディレクトリがあらかじめそのサブディレクトリに設定された状態で実行されるため、cd やサブシェルは不要です。

ルートブループリント

ネイティブワークスペースを利用するすべてのリポジトリでは、ルートブループリントが必要です。ルートブループリントはリポジトリルートから実行され、ワークスペース単位のブループリントより前に実行されます。これは、実行環境やグローバルツールのインストール、ルートレベルでの依存関係のインストールなど、リポジトリ全体に共通するセットアップに利用します。
その後、ワークスペースのブループリントがパッケージごとのセットアップを処理し、ルートブループリントの完了後に実行されます。

ワークスペースの作成

  1. Settings > Environment > Blueprints に移動します
  2. リポジトリをクリックします
  3. Workspaces タブを開き、Add ブループリント をクリックします
  4. サブディレクトリのパス (例: packages/frontend) を入力します
  5. そのワークスペース用のブループリントを記述します
ワークスペースのパスは、リポジトリ内に実在するディレクトリに対応している必要があります。Devin はルートブループリントの initialize ステップが実行された後にパスをチェックするため、ルートのセットアップ中に作成されたディレクトリ (たとえば、パッケージマネージャーのワークスペースリンクや生成されたコード) も有効なパスとして扱われます。それでもパスが存在しない場合、そのワークスペースのセットアップは失敗と見なされ、buildは Partial として完了します。この場合、他のリポジトリやワークスペースは引き続き使用できますが、存在しないワークスペースはスキップされます。パスがリポジトリの構成と完全に一致していることを必ず確認してください (例: packages/frontend であり、pkg/frontend ではありません) 。

例

React のフロントエンドと Python のバックエンドを含むモノレポです。ルートブループリントで共有ツールをインストールし、その後は各ワークスペースがそれぞれの依存関係を管理します。
各ワークスペースの knowledge エントリは、そのサブディレクトリにスコープされています。Devin が packages/frontend で作業しているときは、バックエンド用ではなく、フロントエンドの lint/test/dev コマンドを参照します。

ネイティブワークスペースを利用する場面

  • サブディレクトリごとに使用する言語やパッケージマネージャーが異なる
  • 各パッケージごとに専用のKnowledge エントリ (lint、テスト、ビルドコマンド) が必要
  • セットアップを分離したい — 1 つのワークスペースのブループリントが壊れていても、ほかのワークスペースには影響しない
  • パッケージ数が増えており、単一のブループリントでは管理しづらくなっている

サブシェル

比較的シンプルなモノレポであれば、各ステップ内で必要なサブディレクトリに移動することで、単一のブループリント内ですべてを管理できます。
build 中、各ステップはブループリントの作業ディレクトリ (ルートブループリントの場合はリポジトリルート) から開始されるため、cd が有効なのはそのステップの終わりまでです。括弧 (cd ... && ...) はサブシェルを作成するため、同じステップ内の残りの行でも作業ディレクトリは元に戻ります。

サブシェルが重要な理由

単独の cd は同じ run 内の後続の行にも引き継がれます。そのため、1 つのステップ内でディレクトリを複数回変更する場合は、サブシェルを利用してください。
括弧がないと、2行目のコマンドは packages/frontend の中で packages/backend を探すことになり、失敗します。

subshellsを利用するケース

  • モノレポ内のパッケージ数が少なく、セットアップがシンプル
  • すべてのパッケージで同じ言語とパッケージマネージャーを使っている
  • パッケージごとのKnowledgeエントリは不要

モノレポ向けのKnowledgeエントリ

ネイティブ ワークスペースとサブシェルのどちらを利用する場合でも、適切に構成されたKnowledgeエントリがあれば、Devinはコードベースを把握しやすくなります。
各ディレクトリをその使用言語とツールチェーンに対応付ける structure の Knowledge エントリがあると、Devin は repo 内をすばやく把握できます。ネイティブ ワークスペースでは、各ワークスペースがそれぞれ独自の Knowledge エントリを持つため、structure エントリが特に有用なのは、ルートのブループリント内、またはサブシェルベースのセットアップです。

使用例

Turborepo / Nx ワークスペース

Turborepo や Nx のようなモノレポ向けビルドツールで管理されるワークスペースでは、依存関係をルートにインストールし、パッケージごとの処理はツールに任せます。

複数のJDKバージョン

サービスごとに必要なJDKバージョンが異なるJavaモノレポ:

共有ツール向けの org ブループリント

モノレポ内の複数のパッケージで同じツールを共有する場合は、org-wide ブループリントに一度だけインストールします。Settings > Environment > Blueprints に移動し、Configuration セクションの Organization blueprint 行で Edit をクリックします:
すると、各repo ブループリントで必要になるのはプロジェクト固有のコマンドだけです:

ベストプラクティス

各サブディレクトリで使用する言語、パッケージマネージャー、buildプロセスが異なる場合は、ネイティブワークスペースを使うことで各ブループリントを明確に切り分け、独立性を保てます。サブシェルは、少数のパッケージだけを扱うシンプルなケースに限って使用してください。
build中、各ステップはブループリントの作業ディレクトリから開始されるため、cd が次のステップに引き継がれることはありません。1 つのステップ内では、cd コマンドを括弧で囲んでください: (cd dir && command)。これにより、ある行でのディレクトリ変更がそれ以降の行に影響するのを防げます。
複数のリポジトリで使用する language runtimes や パッケージマネージャー は、org-wide ブループリントに含めるべきです。これにより重複を避けられ、repo ブループリントをプロジェクト固有のセットアップに集中させられます。
パッケージ A が、先にbuildされたパッケージ B に依存する場合は、maintenance で A のインストールステップより前に B のbuildステップを記載してください。ブループリント のステップは、記載された順に順次実行されます。
ディレクトリと使用する言語・ツールの対応を示す structure という名前のナレッジエントリがあると、Devin がコードベースを把握しやすくなります。各サブディレクトリで使用する パッケージマネージャー と、パッケージ間の依存関係も含めてください。
1 つの大きなナレッジエントリにする代わりに、各パッケージごとに個別のエントリ (例: frontend、backend、ml-pipeline) を作成してください。ネイティブワークスペースでは、各ワークスペースに専用の knowledge セクションが組み込まれています。
pnpm install --force ではなく pnpm install を、rm -rf .venv && uv sync ではなく uv sync を使ってください。増分更新のコマンドの方が、定期的な rebuild 時に高速です。