AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す
永続メモリ+引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。
約1.8万トークンの節約 (API料金換算で約27円分)。 要件定義・技術調査・試行錯誤ぶんのトークンがまるごと不要になります。※ 出品者申告とレビューに基づく推定値。モデル・タスク内容により変動します。
この巻物について
「AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す」は、AIのしつけカテゴリのAI指示書(MDファイル)です。永続メモリ+引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。この巻物をAIに読み込ませると、ゼロから設計・調査する場合に比べて 約1.8万トークン(API料金換算で約27円)・91%のトークンを節約できます。
- カテゴリ
- AIのしつけ
- 対応AI
- claude-code、cursor、codex-cli
- ライセンス
- 商用利用可 (再販不可)
- 価格
- 無料
- ゼロから開発時
- 約2万トークン
- この巻物使用時
- 約1,800トークン
- 節約量
- 約1.8万トークン (約27円)
- 更新日
- 2026-08-27
使い方 (AIに渡す3つの方法)
いちばん簡単なのはワンライナー。Claude Code のターミナルに貼るだけです。
claude "https://makimono-md.vercel.app/api/v1/files/md-1781779a/raw を読み込んで、この指示書どおりに実装して"
中身
AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す
複数セッションの AI エージェントに永続メモリと引き継ぎファイルを持たせて運用すると、 **「もう終わっている作業を、終わっていないことになっている文書のせいで作り直す」**事故が起きる。 この巻物は、その検知と再発防止の型。
誰向けか
- AI エージェントに
next-session.md的な引き継ぎファイル+memory/を持たせている - セッションを跨いで長期タスクを進めている
- 複数のセッション/端末が同じリソース(DB・シート・API・本番設定)を触りうる
何が起きるか(実例の構造)
- セッション A が「Xを開ける」という目的を引き継ぐ。文書には「まだ開いていない・承認待ち」とある。
- 実際には別のセッションが数時間前に開け終わっていた。
- しかし memory の該当ファイルには、新しい節(「開けた」)が追記された一方で、 古い節(「まだ開いていない」)がそのまま残っていた。
- 引き継ぎファイルは古い節のほうを読んで目的を組み立てた。
- セッション A は「開けるための承認」「ログイン」「reCAPTCHA 突破」といった 存在しないブロッカーを解こうとした。
根本原因は、memory の更新が「追記」だけで「古い結論の打ち消し」を伴わなかったこと。 追記型のメモリは、時系列で読むと正しいが、検索・要約で拾われると古い結論が生き残る。
型1: 着手前に「状態を読み戻すコマンド」を1本だけ走らせる
引き継ぎに書かれた目的がすでに達成済みでないかを、着手前に機械的に確かめる。 条件は「exit code で判定できること」。人間や AI の読解を挟まない。
# 例: 「在庫の穴を埋める」が目的なら、穴が残っているかを exit code で返す道具を先に走らせる
<state-check-command> --from <開始> --to <終了> # 穴があれば exit 1 / 無ければ exit 0
- 引き継ぎの「次の1目的」には、必ずこの検証コマンドを併記する。
目的の書き方を「Xをする」ではなく「
<cmd>が exit 0 になるようにする」に寄せると、 達成済みかどうかが着手前に1コマンドで分かる。 - API の成功応答・ジョブの成功ログは「システムがそう思っている状態」であって 「実際にそうなっている状態」ではない。読み戻しで判定する。
- 外向き(顧客に見える画面・公開ページ)に関わるなら、その画面を実際に開いて読み戻す。
型2: memory を更新するときは古い節を打ち消す
追記するだけにしない。古い節の結論を明示的に無効化する。
## 状態と次の手
**【<日付> 再確認・完了】もう当てはまらない。この節の以下は履歴。**
<検証コマンド> → <結果・exit 0>
残っている論点は <別ファイル> に移した。
<details><summary>(<日付> 以前に書かれた記述。履歴として残す)</summary>
...古い本文...
</details>
- 消さずに
<details>で畳む。過去版は消さないが、要約・検索で拾われる位置から外す。 - 索引ファイル(
MEMORY.md等)の1行説明も同時に直す。索引が古いと本文を直しても意味がない。 - ファイル冒頭の
descriptionを直す。多くの実装はまず description だけを読んで関連性を判定する。
型3: ロックの「保持者」を端末名にしない
排他ロックを入れていても、保持者 ID が端末名やリポジトリ名だと、 同一マシンの別セッションが取ったロックが「自分が持っている」と表示され、衝突を検知できない。
- 保持者にはセッション ID を入れる。端末名だけでは足りない。
- ロック取得時に
目的を必須にする。表示された目的が自分の記憶にないなら、別セッションである。 - ロックが空いている=安全ではない。 直前に別セッションが作業を終えて解放した可能性がある。 空いていても型1の読み戻しは省かない。
型4: 「承認が要る作業」は承認に依存しない部分を全部終わらせてから止める
- 非対話セッション(人間の入力が無い実行)では、対話ツールの「回答」は人間の承認ではない。 それを根拠に本番へ書かない。
- 調査・診断・数値の裏取りは承認不要。そこを全部やり切ってから止めると、 次のセッションは「決めるだけ」で済む。
- 止めるときは「何を・どこへ・なぜ」と実行すべき正確なコマンドを引き継ぎに残す。
チェックリスト(セッション開始時)
- 引き継ぎの「次の1目的」に検証コマンドが併記されているか
- そのコマンドを着手前に走らせて exit code を見たか
- 目的が達成済みだったら、引き継ぎと memory の古い結論を打ち消したか
- ロックの保持者・目的を見て、別セッションでないと確認したか
- 外向きの変更なら、実画面を開いて読み戻したか
効果
この型を入れる前は、同じ引き継ぎを2セッションが同時に拾い、 片方は完了済みの作業のブロッカー解消に丸ごと1セッションを使った。 型1を入れると、その判定が着手前の1コマンド(数秒)で終わる。
よくある質問
+「AIセッションの引き継ぎを信用せず、着手前に実システムを読み戻す」とは何ですか?
永続メモリ+引き継ぎファイルでAIエージェントを跨セッション運用すると「完了済みの作業を作り直す」事故が起きる。着手前のexit code判定・古い結論の打ち消し・ロック保持者の設計・非対話時の承認境界の4つの型。
+どれくらいトークン(費用)を節約できますか?
ゼロから開発すると約2万トークンかかりますが、この巻物を使えば約1,800トークンで済みます。差し引き約1.8万トークン(API料金換算で約27円)・91%の節約です。
+どうやって使いますか?
無料です。MDファイルを Claude Code などのAIに読み込ませるだけ。ワンライナーをターミナルに貼れば実装が始まります。要件定義や技術調査を省いて実装だけにトークンを使えます。
+どのAIツールに対応していますか?
claude-code、cursor、codex-cli に対応しています。
+商用利用できますか?
ライセンスは「商用利用可 (再販不可)」です。
🤝 自分でAIを動かすのは、まだ不安…という方へ
この巻物の内容を、AIを使うプロに丸ごと任せることもできます。姉妹サービスAI代行堂なら「LINEで頼むだけで、仕事が完成」。
関連する巻物
AI運用ルールを機械的に守らせる hook 設計 — ルール文が守られない本当の理由
チームでAIエージェントを使うと運用ルールが必ず守られなくなる。真因は「読んでいない」ではなく hook がそのマシンで登録されていない/委譲先が沈黙して壊れていること。禁止=実行前拒否・誘導=依頼時の具体コマンド注入・担保=セッション開始時の自己修復の3層、明示例外の短命トークン、warn→blockの段階昇格、BOM/サンドボックス/timeout など失敗が沈黙する罠と、環境依存で落ちないテストの作り方までを実測ベースでまとめた導入手順。
マキモノ検索スキル — AIが自分で巻物を探して使えるようになるMD
あなたのAIエージェント (Claude Code等) にこのMDを読ませると、開発タスクを受けたとき自動でマキモノAPIを検索し、最適な指示書を取得してから作業するようになります。導入は貼るだけ。
無人AIセッションのバックグラウンド委譲が静かに殺される事故を潰す
ヘッドレスで起動したAIエージェントがバックグラウンド委譲した子プロセスは、ターン終了で kill されるのに親は exit 0 を返す。機械的に deny するフック、通知の作り方、対応中フラグの戻し忘れ、Windows製worktreeがLinux側から解決できない罠までを含む恒久対策。
この巻物、誰かのトークンも救えます
𝕏 で節約レシートをシェア