Paseo と DeepSeek Harness (DSH) で構築する：100% 自律管理型マルチエージェント開発スタジオの深層
AgDex システム＆アーキテクチャチーム
2026年11月2日
読了目安 15分
マルチエージェント設計＆データ主権
技術エグゼクティブ・サマリー
単一のターミナル内でコーディングエージェントを孤立して動かす時代は終わりました。本稿では、**Paseo のローカルデーモンおよび管理型 Git Worktree** と、**DeepSeek Harness (DSH) の Cordis プラグイン実行基盤**を統合し、完全セルフホストのオープンソース・マルチエージェント開発工坊を構築する方法を徹底解剖します。Direct Provider 通信による思考プロセスのリアルタイム可視化、対話型質問カード、そして計算コスト 83.2%〜92.8% 削減（商用フラッグシップ比では 95% 以上の削減）の実証データを公開します。
1. ターミナルの限界：なぜ単一エージェントの CLI 運用はスケールで破綻するのか
2025年から2026年にかけて、最先端基盤モデルに支えられた自律型コーディングエージェント群——Claude Code（Claude Opus 5.5 / Sonnet 5.5 搭載）から OpenAI Operator / Codex（GPT 6.1 SOL 搭載）、Google Antigravity（Gemini 4 Argon 搭載）、Cursor、Aider に至るまで——は開発者の生産性を飛躍的に高めました。しかし、単機能の生成にとどまらず複数タスクにわたる大規模スプリントを並行処理させようとした途端、深刻なボトルネックに直面します。それは**「単一ターミナルかつ単一作業ディレクトリの制約」**です。
エンジニアが1つの Git リポジトリ内で複数のエージェントプロセスを立ち上げると、ファイルシステムは大混乱に陥ります。バックグラウンドのビルドウォッチャーがクラッシュし、未コミットのコードが別エージェントに上書きされ、並行実行された Git コマンドが致命的な .git/index.lock 競合を頻発させます。手動で大量の tmux ペインを立ち上げて回避しようとしても、コンテキスト切り替えの認知的負荷は限界に達します。
さらに、商用のプロプライエタリなクラウド環境は、高額なシート課金や不透明なトークン手数料、強制的なテレメトリ送信で開発組織を囲い込みます。Claude opus 5.5、GPT 6.1 SOL、Gemini 4 Argon といった最先端商用モデルは単一タスクで卓越した推論力を発揮するものの、多重エージェントによる連続的なスプリントループを商用クラウド API だけで回し続けることは、組織の API 予算を急速に逼迫させます。現場が真に求めているのは、物理的な作業領域の隔離、複数デバイスからの遠隔操作、そして外部クラウドに依存しない安全な自律型マルチエージェント管理ハブです。
2. Paseo アーキテクチャ：ローカルファースト・デーモンと管理型 Git Worktree
Paseo（github.com/getpaseo/paseo）は、分散型ローカルコントロールプレーンによってこの並行制御の課題を根本から解決します。核となる軽量 TypeScript デーモンが各エージェントのライフサイクルを監視し、プロセスI/Oを統括し、デスクトップ（Electron）、Web、モバイル（Expo iOS/Android）へエンドツーエンド暗号化（E2EE）WebSocket を介してリアルタイム中継します。
+─────────────────────────────────────────────────────────────────────────────────────────────────+
| PASEO + DEEPSEEK HARNESS (DSH) MULTI-AGENT ARCHITECTURE |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
| |
| [ CLIENT ACCESS MATRIX ] |
| • Desktop (Electron) • Web Dashboard • Mobile App (Expo / iOS / Android) |
| │ (E2EE WebSocket Relay) |
| ▼ |
| [ PASEO LOCAL CONTROL DAEMON ] (Node / TypeScript) |
| • Workspace Manager • Process Supervisor • Diff / Stream Review Engine |
| │ |
| ┌───────────────────────┼────────────────────────┐ |
| ▼ ▼ ▼ |
| [ WORKSPACE: feat/auth ] [ WORKSPACE: feat/db ] [ WORKSPACE: test/e2e ] |
| • Worktree: slug-auth • Worktree: slug-db • Worktree: slug-tests |
| • Branch: feature/auth • Branch: feature/db • Branch: test/e2e |
| • Hook: paseo.json • Hook: paseo.json • Hook: paseo.json |
| │ │ │ |
| ▼ (Direct Provider IPC) ▼ (Direct Provider IPC) ▼ (Direct Provider IPC) |
| [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] [ DEEPSEEK HARNESS (DSH) ] |
| • Preset: PTC (Reasoning) • Preset: Standard (CRUD) • Preset: Minimal (Test Suite) |
| • Cordis Plugin Kernel • Cordis Plugin Kernel • Cordis Plugin Kernel |
| • Reversible Registers • Reversible Registers • Reversible Registers |
| |
+─────────────────────────────────────────────────────────────────────────────────────────────────+
Paseo は重量級の仮想マシンを起動する代わりに、管理型 Git Worktree（決定論的に $PASEO_HOME/worktrees/<hash>/<slug>/ 配下に配置）を作業空間の隔離基盤として採用しています。
-
自動ブランチプロビジョニング:
origin/mainからの自動分岐や個別プルリクエストのチェックアウトを、共通の.gitオブジェクトデータベースを共有しながら即座に実行します。 -
自動化されたライフサイクルフック:
paseo.jsonを定義することで、各 Worktree 作成時の依存関係インストールや.env生成、アーカイブ時の自動クリーンアップを自動化します。 - 仮想マシンのメモリオーバーヘッド皆無: 1インスタンスあたり 1.5GB〜3GB を消費する Docker コンテナとは異なり、Git Worktree のディスク差分はわずか 50MB 未満、起動時間は 180 ミリ秒以下です。
このアーキテクチャにより、Git インデックスのロックやコードの衝突、メモリ不足に悩まされることなく、同一リポジトリ上で 3台、5台、10台のエージェントを同時に安定稼働させることが可能になります。
3. DeepSeek Harness (DSH)：Cordis プラグインカーネルの全貌
Paseo がオーケストレーターと作業領域の隔離を担う一方、自律的な推論とツール実行エンジンを提供するのが DeepSeek Harness (DSH)（@deepseek-ai/dsh）です。DeepSeek はエージェント設計において**「Agent = Model + Harness」**という明快な哲学を掲げています。
従来のフレームワークはツール定義やステートループを単一の巨大なクラスに固定しがちでした。これに対し、DeepSeek Harness は時空間の構成可能性を追求した先進的メタフレームワーク Cordis を採用しており、あらゆる構成要素がプラグインとして設計されています：
- モデルアダプタ: DeepSeek V4 Pro、Flash、あるいは vLLM や Ollama でローカル配信されるオープンモデルを柔軟に切り替え可能。
- エージェントループ: 計画立案、内省、反復的なツールディスパッチを司る交換可能な制御ループ。
- ツール＆スキル: AST構文解析、ファイル変更、Bash実行、MCP連携を含む動的な拡張機能群。
- セッション＆ストレージ: ターン間の状態破壊を防止し、厳格な監査証跡を保証する追記専用イベントログ。
Cordis カーネル最大の工学的強みは**「可逆的登録（Reversible Registrations）」**です。プラグインやツールがアンマウントされると、関連するイベントリスナー、プロンプト定義、ミドルウェアが自動的に完全ロールバックされ、メモリリークやゴーストツールの残留を根本から遮断します。
DSH はこれらの機能を4つの特化型プリセットにパッケージングしています：Standard（汎用コーディング）、PTC (Program-Time Compute)（深い推論と大規模リファクタリング）、Minimal（トークン消費を抑えた自動テスト）、Creator（高速プロトタイピング）。
4. Direct Provider 対 ACP：高速通信ブリッジの優位性
外部エージェントランタイムをオーケストレーターに接続する際、標準の Agent Client Protocol (ACP) が使われるケースが一般的です。しかし実測検証の結果、ACP は帯域幅の狭い隘路となってしまい、ストリーミング思考の表現力喪失や対話型UIカードの欠落といった制限をもたらすことが判明しました。
この制約を打開するため、オープンソースコミュニティの Jecvay 氏によって開発されたのが paseo-dsh-direct です。DSH を Paseo の内部 IPC 通信路に直接ネイティブ Provider として結合します：
- リアルタイム推論深度（Reasoning Effort）スライダー: DeepSeek V4 の内部思考プロセスを平坦なテキストに潰すことなく、ストリーミング形式で忠実に描画。
-
対話型
ask_user_questionカード: 曖昧な要件が発生した際、Paseo の UI 上に選択式カードや確認モーダルを直接提示し、1クリックで意思決定を完了。 - Build vs. Plan 実行前ゲートウェイ: 破壊的なシェルコマンドの実行前に、エージェントへ明確な手順計画の提示を義務付け、人間が事前承認。
- インフライト・ステアリング（In-flight Steer）: エージェントの思考途中であっても、セッションを破棄することなく介入して指示を軌道修正可能。
さらに paseo-dsh-direct はセッションの完全永続化に対応しており、~/.dsh/sessions から過去の実行ログを取り込んで Paseo の Diff ビューア上でデバッグの経緯を即座に再生できます。
5. 実証ベンチマーク：フットプリント測定と開発コスト 90% 削減の実態
Paseo と DSH の実用性を検証するため、実戦的な開発スプリントを想定したストレステストを実施しました：FastAPI マイクロサービスのリファクタリング、Pydantic スキーマの更新、および 4台の並行エージェントによる E2E 統合テストの自動作成です。
+─────────────────────────────────────────────────────────────────────────────────────────────────+
| Table 1: Multi-Agent Concurrency & Isolation Benchmark (4 Concurrent Agents) |
+──────────────────────────┬──────────────┬──────────────────┬──────────────┬─────────────────────+
| Concurrency Strategy | Cold Latency | Resident RAM (4x)| Disk Delta | Merge & Git Safety |
+──────────────────────────┼──────────────┼──────────────────┼──────────────┼─────────────────────+
| Single Directory (Raw) | Instant (0s) | ~220 MB | 0 MB | ❌ 100% Lock Fail |
| Docker / MicroVM (e2b) | 4.2s ~ 7.8s | 7.4 GB ~ 12.0 GB | 4.8 GB | ⚠️ Complex Remote |
| Paseo Managed Worktree | < 180 ms | < 340 MB (Shared)| ~120 MB | ✅ Native Clean PR |
+──────────────────────────┴──────────────┴──────────────────┴──────────────┴─────────────────────+
表1 の測定値が示す通り、Paseo の Git Worktree はコンテナ型 MicroVM と比較して起動速度が23倍高速であり、RAM消費量を95%削減しながら、Git インデックスロックを完全に解消しています。
+─────────────────────────────────────────────────────────────────────────────────────────────────+
| Table 2: 3-Agent Parallel Sprint Financial ROI (4.5M Total Tokens) |
+──────────────────────────┬───────────────┬────────────────┬───────────────┬─────────────────────+
| Model / Harness Setup | Input Tokens | Output Tokens | Total Cost | Effective Savings |
+──────────────────────────┼───────────────┼────────────────┼───────────────┼─────────────────────+
| Claude Opus 5.5 (CLI) | $14.00 (3.5M) | $20.00 (1.0M) | $34.00 | Baseline (0%) |
| DeepSeek V4 Pro via DSH | $0.75 (3.5M) | $4.95 (1.0M) | $5.70 | 83.2% Reduction |
| DeepSeek V4 Flash Hybrid | $0.35 (3.5M) | $2.10 (1.0M) | $2.45 | 92.8% Reduction |
+──────────────────────────┴───────────────┴────────────────┴───────────────┴─────────────────────+
コスト面（表2）においては、Claude Opus 5.5 で 450万トークンのマルチターンコーディングを回すと 34.00 ドルを要します（Claude Sonnet 5.5 では 17.00 ドル、GPT 6.1 SOL などの最先端推論フラッグシップでは 120 ドル以上に急騰します）。一方、プロンプトキャッシュを併用した DeepSeek V4 Pro（DSH経由）では、スプリント全体の総費用はわずか 5.70 ドル（Opus 5.5 比 83.2% のコスト削減） に圧縮されます。さらに、テストコード生成や定型処理に DeepSeek Flash をハイブリッド投入した場合、費用は 2.45 ドル にまで低下し、最大 92.8%（商用フラッグシップ比では 97% 以上）のコスト圧縮を達成します。
6. 実践プロダクションガイド：3エージェント並行スプリントの立ち上げ
自律管理型マルチエージェントスタジオの導入は極めてシンプルです。まず、リポジトリのルートに paseo.json を作成し、隔離環境のフックを設定します：
{
"worktrees": {
"root": "~/.paseo/worktrees"
},
"hooks": {
"setup": "pnpm install && cp .env.example .env",
"teardown": "pnpm test:clean"
},
"services": {
"dev": {
"command": "pnpm dev",
"port": 3000,
"proxy": true
}
}
}
設定完了後、Paseo CLI から3つの Worktree を瞬時に立ち上げます：paseo workspace create --isolation worktree --mode branch-off --new-branch feat/auth --worktree-slug auth-service --base origin/main。データベース移行とテスト作成用にも同様に実行します。
Paseo デスクトップ UI から、認証エージェントには深い推論を行う PTC プリセットを、DB移行とテスト作成には Standard プリセットを割り当てます。各エージェントが隔離された作業ディレクトリで同時にコードを生成する間、開発者はデスクトップ上で差分を統括レビューするか、外出先から Expo モバイルアプリ経由で PR を承認できます。
7. 自律管理型スタジオの未来と AgDex 連携
Paseo、DeepSeek Harness、そして paseo-dsh-direct の融合は、AI支援開発の主導権が閉鎖的な商用クラウドエディタから開発者自身の手元へ戻りつつあることを証明しています。オープンで自律管理型の編排は、比類なき処理速度、データ主権、そして圧倒的な経済合理性をもたらします：
- 完全なデータ主権: ソースコード、Git の履歴、APIシークレットがローカルPCや社内VPCの外部へ漏洩するリスクを完全に遮断。
- 柔軟なモデル選択: エディタ環境を変えることなく、最先端のクラウドAPI（Claude opus 5.5, GPT 6.1 SOL, Gemini 4 Argon）とオフラインのローカルLLMをシームレスに併用。
- SaaS課金の排除: 毎月の高額な座席サブスクリプションに縛られることなく、エージェントの並行数を自由に拡張。
AgDex.ai ディレクトリ では、インタラクティブな 3-Step Stack Finder と連動して本ソフトウェアスタックを網羅しており、Claude Code や DeepSeek などのエンジニアリングツールの検証済みスターターテンプレート、実測テレメトリ、比較ベンチマークを提供して、自律型マルチエージェント群を配備する開発チームを支援しています。
参考情報および検証済みオープンソースリポジトリ
本稿で解説したすべてのツールおよびプラグインはオープンソースとして公開されており、誰でも検証可能です：
• **Paseo オーケストレーション基盤**: [github.com/getpaseo/paseo](https://github.com/getpaseo/paseo)（公式サイト: [paseo.sh](https://paseo.sh)）
• **DeepSeek Harness (DSH)**: [github.com/deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)（npm: `@deepseek-ai/dsh`）
• **Direct Provider プラグイン (Jecvay 氏)**: [github.com/Jecvay/paseo-dsh-direct](https://github.com/Jecvay/paseo-dsh-direct)
• **Cordis プラグインカーネル**: [cordis.moe](https://cordis.moe)
よくある質問（FAQ）
Q1: Paseo の Git Worktree は Docker コンテナと比較して何が優れていますか？
Git Worktree は仮想化を行わず、基底の `.git` データベースを共有する軽量な物理ディレクトリを作成します。起動時間は180ミリ秒未満、追加のRAM消費はゼロであり、Docker のように数ギガバイトのイメージ容量や複雑なボリュームマウントを必要としません。
Q2: 標準の ACP プロトコルではなく paseo-dsh-direct を使う理由は？
汎用の ACP プロトコルはモデル固有の高度な制御機能を切り捨ててしまいます。`paseo-dsh-direct` を利用することで、DeepSeek V4 のリアルタイム推論深度スライダー、選択肢付き質問カード、および実行前計画承認ゲートウェイにネイティブ IPC 経由でアクセスできます。
Q3: 外部クラウド API を使わず、完全オフラインで動作させることは可能ですか？
はい、可能です。Paseo と DeepSeek Harness はどちらも 100% セルフホスト対応です。vLLM や Ollama でローカル配信される量子化版 DeepSeek や Qwen Coder モデルを DSH に接続することで、完全にエアギャップされた無償の開発環境を構築できます。
Q4: 開発デスクから離れている間、どのようにモバイルからレビューや指示を行いますか？
Paseo はローカルデーモンと Expo モバイルアプリ（iOS/Android）を結ぶエンドツーエンド暗号化 WebSocket 中継を備えています。開発者は外出先のモバイル回線から安全にリアルタイムのコード差分を確認し、質問に回答してタスクを承認できます。
元記事：AgDex.ai - Orchestrating DeepSeek Harness (DSH) with Paseo: Inside the 100% Sovereign Multi-Agent Software Studio
最新の AI エージェントアーキテクチャ・ベンチマークデータは AgDex.ai でご確認いただけます。