real-work

実作業

計画を、永続的で再開可能な成果物にします。情報源は会話ではなく計画ファイルです。計画ファイルには、実施する作業、完了した作業、その検証方法、デプロイ方法を記録します。今後のどのエージェントでも、事前のコンテキストなしで計画から作業を再開できます。

以下の場合に使用します：現在のセッションを超えて続く可能性がある、複数ステップ／複数セッションにわたる作業を計画する場合。単純で1セッションで完了するタスクでは使用しないでください。

1. まず全容を把握する

スコープを完全に理解するまで、計画を書いてはいけません。双方が漏れなく全容を共有できるまで、ユーザーに徹底的に質問してください。質問しなかった項目は、将来のバグと見なしてください。

• 最初の質問で終わらせず、曖昧さ、前提、未決事項がなくなるまで質問を続けてください。境界条件を掘り下げます：スコープの範囲（対象／対象外）、依存関係、制約、成功基準、データ、環境、デプロイ、障害ケース。
• すべての前提を明らかにし、ユーザーに確認してもらってください。回答によって新たな不明点が生じた場合は、追加で質問し、再帰的に掘り下げてください。
• 具体的な選択肢には AskUserQuestion を使用してください。確認が終わったら、スコープ全体を要約してユーザーに伝え、漏れがないことを確認してから先に進んでください。

2. 計画を書く

リポジトリのルートにある plans/<descriptive-name>.md に保存してください。必要に応じて plans/ を作成してください。以下の自己記述型テンプレートを使用します。

# <Work Title>

<1-2 sentence goal and scope.>

## For Future Agents
As work proceeds: mark checkboxes `- [x]` as items complete; when a phase is done,
set its status to `Complete` and write its **Phase Summary** (what was done, key
decisions, anything needed to continue with zero context); run the phase's
**Verification Plan** and record the result before moving on. When all phases are
done, fill in **Final Recap** and **Deployment Plan**.

## Phase 1: <Title>
Status: Not started   

- [ ] <concrete, actionable item>
- [ ] <concrete, actionable item>

### Verification Plan
- <command/check the agent can run autonomously, with expected result>

### Phase Summary
_(write when phase completes)_

## Phase 2: <Title>
Status: Not started
- [ ] <actionable item>
### Verification Plan
- <autonomous check>
### Phase Summary
_(write when phase completes)_

## Final Recap
_(write when all phases complete: summary of the entire piece of work)_

## Deployment Plan
_(write when all phases complete: step-by-step deployment instructions)_

よくある間違い

• 曖昧な項目 — 各チェックボックスには、「支払い機能を改善する」のようなテーマではなく、「PaymentClient.Charge に再試行ロジックを追加する」のような具体的なタスクを記載します。
• 自律的に検証できない項目 — 「手動でテストする」ではなく、実行可能なコマンドと期待される出力を記載します。
• 誤った保存場所 — 必ずリポジトリルートの plans/ フォルダーを使用します。
• 要約の先行記入 — フェーズの要約、振り返り、デプロイ計画は、該当する作業が実際に完了するまでプレースホルダーのままにします。