Claude Code長期プロジェクト運用の実践セット|Phase・進捗記録・/clear後の復元
Claude Codeで数日から数週間かかる作業を進めるときの、開始からPhaseの完了、会話の切り替え、/clear後の状態の復元までを、そのまま使える依頼文とチェックリストにまとめた実践セットです。
進め方の考え方は、無料のWeb記事Claude Codeで長期プロジェクトを進める方法で説明しています。このnoteは、その流れを自分の作業でそのまま回せるように、依頼文とチェックリストの形にしたものです。
この実践セットを作った理由と、決めていること
AI仕事ラボでは、サイトの構築や運用をClaude Codeに任せながら、作業をPhaseに分けて進めています。たとえば、別のプロジェクトをこのサイトにまとめる作業は、U1からU10までのPhaseに分け、9月26日から10月3日にかけて進めました。
区切りでは、進み具合の記録を更新し、テストとコミットで状態を確定してから次へ進む決まりを、記録のファイルに書いています。新しい会話では、記録とGitの状態を読み直してから再開します。
この流れは毎回ほぼ同じです。ただ、依頼の文面をその場で組み立てると、確認の順番や項目がそろいません。そこで、決まった流れをそのまま渡せる依頼文と、抜けを防ぐチェックリストにまとめました。
長期プロジェクトで手間がかかるところ
各Phaseの始めに、範囲と終わりの条件をClaude Codeとそろえる
区切りごとに、記録・テスト・コミットを同じ順番で行う
会話を切り替える前に、次の会話で必要な状態がそろっているかを確かめる
新しい会話で、記録と実際の状態を照合してから再開する
どれも1回ごとの手間は小さいものの、Phaseのたびに同じ依頼を書き直すことになります。
Web記事との違い
Web記事(無料): なぜPhaseで区切るのか、区切りで何をするのか、/compactと/clearの違い、再開の考え方と、代表的な依頼文2つ。考え方を理解するための記事です
このnote(有料): Web記事の流れを、開始から完了までの7段階の完成版の依頼文と、5種類のチェックリストにしたもの。置き換え表に自分のプロジェクトの名前やファイルを入れれば、そのまま使えます
Web記事の説明文や依頼文は、このnoteに写していません。Web記事を読まなくても使えますが、考え方から知りたい場合は先にWeb記事をお読みください。
このnoteでできるようになること
プロジェクトの始めに、運用のルールとPhaseの分け方をClaude Codeと合意する
Phaseの開始・途中・完了で、毎回同じ確認をする
記録の更新・ステージ・全件テスト・コミットを、決まった順番で行う
/compactと/clearのどちらを使うかを、チェックで判断する
/clearの後、記録と実際の状態を照合してから次のPhaseを始める
含まれるもの・含まれないもの
含まれるもの:
完成版の依頼文10本(段階ごとの7本と、うまくいかないときの3本)。1本の依頼文は1つのコードブロックにまとめてあり、まとめてコピーできます
置き換え表(最初に埋める8項目)
チェックリスト5種類(Phaseの完了・会話を切り替える前・/compactを選ぶとき・/clearを選ぶとき・プロジェクトの完了)
確認に使うGitのコマンドの説明(実行する場所・読み取りか変更か・想定する結果・次へ進んでよい条件)
架空のプロジェクトでの使い方の例
含まれないもの:
テストの書き方やテストコードの作り方
本番サーバーの操作(権限・バックアップ・停止条件など)
CLAUDE.mdの書き方の解説(別のWeb記事で扱っています)
特定の言語やフレームワークに依存する手順
対象の読者と、使う前の注意
対象の読者は、Claude Codeを使っていて数日以上かかる作業を進めている人、Gitでコミットする操作を使っている人です。
依頼文はどれも、ファイルを変える前に報告して確認を待つ形にしています。確認を飛ばす形に書き換えないでください
/clearはClaude Codeが自分で実行するコマンドではありません。依頼文は、切り替えてよい状態かどうかを報告して止まる形にしています
/clearと/compactの説明は、2026年10月4日時点のClaude Codeの公式ドキュメントで確かめたものです。仕様は変わることがあります
ここから先は、置き換え表、段階ごとの依頼文7本、チェックリスト5種類、うまくいかないときの依頼文3本、確認に使うGitのコマンドの説明、架空のプロジェクトでの使い方の例です。
