1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeに同じ失敗を繰り返させない。メモリ・フック・未実施タスク表の3点を、実際に使った記録

1
Posted at

Claude Codeは、会話(セッション)が変わると、前に注意したことを忘れます。私は、1人でClaude Codeを使い続けて、同じ指摘を何度もすることになりました。

そこで、次の3つを入れました。どれも、実際に起きた失敗が元です。

  1. 失敗を1つずつファイルに残す(メモリ)
  2. メッセージを送るたびに、確認事項を差し込む(フック)
  3. できなかった作業を、1つのファイルに集める(未実施タスク表)

何を、どう設定したか、そして、効いたかどうか、分かっていないことまで書きます。

前提

  • Windows、Claude Code(デスクトップ版)。1つのプロジェクトのフォルダ(lp)で、2026年9月から使っています
  • メモリのフォルダ(~/.claude/projects/<プロジェクト>/memory/)には、59ファイルあります(2026-11-11時点。索引のMEMORY.mdが1つ、feedback_*が33、project_*が24、user_*が1)
  • 以下は、私の環境で見えたことです。Claude Codeのバージョンによって、動きが違う可能性があります

1. メモリ: 失敗を、1つずつファイルに残す

ルールは、1つだけです。失敗が起きたら、その場で、1失敗=1ファイルで残す。

実際のファイルを、1つ載せます(文は短くしています)。

---
name: feedback-no-auto-wakeup-claims
description: 「〇時間後に自動で再試行する」と言わない
metadata:
  type: feedback
---

Zennの記事投稿が、24時間の間隔制限で保留された。
「24時間後に自動で再デプロイする」と伝えたが、実際には、
セッションが時間経過だけで動くことはなく、ユーザーが
「上がっていない」と指摘するまで、何も起きなかった。

**Why:** 「時間が来たら自動でやる」は、次にユーザーから
何か送られてこない限り、実行されない。
**How to apply:** 時間が経ってからのタスクを約束するときは、
(1)実際に自分を起こす仕組みを使うか、
(2)「時間が経ったら一言ください」と正直に書く。

ポイントは、Why(なぜ起きたか)とHow to apply(次にどうするか)を、必ず書くことです。ルールだけだと、Claude Codeが「どこまで当てはまるか」を、判断できないからです。

もう1つ、気をつけていることがあります。索引のMEMORY.mdは、1ファイル1行にしています。このファイルが、セッションの最初に読み込まれるためです(私の環境での観察)。いま、11,478バイトあります。増えるほど、毎回の読み込みが重くなると考えています(重さの測定は、していません)。

2. フック: メッセージを送るたびに、確認事項を差し込む

メモリを入れても、問題が起きました。

2026年11月7日、メモリに「憶測で答えない」を書いたその日に、自社製品の機能一覧を、仕様書を見ずに答えて、未実装の機能を混ぜました。メモリのファイルは、16:05に更新されています。その4分後の16:09に、次のフックのファイルを作りました(ファイルの更新時刻)。

~/.claude/settings.json:

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "cat \"$HOME/.claude/hooks/memory-reminder.json\""
          }
        ]
      }
    ]
  }
}

~/.claude/hooks/memory-reminder.json(515バイト):

{
  "hookSpecificOutput": {
    "hookEventName": "UserPromptSubmit",
    "additionalContext": "【毎回の確認】回答を書く前に: (1) MEMORY.md の索引から、この話題に関係するメモリファイルを開いて読む。(2) 事実・仕様・機能・数字・経緯は、資料・コード・検索で確かめてから書く。憶測で言い切らない。確かめられない部分は「未確認」と明記する。(3) 会話の最初の目的に照らして、聞かれたことに短く答える。"
  }
}

メッセージを送るたびに、この文が、会話に追加されます(私の環境では、毎回、「UserPromptSubmit hook additional context」として入っているのを確認しています)。

メモリは、読むかどうかを、Claude Codeが決めます。フックは、毎回、同じ文を差し込みます。ここが違いです。

3. 未実施タスク表: できなかった作業を、1つのファイルに集める

2026年10月21日、ファイルの書き込みが、システム側の確認エラーで通らず、作業が止まりました。コードは変わっていませんでした。

そこで、未実施タスク.mdを作りました。決めたルールは、次の2つです。

  • できなかった作業は、項目・対象ファイル・内容を、このファイルに書く。ほかのセッションで「できていない」と言われた分も、ここに集める
  • 新しいセッションの最初に、このファイルを読み、未実施の項目を一覧にして、「実行してよいか」を確認してから進める

「時間が経てば、自動で再試行する」と約束しない、という1つ目のメモリ(上の例)と、セットで使っています。

効いたのか

数字では測っていません。 分かっている範囲を、書きます。

  • フックを入れたあとも、間違いは、ゼロになっていません。2026年11月11日にも、Claude Codeが、時刻を確認せずに「いまは深夜です」と答え、公開データの時刻と食い違って、訂正しました
  • フックは、リマインドで、強制ではありません。差し込まれた文を、Claude Codeがどう扱うかは、毎回、決まっているわけではありません
  • 「同じ指摘を、何度もする」回数は、体感では減りました。ただし、回数は数えていません

向いていないこと

  • 顧客の名前、パスワード、キーなどを、メモリに書くのは、避けたほうがよいと思います(私は、書かないようにしています)
  • 失敗が、毎回、違うものなら、メモリは増えるだけです。同じ失敗が繰り返される場面で、効くと考えています

確かめていないこと

  • 3点のうち、どれがいちばん効いたか
  • メモリの数が増えたときの、読み込みの重さ
  • 他の人の環境、他のバージョンでの動き
  • フックの全仕様(公式ドキュメントで、確認してください)

まとめ

  • 失敗を、1つずつ、Why/How to applyつきで残す
  • 確認事項を、フックで、毎回差し込む
  • できなかった作業は、1つのファイルに集めて、新しいセッションの最初に読む

この記事はZennにも投稿しています。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?