引き継ぎメモの書き方|後任は、次のセッションの自分になる
前の判断の理由は、次に続きをやるときにはもう手元に残っていない。
困るのは記憶力ではなく、書き残し方だと思う。
寿命の違う情報を三つに分けると、次の自分が迷わなくなる。
この技術ブログを毎日書かせている仕組みを、週をまたいで直し続けることがある。
なぜその設計にしたのか、手を動かしているあいだは頭の中に理由がある。
でも次に続きをやるときには、その理由はもう手元に残っていない。
正確には、僕が忘れるだけの話じゃない。
毎日の記事はAIエージェントに任せていて、セッションが変わればエージェントの記憶もリセットされる。
前の判断を次のセッションに引き継ぐには、どこかに書いておくしかない。
ひとつのメモに全部書くと、すぐに読めなくなる
「このサイト専用のメモ」を一つ作って、思いついたことを片っ端から足していく。
DBのテーブル名、投稿のルール、過去に踏んだ落とし穴、今日やること。
ジャンルを分けずに、時系列でただ積んでいく。
最初はたいていこうなると思う。
続けるうちに、そのメモは読み切れない量になる。
新しい作業を始めるたびに最初に読むのがこのメモなので、長くなるほど読み込みに時間がかかる。
もっと困るのは、古い情報と新しい情報が同じ重みで並ぶことだ。
「本番の設定はこれ」という一生変わらない話と、「今日はこの記事まで書いた」という今日限りの話が、同じ行の並びに入ってしまう。
どれも「メモ」だけど、寿命がまったく違う
中身を分けてみると、書く内容は三種類ある。
ひとつめは、いつまでも変わらないルール。
「投稿の本文に生の改行を入れない」「本番へ反映する前に必ずローカルで検証する」のような、この先ずっと守るべき決めごとだ。
ふたつめは、このサイトだけの事実。
「技術ブログはカテゴリを順番に回している」「本番とローカルで採番がずれることがある」のような、他の案件には持っていけないけれど、このサイトではずっと正しい情報だ。
みっつめは、今この瞬間の作業の状態。
「今日はここまで書いた」「次はこの分岐を試すつもりだった」のような、数日で役目を終える情報だ。
これを同じ場所に同じ扱いで書くのが、そもそもの失敗だと思う。
みっつめの「今の状態」は放っておくと古くなって嘘になるのに、ひとつめの「ずっと変わらないルール」と並んでいると、どちらも同じくらい信用できる情報に見えてしまう。
三つの引き出しに分ける
今は、書く場所を三つに分けている。
ルールは、作業のたびに必ず読み込まれる場所に置く。
量が増えすぎないよう、本文はできるだけ書かず「詳しくはこのメモを見る」という参照だけを残す。
このサイト固有の事実は、案件ごとのメモに置く。
DBの構成、過去に決めた方針、踏んだ落とし穴。
時間が経っても変わらない前提なので、消さずに育てていくメモになる。
今の作業の状態だけは、別の場所に書く。
作業がひと区切りついたときに、判断の理由と残っている課題を書き残す。
このメモは、次のセッションが読んだら役目を終える前提で書く。
触ったファイルの一覧だけを書いても意味がなくて、「なぜその設計にしたか」「どこでつまずいたか」まで書かないと、次の自分は同じ場所でまた迷うことになる。
自動で残る要約だけでは足りない
セッションが長くなると、それまでのやり取りが自動的に一つのファイルへ圧縮されて保存される仕組みがある。
便利なので、それだけで十分だと思いたくなる。
ただ、自動の要約には「どのファイルを触ったか」は残っても、「なぜその案を見送ったか」までは残りにくい。
見送った理由を書かずに次のセッションへ渡すと、次は同じ案をもう一度検討することになりやすい。
だから僕は、自動の要約はあくまで補助で、正本は手で書く引き継ぎメモのほうだと決めている。
これはAIに限った話ではないと思う
ここまで書いてきたのは、AIエージェントに仕事を任せている僕の運用の話だった。
ただ、分け方そのものは、人間同士の引き継ぎにもそのまま使えると思う。
「これはずっと変わらないルールか」「この現場だけの事実か」「今日で役目を終える話か」。
メモを書く前にこの三つのどれかを自分に聞くだけで、後から読み返す人が、どこまで信じていい情報なのかを迷わなくなる。
引き継ぎ書が読みにくいのは、たいてい文章の書き方のせいじゃなくて、寿命の違う情報が同じ棚に並んでいるせいだと、今は思っている。
次の自分は、他人だと思って書く
このブログの仕組みは、これからもどこかを触り続けると思う。
今の自分が何を考えていたか、次の自分はもう覚えていない。
それでいいと思うようにしている。
覚えていない前提でメモを書いておけば、次の自分は他人の引き継ぎを受け取る後任として、迷わず続きから始められる。
ほかにも書いています
受託・note・スタンプこういう仕組みを作る相談を受けています
毎日の更新・データ集め・集計の自動化/3万円〜収益がいくらだったか、どの施策が外れたか
note / 個人の視点で掘り下げていますスタンプラリーに挑戦する
行った場所は、現地チェックインで記録に残せます※受託の相談とnoteは、運営者が個人で受けている・書いているものです。
