ds-context-reset

ds-context-reset

コンテキストが変わっても作業内容がずれないよう、作業の状態はチャットではなくファイルに保存します。

手順

1. 長いタスクの開始時に、リポジトリのルートに次のセクションを含む PROGRESS.md を作成します。
   • Goal：タスク全体の受け入れ確認方法を含め、1〜2 文で記述します。
   • Done：確認済みの手順を、それぞれ証明となるコマンドと結果とともに記載します。
   • Next：残りの手順を順番に記載します。最初の項目には、次に行う具体的なアクションを記載します。
   • Open questions：不明点や、ユーザーの判断待ちの事項を記載します。
   • Key facts：パス、コマンド、バージョン、注意事項、失敗した方法とその理由を記載します。
2. 確認済みの手順ごとに PROGRESS.md を更新します。未確認の内容では更新しないでください。コードと PROGRESS.md を、内容が分かるコミットメッセージで一緒にコミットします。
3. リセットの兆候に注意します。同じ回答を繰り返す、Key facts に記載済みの事実を忘れる、失敗した修正を再試行する、同じファイルを何度も読み直す、またはコンテキストが半分を超えたように感じる場合などです。
4. 兆候が現れたら、現在の手順を完了するか取り消し、作業ツリーを既知の状態にします。
5. PROGRESS.md を、完全な引き継ぎ内容に書き換えます。このファイルとリポジトリだけを読む人が作業を続けられるようにします。雑談は削除し、事実だけを残します。
6. 新しいセッションまたはサブエージェントを開始し、次の指示を1つだけ与えます。「PROGRESS.md と git log -5 を読み、最後の Done 項目の受け入れ確認を実行してから、Next の最初の項目に取り組んでください。」
7. 新しいコンテキストでは、新たな編集を行う前にベースライン確認が通ることを確認します。失敗した場合は、まずそれを修正します。

次の場合は停止します

• 目標の受け入れ確認に合格し、PROGRESS.md のすべての項目が Done になった場合。
• 1つの Next 項目で3回リセットしても進展がない場合。その場合は、ファイルを報告書としてユーザーに確認を求めます。

ルール

• PROGRESS.md には事実と根拠を記載し、誰も確認していない計画は記載しません。
• 150 行程度以内に保ちます。古い Done 項目は、短い要約行にまとめます。
• 秘密情報やトークンは記載しません。
• 新しいコンテキストでは、以前の会話履歴ではなくファイルを読みます。
• Next リストには ds-plan-loop を、失敗した方法の記録には ds-unstick を併用します。