メインコンテンツへスキップ
見出し画像

会話が変わると AI は忘れる。毎回書いている「引き継ぎ書」の中身

    今回の話

    • AI は、会話が長くなると前半の内容を要約して忘れていきます。新しい会話を始めれば、ゼロからのスタートです

    • だから僕は、アプリごとに「引き継ぎ書」を用意して、作業の区切りごとに必ず更新しています

    • 人間の仕事の引き継ぎと、考え方はまったく同じでした


    AI は「記憶喪失」になる

    Claude と長く作業していると、あることに気づきます。

    さっき決めたことを、忘れている。

    AI には、一度に覚えていられる量に上限があります。僕が使っている Claude Code では、会話が長くなって上限に近づくと、それまでの会話が自動で要約されます。そのとき、細かいところが抜け落ちていきます。新しい会話を始めれば、前の会話の内容は基本的に覚えていません。

    最初はこれで何度も困りました。

    • 前に「こうしよう」と決めた方針を忘れて、別のやり方で作り始める

    • 一度直したバグの原因を忘れて、同じ間違いを繰り返す

    • 「このアプリって、どういう仕組みだっけ?」から説明し直しになる

    解決策:引き継ぎ書を書く

    そこで始めたのが、アプリごとの引き継ぎ書です。前回紹介した「アプリごとのルールブック(CLAUDE.md)」が、そのまま引き継ぎ書を兼ねています。

    CLAUDE.md は、アプリの作業フォルダに置いてある、ただのテキストファイルです。この名前のファイルは、新しい会話を始めると Claude Code が自動で読み込んでくれます。別の名前のファイルに書いた場合は、自動では読まれないので、CLAUDE.md に「まず〇〇を読むこと」と一行書いておきます。そして、作業の区切りごとに、Claude 自身に更新してもらいます。

    最初の1枚も、自分で書く必要はありません。「このアプリの引き継ぎ書を作って」と頼むだけで、Claude がフォルダの中身を読んで、たたき台を作ってくれます。

    中身は、たとえばこんな感じです。

    • 最初に必ずやること:開発用のサーバーが動いているかの確認など

    • このアプリは何か:目的、使っている技術、関係するサービス

    • やってはいけないこと:本番のデータベースを取り違えない、など

    • これまでに起きたバグと直し方

    • いまどこまで進んでいて、次に何をやるか

    特に大事なのは、最後の「次に何をやるか」です。ここがあるだけで、新しい会話でも「じゃあ、続きをやろう」とすぐに再開できます。

    実物は、こんな感じです。0-4 で紹介した練習受付アプリの引き継ぎ書の、冒頭の部分です(データベースの ID などは伏せています)。

    # 引き継ぎ書 — 練習受付アプリ
    
    ハンドボールサークルの練習参加受付 Web アプリ。
    新しい会話はこのファイルが起点(毎回自動で読まれる)。
    ここには「毎回必要なこと」だけを置く。
    
    【どこに何があるか】
    - 守るルール・接続先・いまの状態・次にやること → このファイル
    - 画面ごとの仕様・決めたこと → docs/reference.md
    - いつ何を作ったか・不具合の経緯 → docs/history.md
    
    ## 1. 最重要:データベースの接続先(取り違え厳禁)
    - 対象は ID「●●●●」のみ。名前で選ばない
    - ID「▲▲▲▲」は組合アプリの本番 → 絶対に触らない
    
    ## 2. いまの状態・次にやること(最終更新 2026-10-07)
    - 本番稼働中。全体公開は 2026-09-23(チームの LINE で周知)
    - 次にやること:
      1. 済:アクセスの分析2回目。初参加フォームを開いた13人中、申し込んだのは2人
      2. 未着手:初参加の人へのアプローチ(初参加9人中、次も来たのは1人)
      3. 夜の予備の送信で LINE だけ失敗したら、文面を仕事用のチャットに送る

    上から順に、「このファイルは何か」「ほかの情報はどこにあるか」「絶対に間違えてはいけないこと」「いまどこまで来ていて、次に何をするか」が並んでいます。新しい会話の Claude は、これを読むだけで「次は初参加の人へのアプローチだな」と分かります。

    画像
    引き継ぎ書のサイクル

    人間の引き継ぎと同じだった

    これ、会社の仕事の引き継ぎとまったく同じなんですよね。

    異動や休職で担当が変わるとき、ちゃんとした引き継ぎ書があれば、後任の人はすぐに動けます。逆に、口頭だけで引き継ぐと、「前任者しか知らないこと」が抜け落ちて、同じトラブルがまた起きます。

    AI は、毎回、前任者の記憶がない後任者です。だからこそ、引き継ぎ書の質がそのまま作業の質になります。

    引き継ぎ書を書くのも AI

    ここで大事なポイントがあります。引き継ぎ書を書いているのは、僕ではなく Claudeです。

    作業の区切りで「今日やったことを引き継ぎ書に反映して」と頼むと、Claude が自分で書き足してくれます。僕がやるのは、それを読んで、おかしなところがないか確認するくらいです。

    さらに Claude Code には、会話をまたいで大事なことを覚えておく「メモリ」という仕組みもあります。「このアプリの引き継ぎ書はここにある」「このデータベースは取り違えやすいから注意」といった、目次のようなメモを残しておけます。たとえるなら、引き継ぎ書は本そのもの、メモリは「どの棚にどの本があるか」の案内板です。

    【つまずき】引き継ぎ書が古くなっていた

    ただ、失敗もありました。

    作業の勢いで引き継ぎ書の更新をさぼると、書いてある内容と実際のアプリがずれていきます。そうすると、新しい会話の Claude は古い情報を信じて作業を始めてしまうんです。

    たとえば、練習受付アプリの公開 URL を、仮の名前から正式な名前に変えたときのことです(3-9 で詳しく書きます)。当時の引き継ぎ書は、CLAUDE.md と、もう1つの引き継ぎ用ファイルの2つに分かれていて、同じことが両方に書いてありました。新しい URL を書き足しても、古い URL が書かれた段落があちこちに残ったまま。どちらが正しいのか分からなくなりました。

    困ったのは、大きな事故ではなく、地味なずれでした。指示したのにまた少しずれる。「前もその話したよね」という指示の繰り返しが増える。なんとなく、あちこち散らかっている感じがする。実害は大きくないけれど、ちょこちょこ起きて、地味にストレスがたまっていきました。

    気づいたきっかけは、ほかの人の note でした。AI に渡しているルールを半分に減らして整理した、という記事を読んで、「うちのも、これかもしれない」と。Claude に「この記事を読んで、うちの改善案をちょうだい」と頼んだら、引き継ぎ書が長すぎる、という答えが返ってきました。

    原因は、引き継ぎ書が長くなりすぎていたことです。毎回足していくだけで、消したり整理したりしていなかったので、練習受付アプリの CLAUDE.md は約 50KB、組合アプリのほうは 563 行まで膨らんでいました。

    そこで、引き継ぎ書を3つに分けました。

    • CLAUDE.md:毎回必要なことだけ(守るルール・接続先・いまの状態・次にやること)

    • docs/reference.md:調べるときに見る仕様や、決めたことの理由

    • docs/history.md:いつ何をしたかの記録。古い記述は消さずに、原文のままここへ移す

    組合アプリの CLAUDE.md は 563 行から 221 行に、練習受付アプリは約 50KB から約 14KB になりました。冒頭には、上の実物にあるような「どこに何があるか」の案内を置いて、「最新の状態はこのファイルが正しい」と書いています。古い記述と新しい記述が、ぶつからなくなりました。

    振り返ってみると

    • AI は忘れる。それを前提に、覚えておいてほしいことはファイルに残す

    • 引き継ぎ書は作業の区切りごとに更新する。後でまとめてやろうとすると、必ずずれる

    • 書くのは AI、確認するのは自分

    「AI に何を覚えておいてもらうか」を設計するのは、けっこう企画っぽい仕事だなと思っています。


    画像
    まとめ

    次回:明日は番外編を1本はさみます。相棒の AI に、これまでの会話ログを全部読ませて「僕ってどんな人?」と聞いてみた話です。本編の続き(Vercel、Supabase、Resend の役割)は、その次に。


    感想や質問、「こういうのも AI で作れる?」という相談も、コメントで気軽にどうぞ。記事のネタにさせてもらうかもしれません(笑)
    連載の記事は、テーマごとにマガジンにまとめています。

     
     
    本業は都内の会社で新規事業の企画。エンジニアではないけれど、AI(Claude)といろんなアプリを作っています。組合の連絡アプリ「Unite」、ハンドボールの記録「HandLog」など、だんだん実際に使われるものが増えてきました。その記録と、つまずいた話を書いています。

    あなたへのおすすめ