tmuxとMarkdown仕様による並列コーディングエージェント

マヌエル・シッパーは、tmux、Markdownファイル、bashエイリアス、6つのスラッシュコマンドを使用した軽量なセットアップで並列コーディングエージェントを実行しています。これらはサブエージェントプロファイルやオーケストレーターを使用しないバニラエージェントで、tmuxウィンドウごとに役割命名規則を採用しています：Planner（Markdown仕様書を作成）、Worker（完成した仕様書から実装）、PM（バックログ整理とアイデアダンプ）。

Feature Designシステム

ほとんどのコード作成は、Feature Designs（FDs）と呼ばれる完成した仕様書から行われます。FDは以下の内容を含むMarkdownファイルです：

• 解決すべき問題
• 検討されたすべての解決策とそれぞれの長所・短所
• 更新するファイルを含む実装計画を伴う最終的な解決策
• 検証手順

このシステムを採用した後、シッパーは4〜8つのエージェントで並行作業が可能になりました。8エージェントを超えると意思決定の質が低下します。このシステムは、300以上の仕様書を持つ1つのプロジェクトで手動で構築され、その後、任意のリポジトリにセットアップをブートストラップする/fd-initコマンドを使用して新しいプロジェクトに移植されました。

FD追跡とライフサイクル

各FDには番号付きの仕様書ファイル（FD-001、FD-002...）が割り当てられ、すべてのFDにわたるインデックスで追跡されます。ファイルはdocs/features/に保存され、8つのステージを経ます：

• Planned: 特定済み、設計前
• Design: 解決策を積極的に設計中
• Open: 設計完了、実装準備完了
• In Progress: 現在実装中
• Pending Verification: コード完成、実行時検証待ち
• Complete: 動作検証済み、アーカイブ準備完了
• Deferred: 無期限延期
• Closed: 実施しない

スラッシュコマンド

6つのスラッシュコマンドが完全なライフサイクルを処理します：

• /fd-new: アイデアダンプから新しいFDを作成
• /fd-status: インデックスを表示：アクティブ、検証待ち、完了したもの
• /fd-explore: セッションをブートストラップ：アーキテクチャ文書、開発ガイド、FDインデックスを読み込み
• /fd-deep: 4つの並列Opusエージェントを起動して困難な設計問題を調査
• /fd-verify: コードを校正し、検証計画を提案し、コミット
• /fd-close: FDをアーカイブし、インデックスを更新し、変更履歴を更新

すべてのコミットは対応するFDに関連付けられます（例：「FD-049: 増分インデックス再構築を実装」）。変更履歴はFDが完了するにつれて自動的に蓄積されます。

FDファイルの例

FD-051: マルチラベル文書分類
Status: Open
Priority: Medium
Effort: Medium
Impact: 下流フィルタリングのリコール向上

問題
受信文書には単一のカテゴリラベルが付与されますが、多くの文書は複数のトピックにまたがります。分類器が単一の最適適合を強制するため、下流フィルターは関連文書を見逃しています。
解決策
単一ラベル分類をマルチラベルに置き換え：

LLMを使用してカテゴリごとの信頼度スコアを割り当て。
0.90以上の信頼度を持つすべてのラベルを受け入れる。
曖昧なスコア（0.50-0.90）の場合、数ショット例を使用した第2のLLMパスを実行して確認。
下流クエリが柔軟に閾値を設定できるよう、すべてのラベルとスコアを保存。

変更するファイル

src/classify/multi_label.py（新規：LLMベースのマルチラベルロジック）
src/classify/prompts.py（新規：曖昧なケースのための数ショットテンプレート）
sql/01_schema.sql（スコア付きdocument_labelsテーブルを追加）
sql/06_classify_job.sql（新規：取り込み後のスケジュール分類）

検証

ステージング文書テーブルで分類器を実行
操作ログにエラーがないことを確認し、ヘルスチェックを実行
スポットチェック：既知のマルチトピックコンテンツを持つ文書が期待されるラベルを持つことを確認
テストを実行し、下流フィルターが信頼度閾値を尊重することを確認

システム初期化

任意のリポジトリで/fd-initを実行すると：

• CLAUDE.md、パッケージ設定、gitログからプロジェクトコンテキストを推論
• ディレクトリ構造を作成（docs/features/、docs/features/archive/）
• プロジェクトにカスタマイズされたFEATURE_INDEX.mdを生成
• FDテンプレートを作成
• 6つのスラッシュコマンドをインストール
• FDライフサイクル規約をプロジェクトのCLAUDE.mdに追加

作成されるファイルには、docs/features/FEATURE_INDEX.md（機能インデックス）、docs/features/TEMPLATE.md（FDファイルテンプレート）、docs/features/archive/（アーカイブディレクトリ）、CHANGELOG.md（Keep a Changelog形式）、FDシステムを含むプロジェクト規約を記載したCLAUDE.mdへの更新が含まれます。