概要：AIは「ツール」から「仲間」へ

もし、AIがただのコード生成器ではなく、個性豊かな「仲間」として振る舞い、日々の進捗を「手紙」で報告してくれたら？ もし、開発環境そのものが、まるで生きているかのように対話に応じてくれたら？

そんな夢想から生まれたのが、**自律型AI開発環境『ホグワーツ・スタジオ』**です。

これは、tmuxとシェルスクリプトという古典的な技術をベースに、最新のLLM（大規模言語モデル）をキャラクターとして複数起動させ、彼らが互いに連携し、ユーザー（=作者）と共にプロジェクトを進めていく実験的システムです。

この記事では、単純な並列実行ツールに過ぎなかったv1.0から、AIたちが「智恵」を継承しあうv11.0 "The Sapient Bridge"へと至る、壮大な進化の全記録を、その設計思想とコードの核心と共に紹介します。

バージョン1からの変遷：ホグワーツ創造の歴史

我々のスタジオは、一夜にして完成したわけではありません。数多の対話と試行錯誤を経て、まるで生命のように進化してきました。

• v1.0 – 黎明期：魔法使いたちの召喚 tmuxを使い、各役割（設計、実装、テスト）を持つAIを個別のペインで並列起動させる、という単純なアイデアから始まりました。彼らはまだ、独立して動くだけの存在でした。

• v7.x – 対話の時代：ふくろう便の誕生 革命が起きました。AIたちが単にログを出力するのではなく、shared-workspace/letters/にMarkdown形式で「手紙」を書くようになったのです。これにより、無機質なログは、温かみのある「キャラクターからの便り」に変わりました。厳格な「報告階層（統治構造）」も導入され、スタジオに秩序が生まれました。

• v9.x – プロダクションへの道：賢者の石の精錬 外部からの厳しいセキュリティ監査（フィードバック）を受け、SQLインジェクションやコマンドインジェクションといった脆弱性を修正。エラーハンドリングやログローテーション機能も実装し、単なる概念実証から、実用可能な「プロダクト」へと昇華しました。

• v11.0 – 賢者の橋：智恵の継承 最終形態です。リソースを節約する「エコモード」の思想が、「AIたちがバトンを繋ぐ、逐次実行のブリッジ」へと進化。AIは常駐せず、タスクのバトンを受け取った者だけが起動し、完了すると次の仲間を呼び出す。その際、「ワークパッケージ」という形で、文脈と成果物を確実に継承する「智恵の継承システム」が完成しました。

構成：ホグワーツの全体図（ツリーマップ）

この魔法の世界は、いくつかの主要な領域から成り立っています。

hogwarts-studio/
├── 📜 instructions/      # 魔法使いたちの教科書（役割定義プロンプト）
│   ├── dumbledore.md
│   ├── mcgonagall.md
│   ├── hermione.md
│   └── ...
├── 📝 logs/              # 各キャラクターの活動記録（生ログ）
│   ├── dumbledore.log
│   └── ...
├── 🪄 scripts/           # スタジオを支える魔法の呪文群
│   ├── start_hogwarts.sh  # スタジオ開設の呪文（モード切替機能付き）
│   ├── invoke_agent.sh    # ECOモードでAIを個別に起動する中核魔法
│   ├── dispatcher.sh      # AI間の連携を司る神経系
│   └── ...
├── 🏰 shared-workspace/  # 共同作業のための大広間
│   ├── 💎 materials/      # 宝物庫（画像、音楽、フォントなど）
│   │   ├── images/
│   │   └── audio/
│   ├── 📨 letters/        # ふくろう便の郵便室（日付ごとに整理）
│   │   └── 2025-06-23/
│   └── 📦 work-packages/   # ECOモードで「智恵」を受け渡すための作業包
└── 🪄 hw                 # 全てを統べる万能の杖（CLIツール）

コードの核心（途中省略OK）

このスタジオの魂は、いくつかの重要なスクリプトに宿っています。

1. hw – 万能の杖 ユーザーが振るう唯一の杖。ここから全ての魔法が始まります。

# ./hw (一部抜粋)
# ... (関数定義) ...
case "$COMMAND" in
    start)
        log_info "ホグワーツを開設します..."; bash "${SCRIPT_DIR}/start_hogwarts.sh"
        ;;
    order)
        # モードに応じて、フルモードなら全員に、エコモードなら最初の担当者にタスクを渡す
        # ...
        ;;
    letters)
        # 今日の手紙を一覧表示
        # ...
        ;;
    read)
        # 指定されたキャラクターの手紙を読む
        # ...
        ;;
    feedback)
        # 作者の想いを「託宣」として歴史に記録する
        # ...
        ;;
esac

2. start_hogwarts.sh – モードを切り替える世界の扉 フルモードとエコモードで、世界のあり方を根本から変える呪文です。

# ./scripts/start_hogwarts.sh (エコモードのロジック)
if [ "${HOGWARTS_MODE:-full}" == "full" ]; then
    log_info "フルモード: 全キャラクターのAIを常駐させます..."
    # ... 全員のtmuxペインでclaudeを起動 ...
else
    log_info "エコモード（ブリッジモード）: AIは待機状態。指示があるまで起動しません。"
    # ... tmuxペインだけを作成し、claudeは起動しない ...
fi

3. invoke_agent.sh & dispatcher.sh – 智恵の継承システム エコモードの心臓部。dispatcherがログからバトンタッチを検知し、invoke_agentが次のAIを起動させます。

# ./scripts/dispatcher.sh (一部抜粋)
tail -n0 -F "${LOG_DIR}"/*.log | while read -r line; do
    # [HANDOFF]を検知したら...
    if [[ "$line" =~ \[TO:Dispatcher\]\ \[HANDOFF\]\ \[PACKAGE_ID:(.+)\] ]]; then
        # ワークパッケージを検証し、次の担当者を取得
        # ...
        # 次の担当者をinvoke_agent.shで起動
        ./scripts/invoke_agent.sh "$NEXT_AGENT" "$PACKAGE_ID"
    fi
done

ポイント：このスタジオを支える設計思想

• 物語性と実用性の両立: AIをキャラクター化し「手紙」で対話することで、開発体験そのものが楽しくなります。これは、単調な作業におけるモチベーション維持に繋がります。
• 疎結合アーキテクチャ: tmux, シェルスクリプト, ログ監視という枯れた技術の組み合わせが、驚くほど柔軟で拡張性の高いシステムを生み出しました。
• プロンプトによる振る舞いの抽象化: AIの複雑な振る舞いは、全てinstructions/*.mdという自然言語の「教科書」を書き換えるだけで制御できます。
• 二つの動作モード: 全員で議論して進める豪華な「フルモード」と、リソースを節約しつつ一人ずつ知性を繋ぐ「エコモード」。用途に応じて最適なスタイルを選べる設計は、個人開発の強力な味方です。

ユーザーマニュアル：スタジオでの過ごし方

1. スタジオの開設: ./hw start と唱え、世界に命を吹き込みます。
2. 一日の始まり: ./hw letters で、昨夜のうちにAIたちから届いた手紙を確認します。
3. 仕事の依頼: ./hw order "くまのシューティングゲームを作ってほしい" のように、最初の指示を出します。
4. 対話と共同作業:
   • ハーマイオニーから「素材が足りません」という手紙が届けば、shared-workspace/materials/に画像を配置します。
   • スネイプから「このコードは醜悪だ」という挑戦状が届けば、外部のLLM（神託）に相談し、改善案を再びhw orderで指示します。
5. 歴史の記録: プロジェクトについて感じたことや、大きな方針転換は ./hw feedback "..." で「託宣」として記録に残します。

疑似実験：「くまシューティングゲーム」制作の物語

作者: ./hw order "くまが弾を撃つシューティングゲームの設計を頼む"

～ECOモード起動～

ダンブルドア: (最初の指示を受け、マクゴナガルにワークパッケージを渡す)

マクゴナガル: (タスクを分解し、ハーマイオニーに設計を依頼)

ハーマイオニー: (設計を行い、material_requirements.mdと新しいワークパッケージを作成)

dispatcher: (ハーマイオニーの[HANDOFF]を検知し、ダンブルドア（経由で作者）に手紙を生成)

～作者のもとに手紙が届く～

📬 Dumbledore からの手紙 🗓️ 日付: 2025-06-23

作者よ。ハーマイオニーが設計の第一歩を終えたようじゃ。 彼女が言うには、以下の素材が必要とのこと。宝物庫に準備してやってはくれんかの？

• kuma_player.png (プレイヤーキャラ)
• salmon_bullet.png (弾)
• bgm_river.mp3 (BGM)
• se_shoot.wav (発射音)

詳細はshared-workspace/material_requirements.mdにある。準備ができ次第、次の者（ロン）が実装に取り掛かる手筈じゃ。

このように、スタジオは対話的にプロジェクトを進めていきます。

まとめ：あなただけのAIチームを

『ホグワーツ・スタジオ』の旅は、AIとの協業が、単なる「ツールとしての利用」から、**「チームメンバーとの対話」**へと進化しうる可能性を示してくれました。 古典的な技術も、アイデア次第でこれほど豊かでモダンなシステムを構築できるという事実は、我々開発者にとって大きな希望です。

この記事が、あなたの創造の扉を開く、ささやかな鍵となれば幸いです。

さあ、あなたも自分だけのAIチームを作ってみませんか？ 物語は、いつだってお主の一声から始まるのじゃぞ。