parallel-agents

並列エージェント

共有ファイルで、担当が独立した作業同士が衝突しないようにします。並行作業や、これまでの衝突履歴から必要だと判断できる場合に、構造を変更します。

• 独立した動作について、有用な担当境界を作れる場合は専用のファイルにします。共有レジストリへの変更は最小限にします。1 行の登録を実現するだけのために、まとまりのあるモジュールを分割しないでください。
• 共有リストはマージしやすい形にします。1 行につき 1 項目とし、挿入順を安定させ、無関係な再フォーマットは避けます。生成ファイルとロックファイルは再生成します。
• 繰り返し衝突が起きる箇所は、分割する前に調査します。構造の移動と動作の変更の両方が求められる場合は、それぞれを分けて行います。
• エージェント向けドキュメントは簡潔に保ちます。作業上の合意事項、分かりにくい制約、有用なセットアップや確認の手順を記載します。モジュールの詳細は、そのモジュールの担当箇所に記載します。

参考資料

タスクに関連する参考資料のみを読みます。

• one-feature-one-file.md：並行して機能を開発する場合のファイル境界の選び方。
• mergeable-edits.md：共有レジストリ、生成ファイル、または競合するブランチの編集方法。
• hotspot-audit.md：監査や構造の修正を依頼された場合に、衝突が集中する箇所を測定する方法。
• doc-gardening.md：エージェント向けの指示のメンテナンスや、重複ドキュメントの削減方法。