Lesson 0001 | Mission: pi × herdr による自律型開発・研究開発ワークフロー

Lesson 01: pi-coding-agent の基本構造と herdr オーケストレーション概念

このレッスンでは、copilot-cli や antigravity-cli を使いこなしている方が、 なぜ pi-coding-agent (pi) をメインオーケストレーターとして据え、herdr と組み合わせるのか、 そのアーキテクチャと基本操作を身につけます。

1. pi-coding-agent (pi) の特徴

pi はミニマルかつプログラマブルな設計が特徴のエージェントCLIです。 巨大なフレームワークを介さずとも、軽量かつ柔軟にシェル環境と対話できます。

• 軽量かつ高速な起動: プロセス立ち上げオーバーヘッドが極めて小さい。
• 2つの実行モード:
  • インタラクティブ TUI (pi): 人間が会話しながら進める対話モード。
  • 非対話バッチ (pi -p "プロンプト"): シェルスクリプトや別エージェントからパイプ処理しやすいワンショットモード。
• 柔軟な安全制御: --tools read,grep,find,ls のようにツールを制限することで、安全な調査専用エージェント（読み取り専用）として稼働させることが可能。

2. herdr との連携モデル（親エージェント ⇄ 子エージェント）

1つのターミナル画面で複数のエージェントを手動で切り替えるのではなく、 「pi (親) がターミナル上で自律的に herdr CLI を叩いて、別ペインにサブエージェント（pi, copilot, agy等）を立ち上げ・監視する」 のが herdr オーケストレーションの真骨頂です。

[Herdr Session / Tab]
┌───────────────────────────────────────────────────────────┐
│ Pane 1 (Main Orchestrator: pi)                            │
│  ├─ ユーザーと対話 / 全体タスクの設計                     │
│  ├─ 1. herdr pane split --direction right                 │
│  ├─ 2. herdr agent start worker1 --kind pi --pane w1:p2   │
│  ├─ 3. herdr agent prompt worker1 "データ集計" --wait    │
│  └─ 4. herdr agent read worker1 で結果回収 & レポート統合 │
└───────────────────────────┬───────────────────────────────┘
                            │ (制御 & 結果集約)
                            ▼
┌───────────────────────────────────────────────────────────┐
│ Pane 2 (Worker 1: pi / sub-agent)                         │
│  └─ 重いデータ処理、実験スクリプト実行、長文要約          │
└───────────────────────────────────────────────────────────┘

3. 製造業・研究職・事務作業におけるメリット

製造業の研究開発や事務業務では、 「時間がかかる処理（大量のCSV/センサデータ集計、物性値のスクレイピング・文献調査、特許PDFの確認）」 と 「思考を継続する作業（方針決定、考察、レポート構成）」 が混在します。

• メインの pi に方針を相談しながら、別ペインで子エージェントに「この10個の実験ログの異常値を抽出してグラフ化しておいて」と非同期に投げられる。
• GUI画面を立ち上げることなく、端末内で完結するため、社内LinuxサーバやリモートGPUマシン環境でも全く同一の操作感で動く。

4. 理解度確認クイズ

pi -p "1行で自己紹介をしてください"