AIとの議論を運用マニュアルに残す方法｜宿サイトの判断を引き継ぐ記録術

AIと相談して、記事の方向、公開手順、バックアップ、内部リンク、予約システムなどを決めても、重要な判断が会話の中だけに残っていると、次の作業で同じ説明を繰り返すことになります。

一方、会話をそのまま全部保存しても、結論がどこにあるか分かりません。途中で却下した案や、古い前提、秘密情報まで混ざる可能性があります。

必要なのは会話の全文ではなく、次の人が安全に判断し、続きを始めるための記録です。この記事では、AIとの議論を「決定事項」「継続ルール」「作業記録」「未決事項」に整理する方法を解説します。

結論：会話ではなく決定と根拠を残す
記録先を四つに分ける
運用方針・企画書へ残すこと
AGENTS.md・CLAUDE.mdへ残すこと
作業記録・ケースノートへ残すこと
未決事項は「分からない」で終わらせない
会話をそのまま保存しない理由
そのまま使える引き継ぎプロンプト
継続ルールへ昇格させる基準
実例1：正式なファイル名の訂正を残す
実例2：バックアップ失敗時の判断を残す
実例3：利用者の違和感を仕様へ反映する
記録を更新するときの注意
記録を保存する前の確認
AIへ記録の自己監査を頼む
まとめ
参考資料

結論：会話ではなく決定と根拠を残す

議論の後に残す基本項目は次のとおりです。

目的：なぜこの作業をしたか
決定：何を採用し、何を採用しなかったか
根拠：何を確認して判断したか
変更：どの原稿・投稿・設定を変えたか
確認：何を検査し、結果はどうだったか
未決：まだ分からないこと、次に判断すること
次の作業：誰が、何を、どの条件で行うか

AIに要約を作らせた後、宿主さんが内容を読み、正しい記録だけを保存します。

記録先を四つに分ける

すべてをAGENTS.mdやCLAUDE.mdへ書くと、日々の作業記録でファイルが長くなり、重要なルールが埋もれます。情報の寿命と用途で分けます。

記録先	残す内容	更新する時期
運用方針・企画書	サイトの目的、読者、分類、記事展開方針	方針を変えたとき
`AGENTS.md`・`CLAUDE.md`	毎回守る安全ルール、正本、公開・確認手順	継続ルールが増減したとき
作業記録・ケースノート	今回の状況、判断、変更、失敗、学び	作業ごと
タスク・未決事項	次に行うこと、担当、期限、停止条件	進捗が変わるたび

運用方針・企画書へ残すこと

サイト全体の方向を決める情報です。

誰のためのサイトか
どの情報を優先するか
どの種類の記事を作るか
カテゴリと内部リンクの考え方
写真や一次情報の扱い
公開済み記事と次の候補
記事を増やす判断基準

たとえば「最初から50記事を量産せず、基幹記事を作り、検索需要や宿主さんの質問を見て枝記事を増やす」という判断は、個別作業のメモではなくコンテンツ計画へ残します。

AGENTS.md・CLAUDE.mdへ残すこと

毎回の作業で繰り返し守るルールを記録します。

原稿や画像の正本はどこか
調査、下書き、本番公開をどう分けるか
変更前のバックアップ成功条件
公開、削除、復元、権限変更の承認者
秘密情報や顧客情報を表示しないこと
記事の投稿者、分類、description
公開後に確認するURLと表示幅
失敗時の停止条件

今回だけのURL、投稿ID、作業時刻、未完了タスクは書きません。継続ルールと一時情報を分けることで、指示書を読みやすく保てます。

Codex用の正式なファイル名は複数形のAGENTS.mdです。Claude Code固有の指示はCLAUDE.mdへ置き、共通ルールを二重管理しない構成を検討します。導入方法はAIサイト管理の安全ルールで解説しています。

作業記録・ケースノートへ残すこと

その作業で起きた事実と判断を、後から再現できる形で残します。

状況

何が問題だったか、いつ気づいたか、期待した状態は何かを書きます。

判断

複数案から何を選んだか、選ばなかった案と理由も簡潔に残します。

実行

変更した原稿、投稿、画像、内部リンク、設定を列挙します。秘密の接続情報や攻撃に利用できる内部実装は公開用記録から除きます。

確認

HTTP応答、投稿属性、PC・スマートフォン表示、新着除外、サーバー稼働など、実際に確認した項目と結果を書きます。

学び

同じ失敗を防ぐため、次回からどのルール、スクリプト、チェックリストを変えるかを書きます。

未決事項は「分からない」で終わらせない

未確認事項には、次の確認方法を付けます。

未決事項	確認先	次の行動	それまでの扱い
看板猫の客室訪問	宿主・現場責任者	現在の運用を確認	記事で断定しない
予約システムの追加料金	提供会社・契約画面	見積もりを取得	比較表を未確認とする
画像掲載の許諾	撮影者・宿	使用範囲を文書確認	公開しない
バックアップの復元可否	保守担当	検証環境で試験	高リスク変更を止める

「未確認」という状態だけでなく、次に誰が何を確認するかも一緒に記録します。

会話をそのまま保存しない理由

却下した案が混ざる

議論の途中では複数の選択肢を比較します。全文だけでは、最終的に何を採用したか分かりにくくなります。

古い前提が残る

会話の途中で、サービス名、URL、件数、方針が訂正されることがあります。最終記録では訂正後の内容を正本にします。

秘密情報が含まれる可能性がある

エラー画面、ログ、契約資料などを扱った会話には、公開・共有してはいけない情報が混ざる場合があります。記録前に除外します。

長くて読めない

次の担当者が必要なのは、すべての発言ではなく、現在の状態、決定理由、残作業です。

そのまま使える引き継ぎプロンプト

ここまでの議論と作業を、別の担当者や次回のAIが安全に続けられる引き継ぎ文書に整理してください。

次の見出しを使ってください。
1. 目的
2. 現在の状態
3. 確認済みの事実と根拠
4. 決定事項と決定理由
5. 採用しなかった案と理由
6. 変更した原稿・投稿・画像・設定
7. 実施した検査と結果
8. 未決事項と確認方法
9. 次に行う作業
10. 次の作業で変更してはいけないもの

会話を時系列で転載せず、現在有効な情報だけに整理してください。
推測を事実として書かず、未確認事項を分けてください。
パスワード、APIキー、秘密鍵、顧客・予約・決済情報、非公開の接続情報は記録しないでください。
今回は文書案の作成だけにし、既存ファイルを上書きしないでください。

継続ルールへ昇格させる基準

一度起きただけの出来事を、すべて運用ルールへ加える必要はありません。次のいずれかに当てはまるものを候補にします。

同じ間違いが再発する可能性がある
公開、削除、復元、個人情報など影響が大きい
サイト固有の正本や分類を毎回確認する必要がある
AIが一般知識だけでは判断できない
人が承認すべき境界を明確にする

ルールを追加するときは、「気をつける」のような曖昧な文章ではなく、行動と完了条件を書きます。

変更前にバックアップする。

よりも、次のほうが確認できます。

本番変更前にバックアップを取得し、終了状態、チェックサム、必要ファイルとデータベースの収録を確認する。失敗時は高リスク変更へ進まない。

実例1：正式なファイル名の訂正を残す

Codex用の指示ファイルを単数形のAGENT.mdとして扱っていた場合、説明記事の一文だけ直して終わりにしません。

正式名称の一次情報を確認する
プロジェクトの正本をAGENTS.mdへ統一する
旧名への参照を全文検索する
配布ページと説明記事を修正する
正本が二つ残っていないことを確認する
ケースノートへ状況・判断・確認結果を残す

「正式名称は必ず公式資料で確認する」という再発防止ルールは、継続ルールへ加えられます。

実例2：バックアップ失敗時の判断を残す

バックアップ中に稼働中ファイルの変更が検出された場合、「バックアップした」と記録しません。

結果：新規バックアップは未完了
確認：不完全ファイルなし。直近の検証済みバックアップは整合性確認済み
判断：データ削除・移行・更新は行わない
許可した範囲：非公開化できる新規記事と内部リンクの追加
残作業：バックアップ失敗原因の調査

成功と失敗を曖昧にせず、なぜ作業範囲を限定したかを残します。

実例3：利用者の違和感を仕様へ反映する

技術的に問題がなくても、利用者が不安に感じることがあります。たとえば、テンプレートをZIPで配布するより、Markdownファイルをブラウザで読んでから保存できる方式のほうが安心だという意見があった場合です。

この判断は次のように記録します。

状況：ZIP配布に不安を感じる利用者がいる
決定：Markdownファイルへの直接リンクに変更
理由：保存前に内容を確認できる
確認：Content-Type、リンク、旧ZIP案内の残存を確認
継続方針：初心者向け配布物は中身を先に読める方式を優先

利用者からの短い指摘も、判断理由まで残せば次の設計に生かせます。

記録を更新するときの注意

正本を一つにする

同じ方針を複数ファイルへコピーすると、片方だけ古くなります。正本を決め、他の文書はそこへリンクします。

追記だけでなく古い記述を直す

新しい結論を末尾へ追加するだけでは、古い指示と矛盾します。訂正時は古い表現と参照元を検索します。

日付だけで鮮度を判断しない

更新日が新しくても、根拠が古い場合があります。何を確認したかと確認日を一緒に残します。

公開用と内部用を分ける

公開記事には判断原則と再現できる確認項目を載せ、内部パス、ユーザー名、秘密の実行経路、顧客情報は載せません。

記録を保存する前の確認

[ ] 現在有効な結論だけになっている
[ ] 決定理由と根拠がある
[ ] 採用しなかった案が結論と混ざっていない
[ ] 未決事項に確認先と次の行動がある
[ ] 変更したもの・変更しなかったものが分かる
[ ] 検査結果と失敗を正確に記録した
[ ] 秘密情報、個人情報、内部接続情報を除いた
[ ] 保存先が情報の寿命と用途に合っている
[ ] 同じ内容の正本が複数ない
[ ] 次の担当者が最初に行うことが分かる

AIへ記録の自己監査を頼む

作成した引き継ぎ文書を、保存前に監査してください。

次を確認してください。
- 会話の途中案ではなく、最終決定が書かれている
- 事実、判断、推測、未確認事項が分かれている
- 変更対象、検査結果、失敗、残作業が明確である
- 次の担当者が安全に開始・停止できる
- AGENTS.md等の継続ルールと、一時的な作業記録が混ざっていない
- パスワード、鍵、APIキー、個人・予約・決済情報、非公開接続情報がない
- 既存の正本と矛盾または重複していない

問題を「保存前に修正」「人の判断が必要」「問題なし」に分けて報告してください。
今回は監査だけにし、ファイルを変更しないでください。

保存前監査でも、秘密情報をAIへ見せて探させるのではなく、最初から記録対象へ含めない運用を優先します。