~/developにAIエージェント開発母艦

出発点は単純な好みだった。WebStormやPHPStormでのIDE中心の開発から、Claude Codeを横に置いたターミナル中心の開発へ移りたかった。だがそれだけでは足りない。仕事は複数のリポジトリを行き来するタイプで、リポジトリごとに環境を整えるだけではカバーできなかった。欲しかったのは、エージェントがワークスペースを起点に全体像を読み、必要なリポジトリをまたいで調査・実装・検証できる状態だ。

~/developの下に置かれた要素は、エージェント向けの文脈、人間向けのメモ、スクリプトが混ざっている。CLAUDE.mdには個々の実装手順を大量に書くのではなく、エージェントが詰まりがちな判断材料を入れる。リポジトリの位置と依存関係、ローカルドメインとリモート開発環境の違い、ポートとDBトンネルの扱い、issue・PR・レビュー依頼のルール、作業の開始と終了の対話プロトコルだ。REPO_MAP.mdはリポジトリ横断の関係を整理し、変更が複数リポジトリにまたがるとき最初に読めば調査範囲を絞れるようにする。

筆者はGitHub Copilotのクラウドエージェントのようなissue駆動の自動化とも対比する。issueで作業が始まり、PRが作られ、人間がレビューする方式だ。魅力的だとしつつも、何を変え何を変えず、どのリポジトリが関わり、何をもって完了とするかという初期定義の質に強く依存する。曖昧なままだとエージェントはもっともらしいものを返すが、もっともらしいは期待通りではない。この構成では探索と方針決めは対話に残し、エージェントに任せる範囲こそがワークスペースの真の試金石だと筆者は見る。派手なオーケストレーターではなく、実際の状態を確認できるコマンドと、失敗時に巻き戻せる記録が要るのだ。