Claudeで長時間作業させるハーネス設計|進捗ファイルと機能リスト

Claudeで長時間作業させるハーネス設計|進捗ファイルと機能リスト
📅 公開日: 2026年11月10日🔄 最終更新: 2026年11月11日

長い作業をClaudeに任せるとき、記録の仕組みが無いと、新しい会話のたびに前の作業を忘れた状態から始まります。

Anthropicの公式記事「Effective harnesses for long-running agents」は、この問題に「初回の準備役」と「毎回の作業役」を分けて対処する方法を説明しています。

要点は3つです。進捗を書くファイル、機能の一覧を持つJSON、起動手順をまとめたスクリプトを最初に用意し、毎回1項目ずつ進めます。

この公式記事は2025年11月26日に公開されたもので、新しい発表ではありません。Anthropic Engineeringの公式記事を、2026年11月9日に開いて確認した内容でまとめます。

目次

この記事の読者向け・無料

ChatGPT・Gemini・Claude 仕事別の使い分け実践キット

ChatGPT・Gemini・Claude 仕事別の使い分け実践キットの表紙

中身

  • ChatGPT・Gemini・Claude を仕事別に選ぶ表
  • 目的→機能→入力の許可→比較の順番
  • 有料プランを考える前の確認
  1. 下のボタンから LINE を友だち追加
  2. トークで「AIの使い分け」と送る
  3. ChatGPT・Gemini・Claude 仕事別の使い分け実践キットが自動で届きます

友だち追加は無料です。届いた後はいつでもブロックできます。

LINEで「AIの使い分け」を受け取る

ハーネス設計とは何か

LINEでインスタ大学の受取案内を見る

LINEでインスタ大学の受取案内を見る

インスタ大学の受取案内をLINEで確認できます。

LINEでインスタ大学の受取案内を見る

ここでのハーネス設計は、AIが何度も会話をまたいで同じ作業を続けられるように、記録と手順を周りに用意しておく考え方です。

公式記事によると、エージェントは区切られたセッションで動き、新しいセッションは前に何があったかの記憶を持たずに始まります。

コンテキストウィンドウ(AIが一度に扱える量)には限りがあり、複雑なプロジェクトは1つに収まらないことが多いと書かれています。

出典は公式記事です。

この記事では、公式が説明する仕組みを「ハーネス」と呼びます。公式の記事名に入っている語です。

公式記事は、会話の内容を圧縮する仕組みだけでは足りなかったと述べています。記録を外のファイルに残す設計が、その補いになります。

公式が挙げた2つの失敗と対策

公式記事は、長時間の作業で起きる失敗を、一度に全部やろうとすることと、途中で完了と判断してしまうことの2つに整理しています。

前者では、実装の途中でコンテキストが尽き、半端な状態が記録なしで次のセッションに渡されます。

後者では、機能がある程度できた後、次のエージェントが進み具合を見て、作業が終わったと判断してしまいます。

出典は公式記事の失敗モードの説明です。

公式が挙げた問題最初の準備役の対策毎回の作業役の対策
早い段階で、全体の完了を宣言する仕様から機能リストをJSONで作る1つの機能を選んで取り組む
バグや未記録の進捗を抱えたまま終わるgitのリポジトリと進捗メモを作る進捗メモとgitログを読んで始め、gitコミットと進捗の更新で終える
検証せずに機能を完了とする機能リストを作る十分に確かめてから「passing」にする
アプリの起動方法を毎回調べるinit.shで開発サーバーを起動できるようにするinit.shを読んで始める

この表は、公式記事の対応表を日本語にまとめ直したものです。細かい言い回しは公式記事で確認してください。

初回の準備役と毎回の作業役

最初の1回の初期化エージェントと2回目以降のコーディングエージェントの2役の比較図。
初回と毎回の2役

公式の方式は、最初のセッションだけ環境を整える「初期化エージェント」と、以降のすべてで少しずつ進める「コーディングエージェント」の2役に分かれます。

  • 初期化エージェントは、init.shのスクリプトと、作業の記録を残すclaude-progress.txt、追加したファイルを示す最初のgitコミットを作ります。
  • コーディングエージェントは、以降のセッションで少しずつ進め、次のセッションのために構造化された更新を残します。

公式記事の脚注では、2役の違いは最初のユーザープロンプトだけで、システムプロンプトやツールは同じだと説明されています。

2つのプログラムを別々に作る話ではなく、最初の1回と、2回目以降で指示を変える話です。

出典は公式記事です。

3つのファイルとgitの役割

引き継ぎに使う4つの仕組みの図。進捗ファイル、機能リスト、起動スクリプト、gitの履歴が次のセッションに役立つ。
引き継ぎの4つの仕組み

公式の方式では、進捗ファイル、機能リスト、起動スクリプト、gitの履歴が、記憶を持たない次のセッションへの引き継ぎ役になります。

置くもの入れる内容次のセッションでの使われ方
claude-progress.txtこれまでにエージェントがしたことの記録最初に読んで、直近の作業を把握する
feature_list.json機能の一覧と、それぞれが通っているかどうか未完了で優先度の高い機能を1つ選ぶ
init.sh開発サーバーを起動する手順読んで起動し、基本の確認をする
gitの履歴説明つきのコミット読んで直近の変更を知り、悪い変更は元に戻す

claude-progress.txtは、公式記事で「エージェントがしたことの記録を持つファイル」と説明されています。公式記事に書かれたファイル名どおりに書いています。

gitは、変更を説明つきで記録し、悪い変更を取り消して動く状態に戻すためにも使われると述べられています。

機能リストをJSONにする理由

機能リストは、最初はすべて「失敗」の印をつけた一覧として作り、完了した項目だけを書き換えさせます。

公式記事の例では、claude.aiのクローンを作る作業で、200以上の機能が一覧になっています。各機能の最初の状態は「passes: false」です。

編集を許すのは、passesの欄の状態を変えることだけで、テストの削除や編集を禁じる強い言い回しの指示も入れた、と書かれています。

形式にJSONを選んだ理由について、公式記事は、Markdownより、モデルが不適切に変えたり上書きしたりしにくかったからと説明しています。

出典は公式記事です。

実践用の「ChatGPT・Gemini・Claude 仕事別の使い分け実践キット」を無料で配布しています。LINE で「AIの使い分け」と送ると届きます。LINEで受け取る

毎回のセッション開始手順

毎回のセッション開始の4手順の図。pwdで場所を確認し、gitログと進捗を読み、機能を1つ選び、init.shで起動して動作確認する。
セッション開始の4手順

毎回の作業役は、作業を始める前に、今どこまで進んだかを同じ順で確認します。

公式記事に出てくる手順は、次の4つです。

  1. pwdで、作業しているディレクトリを確認します。
  2. gitのログと進捗ファイルを読み、直近の作業を把握します。
  3. 機能リストを読み、未完了で最も優先度の高い機能を1つ選びます。
  4. init.shで開発サーバーを起動し、新しい機能に着手する前に基本の動作確認をして、壊れた状態が残っていないか調べます。

公式記事は、この手順により、毎回テスト方法を考え直す分のトークンを節約でき、すでにあるバグもすぐ直せると述べています。

出典は公式記事の「Getting up to speed」の節です。

1回に1項目だけ進める

1回に1つの機能だけ進める流れの図。1つの機能に絞り、gitにコミットし、進捗ファイルに要約を書いて引き継ぐ。
1回に1機能の流れ

公式の方式は、1回の作業で1つの機能だけに取り組ませ、終わるたびに状態を整えて引き継ぎます。

公式記事は、一度に1つの機能だけに取り組ませたことが、全部を一度にやろうとする傾向への対策として重要だったと述べています。

1つ終えたら、説明つきでgitにコミットし、進捗ファイルに要約を書かせます。

確認についても、公式記事は、単体テストやcurlで確かめただけで完了とみなす傾向があったと述べています。

そこで、人間のユーザーと同じようにブラウザ自動化ツールで確かめるよう明示すると、性能が大きく良くなったと書かれています。

ただし、ブラウザ標準のアラートの画面は、このツール経由では見えないという制約も挙げられています。

出典は公式記事です。

自分の作業に当てはめる仮の例

公式の例はWebアプリの開発ですが、記録、一覧、起動手順、1回1項目という骨組みは、自分の長い作業にも置き換えて試せます。

次は、この記事が作った「仮の例」で、公式の記述ではありません。

社内の問い合わせ回答集を、Claudeで少しずつ作る場面を想定しています。

ファイル(仮の例)書くこと(仮の例)
claude-progress.txt11/9 返品の質問を5件まとめた。次は配送の質問。表記ゆれの一覧を作成済み
feature_list.json「返品」「配送」「支払い」の各項目に、passes: false か true を持たせる
init.sh回答集のフォルダを開き、検査用のスクリプトを1回実行する

仮の例では、次の会話の最初に「進捗ファイルを読み、機能リストから未完了を1つ選び、検査を実行してから始める」と指示します。

終わるたびに、その項目だけをtrueにして、進捗ファイルに1〜2行足します。

この指示をどこに常に書いておくかは、CLAUDE.mdの書き方の記事で置き場所を確認できます。これはこの記事の提案で、公式記事がCLAUDE.mdに書くよう述べているわけではありません。

会話が長くなったときの整理は、/compactによるコンテキスト管理の記事で扱っています。会話を再開する方法は、セッション管理の記事にあります。

AI×SNSの学び方は、LINEで受取案内を確認できます。

LINEでインスタ大学の受取案内を見る

公式がまだ答えを出していない点

公式記事は、この方式の限界と、これから調べる課題も書いています。

  • 1つの汎用エージェントがよいか、テストや整理などの専門エージェントを組み合わせる構成がよいかは、未解決とされています。
  • 検証は、フルスタックのWebアプリ開発に絞ったものです。
  • 科学研究や金融モデリングなど、他の分野の長時間の作業へ広げられるかは、今後の課題として挙げられています。

出典は公式記事の今後の課題の節です。

専門の役割を分ける考え方は、サブエージェントの使い方の記事で、設定の書き方を確認できます。

よくある質問(FAQ)

Q1. この方式は新しく発表されたものですか。
いいえ。公式記事の公開日は2025年11月26日です。新しい発表ではありません。
Q2. ハーネスを作るには、プログラミングが必要ですか。
公式記事の例は、コードを書くWebアプリ開発です。文章や資料の作業に使うなら、進捗ファイルと一覧の考え方だけを借りて、手作業でも試せます。ただし、この使い方は公式が確認したものではありません。
Q3. 機能リストはMarkdownではだめですか。
だめとは書かれていません。公式記事は、Markdownより、JSONのほうがモデルに不適切に書き換えられにくかったため、JSONを選んだと説明しています。
Q4. 2つのエージェントは、別々のプログラムですか。
いいえ。公式記事の脚注では、違いは最初のユーザープロンプトだけで、システムプロンプト、ツール、ハーネスは同じと説明されています。
Q5. 複数のエージェントに分けたほうが良い結果になりますか。
公式記事は、これを未解決の課題としています。分けたほうがよいとも、悪いとも結論づけていません。

読み終わったら、手元に残す

ChatGPT・Gemini・Claude 仕事別の使い分け実践キット

中身

  • ChatGPT・Gemini・Claude を仕事別に選ぶ表
  • 目的→機能→入力の許可→比較の順番
  • 有料プランを考える前の確認

LINE を友だち追加して「AIの使い分け」と送ると、無料で届きます。

LINEで「AIの使い分け」を受け取る

まとめ

長い作業を続ける鍵は、記憶を持たない次のセッションに、記録と手順を残すことです。

公式記事の方式は、最初に進捗ファイル、機能リスト、起動スクリプト、gitを用意し、毎回1項目ずつ進めます。

始めるときは、小さな作業で、一覧を作り、1項目ずつ確認しながら試してください。

公式記事の公開日は2025年11月26日です。画面や運用は変わることがあるため、公式記事も合わせて確認してください。

AI×SNSの学び方は、LINEで受取案内を確認できます。

LINEでインスタ大学の受取案内を見る

このサイトは株式会社S.Lineが運営しています。記事内の店舗予約・LINE登録・講座の案内には、当社または当社が集客を担当するサービスの広告(PR)が含まれます。
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

株式会社S.Line 代表取締役。偏差値39から起業し、AIとSNSの活用で「普通の人」が成果を出す方法を発信。

目次