文書の版数・改訂履歴を管理するツールを非エンジニアがClaude Codeで内製する手順｜非エンジニア向け

なぜ「どれが最新か」が分からなくなるのか

文書そのものは、どの会社もきちんと作っています。手順書も、規程も、仕様書も、図面も、最初の一版は時間をかけて丁寧に整えられます。おかしくなるのは、そこから先です。文書は一度作ったら終わりではなく、機械が入れ替わった、法令が変わった、事故があった、やり方をひとつ簡略化した、といった理由で何度も直されます。そして直すときにやることは、たいてい同じです。元のファイルをコピーして、名前のうしろに何か足して、中身を書き換える。この「名前のうしろに何か足す」が積み重なった結果が、冒頭の共有フォルダです。

厄介なのは、この状態が壊れているように見えないことです。ファイルは全部そこにありますし、開けば読めます。問題は、複数ある版のどれが今の正解なのかを、ファイル自身が語ってくれない点だけです。そのひとつが欠けるだけで、次のようなことが起きます。

• 現場に貼ってある手順書が二世代前の版のままで、誰も気づいていない
• 改訂したのに、旧版のファイルが共有フォルダに残っていて、そちらが開かれ続ける
• 同じ文書を二人が別々に直してしまい、あとから片方の修正が丸ごと消える
• 「なぜこの手順になっているのか」を尋ねても、変えた理由がどこにも残っていない
• 取引先や監査で「最新版を出してください」と言われて、社内で議論が始まる
• 紙で配った版を回収し忘れ、現場のバインダーだけが古いまま更新されない

ここで扱っているのは「どの文書の、何版が、いつから有効で、どこに配ったか」を並べておくことだけです。判断らしい判断はほとんど含まれていません。それでも仕組みにならないのは、市販の文書管理システムがワークフローや電子署名まで含めた大がかりな作りで、版が分かれば十分な会社には過剰だからです。ここに内製の出番があります。自社が実際に改訂している文書の範囲に合わせた小さな台帳なら、品質管理や総務の担当者が自分の手で作れます。文書がどこにあるかを探す側の仕組みは社内ドキュメント横断検索ツールの作り方で扱っており、今回の「どれが今の正解か」という話とは別の問題です。

作るツールの全体像

今回作るのは、「この文書は今どの版か」と「まだ古い版を持っているのは誰か」の二つに常に答えてくれる小さなツールです。流れは次のとおりです。

• 版の台帳：文書名・版・発効日・改訂理由を、一版一行で持つ
• 今有効な版の判定：同じ文書の行のうち、発効日が今日以前でいちばん新しいものを取り出す
• 旧版のままの配布先の洗い出し：どこに何版を配ったかを持ち、有効な版と違うところを並べる
• 改訂理由の履歴：どの版で何を、なぜ変えたのかを、古い順に並べて読めるようにする

この設計でいちばん大事なのは、版をファイル名で管理しないことです。改訂のたびにファイルをコピーして名前を変えるやり方は、いちばん手軽で、道具も要りません。ところがこのやり方には、名前を付ける人ごとに流儀が違うという弱点があります。「v2」と書く人、「第2版」と書く人、「20260401改」と書く人、「修正版」とだけ書く人が同じフォルダに混在すると、機械はもちろん人間も順番に並べられません。しかも名前には「いつから有効か」も「なぜ変えたか」も入りません。版は、ファイル名に埋め込むものではなく、台帳の行として持つものです。文書名と版と発効日を欄として分けて持たせておけば、名前の付け方が人によってばらついても、順番は必ず一意に決まります。

もう一つ、最初に決めておきたいのが、この台帳の役割の線引きです。ここで作るのは「どの版が有効かを記録して答える」道具です。その改訂内容が妥当かどうか、承認してよいかどうかは、人が決めることです。ツールに判断させないでください。また、品質や安全に関わる認証を取得している会社では、文書の管理方法そのものに要求が課されている場合があります。何をどこまで記録する必要があるかは、規格の原文や認証機関の指示、社内の管理責任者にご確認ください。本記事では、認証の要求を満たすことではなく、日々の実務で最新版を取り違えないことを目的とした範囲を扱います。承認の流れそのものを仕組みにする話は稟議・承認フローを効率化するツールの作り方で別に扱っています。

用意するもの

準備するのは次の3つだけです。特別な開発環境は必要ありません。

• Claude Code：指示を出すと、必要なファイルを自動で作ってくれます。導入手順はClaude Codeのはじめ方を参照してください。
• 改訂が発生している文書の一覧：正式なものでなくて構いません。手順書、規程、様式など、直すことがある文書の名前が並んでいれば足ります。
• 配布先の一覧：どの部署や現場に紙やファイルを渡しているかが分かるものです。手書きのメモで構いません。

ここで一つだけ、渡す前に必ず確認してほしいことがあります。管理したい文書の中身そのものを、そのままClaude Codeに読み込ませないでください。これから作るのは版を追いかける仕組みであって、文書の中身を扱うことではありません。台帳に必要なのは文書の名前と版と日付だけで、本文は一行も要りません。手順書や規程には、社外に出せない工程や取引条件が書かれていることがあります。何を渡してよいかの線引きに迷う場合は、生成AIの情報漏えい対策で判断の基準を決めてから進めてください。なお、文書の中身そのものをAIに書かせたい場合は業務マニュアル・手順書を自動生成するツールの作り方が対応します。今回の版の管理とは、扱うものが違います。

Claude Codeへの指示と作成手順

ここからは、実際にClaude Codeへ出す指示の流れを順番に見ていきます。専門用語は使わず、ふだんの言葉で頼むのがコツです。

第一段階：版をファイル名から切り離し、行として積む形で持たせる。「社内文書の版を管理したい。文書名・版・発効日・改訂理由の四つを、一版一行で持たせてほしい。改訂したときは既存の行を書き換えるのではなく、新しい版の行を足す形にしてほしい」と伝えます。順番が大事です。ふつうに頼むと、文書ごとに一行を持ち、版の欄を更新していく形が出てきます。それがいちばんすっきりして見えるからです。最初に「行を足す形にしてほしい」と一言添えるだけで、あとから改訂の経緯をたどれる台帳になります。逆に、作ってしまってから履歴を持たせようとすると、それまでの改訂が一件も残っていない状態からのやり直しになります。四つに絞るのは、欄を増やすと入力が止まるからです。作成者や保管場所や次回見直し予定を最初から入れたくなりますが、まずは四つで動かして、必要になってから足してください。

第二段階：今有効な版を取り出させる。「同じ文書について、発効日が今日以前の行のうち、いちばん新しい版を有効な版として表示してほしい」と伝えます。ここが本記事でいちばん実務に効くところです。行を積む形にすると、当然ながら同じ文書の行が複数並びます。その状態で「今どれか」を人が目で追うと、いちばん下の行を見てしまいがちですが、それは正しくありません。発効日が来月の行が下に入っているかもしれないからです。「今日以前でいちばん新しい」という取り出し方を最初に決めておけば、行が何本に増えても答えは一つに定まります。あわせて必ず伝えてほしいのが、「発効日が空の行は、有効な版として扱わないでほしい」という一言です。日付が入っていない行を「たぶんもう有効」と解釈させると、まだ承認されていない草案が現場の正解として出てきます。空欄は空欄のまま、準備中として別に並べさせてください。

第三段階：旧版のままの配布先を洗い出させる。「どの文書の何版を、どこに配ったかを記録できるようにしてほしい。そのうえで、配った版が今の有効な版と違うところを一覧で出してほしい」と伝えます。改訂が事故につながるのは、内容が間違っているからではなく、直したことが配った先まで届かないからです。本社のフォルダの中では最新版に入れ替わっていても、現場の掲示板やバインダーには前の版が貼られたまま、ということが起こります。配った先と版をひとつ持たせておくだけで、「どこを回収すればよいか」が一覧になります。逆にこの一覧がないと、改訂のたびに全部の部署へ念のため連絡する運用になり、やがて誰も読まなくなります。現場で使う記録の側とどうつなぐかは安全パトロール記録ツールの作り方や製造業の生成AI活用もあわせてご覧ください。

第四段階：改訂の理由を古い順に読めるようにさせる。「ひとつの文書を指定したら、これまでの版を古い順に並べて、それぞれの改訂理由を一緒に出してほしい」と伝えます。作る手間はほとんどかかりませんが、効く場面は多くあります。「なぜこの工程だけ二重チェックなのか」と聞かれたとき、「三年前に取り違えが起きたため」という一行が残っていれば、それだけで話が終わります。理由が残っていないと、無駄に見える手順が定期的に「簡略化しよう」と俎上に載り、そのたびに当時の事情を知る人を探すことになります。ここで注意したいのは、改訂理由の欄に長文を書かせないことです。一行で書ける範囲に収めてください。長く書ける欄を用意すると、書くのが面倒になって空欄が増え、結局どの版にも理由が残らなくなります。読む人を決めて短く書く考え方はClaude Codeで業務ツールを作る5ステップで扱っています。保管年限が来た文書をどう畳むかは文書保管年限管理ツールの作り方が対応します。

つまずきやすい点と回避策

はじめて内製する方が引っかかりやすいポイントを、先回りしてお伝えします。

ファイルの更新日を版の代わりに使ってしまうこと。これが最も多い失敗です。台帳を作らなくても、共有フォルダの更新日順に並べれば最新が分かるはずだ、と考えたくなります。ところがファイルの更新日は、中身を直したときだけでなく、誰かが開いて何もせずに保存し直しただけでも動きます。印刷しようとして体裁を少しいじった、書式が崩れて見えたので直した、といった操作でも新しくなります。その結果、内容としては二世代前の版が、更新日ではいちばん新しく見える状態が普通に起こります。しかもこの取り違えは、起きていることに誰も気づけません。発効日を人が入力する欄として持つ理由はここにあります。手間に見えますが、これを機械任せにできる方法はありません。

文書名の表記をそろえないまま積み始めること。二番目に多い失敗です。同じものが「入荷検品手順書」「入荷検品手順」「検品手順書（入荷）」と書かれていると、行を積んでも同じ文書として並びません。並ばないということは、今有効な版が取り出せないということです。しかもこの不一致は、行が少ないうちは目で見て気づけるので放置され、増えてから発覚します。管理する文書の名前を先に一覧にして、その中から選ぶ形にしておいてください。文書番号を振っている会社なら、番号を主にして名前を従にするのがいちばん確実です。表記をあとからそろえる作業がどれだけ厄介かは、顧客リストの名寄せツールの作り方で扱っているとおりです。

改訂の妥当性や差分の説明をツールに判断させようとすること。三番目に注意したい点です。版が溜まってくると、「この文書は改訂が多すぎる」「前の版とここが違う」といった話を、ツールに言わせたくなります。しかし台帳が持っているのは、文書名と版と日付と一行の理由だけです。中身は入っていません。その状態で差分や評価を出させると、書かれていない部分を埋めた結果が、確認済みの事実のような顔をして出てきます。差分を見たいのであれば、それは台帳の仕事ではなく、文書そのものを見比べる仕事です。ツールに任せてよいのは「いつ、何版から何版に変わり、理由はこう書かれていた」を並べるところまでにしてください。

すべての文書を最初から対象にしようとすること。四番目です。台帳の形が見えると、社内にある文書を全部入れたくなります。ところが実際に版の取り違えが問題になるのは、改訂が起きていて、かつ複数の人が見る文書だけです。一度作って以来そのままの資料や、担当者一人しか使わないメモは、台帳に入れても行が増えるだけで何も防ぎません。最初は、直近一年で一度でも改訂した文書に絞ってください。数としては、思っているよりずっと少ないはずです。そこで運用が回ることを確かめてから、対象を広げます。作ったあと長く使い続けるための見直しの進め方は内製ツールの保守の進め方で解説しています。改訂した手順書を誰がいつ読んだかまで追いたい場合は教育訓練記録ツールの作り方が近い形になります。

まとめ：どれが有効かを答えるのはツールに、変えてよいかを決めるのは人に

本記事の要点を整理します。

• 最新版が分からなくなるのは管理していないからではなく、版をファイル名に埋め込んでいて、付け方が人ごとにばらつくから
• 作るのは「版の台帳→今有効な版の判定→旧版のままの配布先→改訂理由の履歴」の小さなツール
• いちばん大事なのは、版を上書きせず一版一行で足すこと。上書きすると、なぜ今の手順になったのかが辿れなくなる
• 今有効な版は「発効日が今日以前でいちばん新しい行」で取り出す。いちばん下の行ではない
• 発効日が空の行は有効な版として扱わせない。空欄は準備中として別に並べる
• ファイルの更新日を版の代わりにしない。開いて保存し直しただけでも新しくなる
• 改訂の妥当性や差分の説明はツールに出させない。台帳に中身は入っていない

文書名と、版と、発効日。この三つを一行に並べて積んでいくだけで、文書の管理は「名前を見ても順番が分からないファイルの山」から「今どれが正解かに即答できる仕組み」へ変わります。まずは直近一年で改訂した文書を五つだけ書き出し、中身は渡さず名前と版と日付だけをClaude Codeに伝えて、四つの欄を持つ台帳を作らせるところまでを試してみてください。研修費用の負担を抑えながら社内に内製できる人を増やす方法は生成AI研修に使える助成金もご確認ください。