structured-project-execution

構造化されたプロジェクト実行

進捗をコンテキストの喪失、セッションの境界、エージェント間の引き継ぎを越えて維持できるよう、ディスク上の単一の信頼できる情報源を使って大規模な作業を進めます。基本は、計画 → 進行中のタスクは1つ → 検証 → 記録 → 繰り返しです。

使うタイミング

複数フェーズにわたる機能や移行、複数のセッションにまたがる作業、別のエージェントや人が引き継ぐ可能性のある作業に使います。1回で完了するタスクでは省略してください。記録の手間が得られる効果を上回ります。

実行ファイル

リポジトリのルートに PROGRESS.md（またはプロジェクトで定められたファイル）を維持します。

# <Project> — Progress

## Goal
<one paragraph: what done looks like>

## Plan
- [x] Phase 1: <deliverable> — verified by <check>
- [ ] Phase 2: <deliverable> — verified by <check>
- [ ] Phase 3: ...

## Now
<the single task currently in flight>

## Decisions
- <date>: chose X over Y because <reason>

## Blocked / Open
- <question or blocker, with what's needed to unblock>

このファイルが作業の取り決めです。作業の一環として更新し、後回しにしないでください。

反復手順

1. 計画 — 検証可能な成果物で終わるフェーズに分解します。最もリスクの高いフェーズを先に進めます。
2. 1つ選ぶ — ## Now に設定するタスクは必ず1つにします。並行して未完了の作業を進めないでください。コンテキストがリセットされると、それらの進捗を維持できません。
3. 実行 — フェーズを満たす最小限の範囲を実装します。
4. 検証 — フェーズで定めた確認（テスト、ビルド、手動での再現）を実行します。「完了したように見える」だけでは不十分です。確認に合格する必要があります。
5. 記録 — チェックボックスにチェックを入れ、## Now をクリアし、決定事項や新たなブロッカーを記録します。コミット可能な状態にします。
6. 計画に戻って繰り返します。現実が計画と異なる場合は、計画を立て直します。

再開（新しいセッション／引き継ぎ）

まず PROGRESS.md を読みます。## Now と最後の未チェックボックスが、再開する場所を正確に示します。## Now が空でなければ、そのタスクは作業の途中で中断されています。先に状態を再検証してください（部分的に完了している可能性があります）。

品質基準

• チャット履歴がなくても、誰でも PROGRESS.md だけで作業を再開できます。
• チェック済みのボックスはすべて、定めた確認によって検証されています。検証済みと決めつけてはいけません。
• 一度に進行中にできるタスクは最大1つです。
• 決定事項とその理由が記録されているため、再び議論し直す必要がありません。

アンチパターン

• チャットだけで計画する — コンテキストのリセットで失われ、引き継ぎにも使えません。
• 検証を実行せずにフェーズを完了扱いにする。
• 5つのフェーズを同時に「進行中」にする → 中断後に状態を復元できません。
• 理由を書き残さなかったため、過去の決定をもう一度導き直す。
• PROGRESS.md の更新を「後で」にする — その「後で」は、コンテキストを失った後です。