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

Claude Codeの作業記録の残し方、納品と説明のために──「AIがやりました」で終わらせない作業記録票、Gitのコミット、会話の書き出しの型

    この記事は、Claude Codeで作業した内容の記録を、納品と取引先への説明のために残す方法を扱います。

    「この変更、誰がどう確認したんですか」

    納品から2か月後、取引先から不具合の連絡が来ます。
    原因を調べると、Claude Codeで直した箇所でした。


    「どんな指示で、どこを変えて、誰が確認したのか」を聞かれても、答えられない。
    当時の担当者の記憶にしかなく、会話の画面も、もう残っていない。


    AIで作業が速くなるほど、何をしたかの記録は薄くなります。記録がないと、説明も、原因の調査も、次の見積もりもできません。

    Claude Codeの作業記録とは、指示・変更・人の確認の3つを、AIの画面の外に、案件の番号で残すことである

    黒字化の外科医です。Claude Codeの作業記録の残し方を解剖します。


    なお私は弁護士ではありません。実務の指針として読み、個別の判断は専門家や公的な窓口に確認してください。


    画面の外に残すべき理由は、三つあります。


    第一に、手元の記録は、いずれ消えるから。
    公式ドキュメントによると、セッションのファイルのスナップショットは、既定ではおよそ30日後に自動で削除され、期間は cleanupPeriodDays という設定で変えられます(code.claude.com「Checkpointing」、2026年10月27日確認)。納品の説明に使う記録を、手元の履歴に頼るのは危険です。


    第二に、チェックポイントは、記録の代わりにならないから。
    同じ公式ドキュメントでは、チェックポイントはセッションの中で素早く戻すためのもので、恒久的な履歴にはGitなどのバージョン管理を使うよう書かれています(同上)。


    第三に、取引先が知りたいのは、AIの会話ではなく「人が何を確かめたか」だから。
    長い会話をそのまま渡されても、取引先は読めません。必要なのは、変更の中身と、確認した人と、確認の結果です。

    今すぐ試せる:作業記録票を下書きするプロンプト

    Claude Codeの作業が終わったところで、同じセッションの中で頼みます。

    今回のセッションで行った作業を、作業記録票の形でまとめてください。
    
    【案件番号】〔 〕
    【依頼の内容(取引先からの依頼)】〔 〕
    
    1. 依頼に対して、行った作業を3〜5行で書く。
    2. 変更したファイルの一覧と、それぞれの変更の目的を書く。
    3. 実行したテストやコマンドと、その結果を書く。
    4. まだ確認できていないこと、人が判断すべきことを書く。
    
    推測で書かず、このセッションで実際に行ったことだけを書くこと。


    出てきた下書きは、そのまま使わず、担当者が読んで直します。最後の「人が判断すべきこと」を、確認した人が埋めて完成です。

    作業記録工場:残す3つの場所と型

    1. 作業記録票(案件の台帳に残す)

    【作業記録票】
    案件番号:〔 〕 作業日:〔 〕
    依頼:〔取引先の依頼の要約〕
    作業者:〔名前〕 使ったツール:Claude Code
    指示の要点:〔AIに渡した指示を2〜3行で〕
    変更したファイル:〔一覧〕
    テストと結果:〔実行したテスト、目で確認したページ〕
    人の確認:〔確認した人〕〔確認した日〕〔結果:OK/要修正〕
    未確認・残りの課題:〔 〕
    コミット:〔Gitのコミットの識別子〕

    2. Gitのコミット(変更そのものを残す)

    コミットのメッセージの型:
    〔案件番号〕〔何を、なぜ変えたか〕
    
    例:
    A-2410 お問い合わせフォームの送信後の画面で、二重送信を防ぐ
    (Claude Codeで修正、山田がレビュー、テスト環境で確認済み)


    コミットを細かく分けておけば、問題が起きたときに、どの変更が原因かを特定しやすくなります。

    3. 会話の書き出し(必要なときだけ)

    公式ドキュメントでは、/export というコマンドで、今の会話をテキストとして書き出せると説明されています(code.claude.com「Commands」、2026年10月27日確認)。
    全部の作業で残す必要はありません。取引先の情報を扱った作業、本番に関わる作業、判断が分かれた作業だけ、案件のフォルダに保存します。

    記録にかかる時間(数字は例)

    作業記録票 1件:10分
    月の作業:20件
    20件 × 10分 = 200分(約3時間20分)


    検算:200分 ÷ 60 = 3.33…時間、つまり約3時間20分です。この時間は、保守や開発の見積もりに、作業の一部として入れておきます。

    構造的なリスク

    逆説を指摘しておきます。


    記録を細かくしすぎると、誰も書かなくなります。
    最初は「人の確認」の欄だけを必ず埋める、と決めてください。誰が確かめたかが残っていれば、他の欄は後から復元できることが多いのです。


    また、会話の書き出しには、取引先の情報が含まれることがあります。保存する場所と、残す期間を、社内のルールで決めてください。

    ▶ 生成AIの社内ルールがない制作会社は、納品物を説明できない──入力禁止の情報、お客様への説明と同意、成果物の確認責任、著作権の基本

    よくあるQ&A

    Q. 記録は、取引先に渡すべきか?


    全部を渡す必要はありません。納品の報告書には、変更の一覧と確認の結果を載せ、作業記録票は社内に残します。納品報告の型は、こちらにあります。

    ▶ AI駆動開発の納品前チェックリスト、品質を「確かめた記録」で渡すキット──レビュー・テスト・セキュリティ・ライセンス・ドキュメントの確認項目50、判定の記録表、例外の記録、顧客向け納品報告書、チェック工数の計算例


    Q. 小さな修正まで記録するのか?


    案件番号とコミットだけは、必ず残します。作業記録票は、本番に関わる変更から始めてください。


    Q. 記録がないことで、責任を問われることはあるか?


    記録の有無で責任が決まるわけではありませんが、説明できないことは、信頼を大きく損ないます。責任の考え方は、こちらで整理しています。

    ▶ AI生成コードの責任は誰が持つか──「AIが書いたので」は通らない。契約不適合責任・検収・保証範囲で、制作会社が負う責任の線を先に引く

    最後に

    Claude Codeの作業記録は、AIの会話を残すことではなく、指示・変更・人の確認を、案件の番号で残すことです。


    導入支援で、お客様にこの記録の型を渡すメニューも、こちらにまとめています。

    ▶ Claude Code導入支援サービス設計キット──診断・初期設定・研修・伴走のメニューと料金表、提案書の構成、設定の雛形、契約の確認点


    AIの画面の外に記録を残した会社だけが、半年後の不具合にも、次の見積もりにも、根拠をもって答えられるのです。

    これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。


    #Web制作会社 #ClaudeCode #作業記録 #納品 #品質管理 #Git #制作会社経営 #中小企業 #AI駆動開発 #説明責任

     
     
    Web制作・開発会社の「労働集約という病」をAIで冷徹に切除し、利益率を極限化する組織ハッキング術を公開。 人間の感情と作業を排除し、社長一人で莫大な富を搾取する「完全無人ファクトリー」を構築する覚悟を持つ経営者のみ、有料記事で圧倒的な暴利と勝利を手に入れてください。

    あなたへのおすすめ