プロンプトのバージョン管理：追跡・ロールバック・チームワークフロー

バージョン管理なしのプロンプト変更は品質低下を残さない——エラーログも差分も、ロールバックパスも存在しません。 モデルは例外をスローする代わりに、もっともらしい誤った回答を返します。品質低下に気付くまでに（ユーザーのクレーム・精度指標・下流パースエラー経由で）、元のプロンプトが消えていることがあります。

バージョン管理が防ぐ3つの失敗パターン：（1）サイレント回帰——文言変更がモデルの動作を微妙に変化させ、誰かが気付く前に数千リクエストにわたって品質が低下する。（2）ロールバック不能——履歴なしでは、以前のプロンプトを記憶や古いデプロイログから復元するしかない。（3）協業時のコンフリクト——2名のエンジニアが同じプロンプトを独立して編集し、後からのマージが前の変更を上書きして記録が残らない。

MAJOR.MINOR.PATCHバージョニングは、プロンプト変更が下流コードの再テストなしに安全に採用できるかどうかをすべての呼び出し元に伝えます。 MAJORは出力フォーマットが変わった（下流パーサーが壊れる）ことを意味します。MINORは品質が向上したがフォーマットは安定していることを意味します。PATCHは動作への影響なしに文言や明確さのみ変更されたことを意味します。

標準ワークフローは：ブランチ作成 → プロンプト編集 → 回帰テスト → PR作成 → マージ＆タグ付け。 すべてのステップがソフトウェアコードの変更と同じです——プロンプトはコードだからです。

プロンプトchangelogエントリには5つのフィールドが必要です：バージョン・日付・作成者・変更タイプ・期待される出力デルタ。 出力デルタが最も重要なフィールドです。変更後のモデルレスポンスの違いを説明することで、下流の呼び出し元が何を更新すべきか把握できます。

`git revert` が標準のロールバックパスです——履歴を消さずに問題のある変更を取り消す新しいコミットを作成します。 ロールバックのトリガーを把握し、緊急度に応じた方法を選択してください。

ロールバックのトリガー：（1）精度指標やユーザー報告でプロダクション品質の低下を検知。（2）デプロイ済みプロンプトにセキュリティ上の問題が発見された。（3）モデルバージョン更新で既存プロンプトとの互換性が壊れた。（4）ビジネスロジック変更により以前の出力フォーマットが不正確になった。

所有権がマージコンフリクトを防ぎます：機能エリアごとに1名のプロンプトオーナーを割り当て、そのプロンプトへのすべての変更にオーナーのレビューを必須とします。 明確な所有権がなければ、2名のエンジニアが同じプロンプトを並行して編集し、後からのマージが前の変更を上書きします。

チームに適した2つのリポジトリパターン：（1）`/prompts/` ディレクトリを含むモノリポ——プロンプトが単一サービスと密結合していて、プロンプト変更をアプリと一緒にデプロイする必要がある場合に最適。（2）専用プロンプトリポジトリまたはパッケージ——プロンプトを複数サービスで共有する場合や、アプリリポジトリアクセスなしにプロンプトエンジニアが独立したレビューサイクルを必要とする場合に最適。

回帰テストはフォーマット崩れを検出し、LLM-as-judgeは品質低下を検出します。 4種類のテストで、プロンプト変更がプロダクションに到達する前の主要な失敗モードをカバーします。

4種類のテスト：（1）フォーマット検証——出力が期待されるスキーマ（JSON構造・必須フィールド・データ型）に一致することをアサート。ミリ秒で実行され、破壊的変更の60〜70%を検出。（2）ゴールデンセット比較——10〜20件の代表的な入力に対してマニュアル検証済みの正解と出力を比較。LLM-as-judgeまたは文字列類似度指標でスコアリング。（3）ハルシネーションフラグ——提供されたコンテキストに基づかない出力内の事実主張を検出。入力にない事実を断言した応答にフラグを立てる。（4）レイテンシチェック——中央値のレスポンス時間が許容範囲内（例：p95 ≤ 3秒）であることをアサート。過剰なモデル計算を引き起こすプロンプトを検出。

日本（METI AIガバナンス）： 経済産業省（METI）の「AI事業者ガイドライン」（2024年3月）は、高リスクAIシステムに対してAI利用の記録・変更履歴の管理を推奨しています。プロンプトバージョン管理の作成者記録・変更タイプ・承認ログはこのガイドラインのトレーサビリティ要件を満たします。医療・金融・重要インフラ分野では、12ヶ月以上のプロンプトバージョン履歴と改ざん防止ストレージが求められる場合があります。

東アジア・アジア太平洋地域（データ主権）： 日本（改正個人情報保護法）・韓国（PIPA）・シンガポール（PDPA）・マレーシア（PDPA）はデータの越境転送に関する規制を強化しています。プロンプトが個人データを処理する場合、バージョン管理済みのプロンプトリポジトリをオンプレミスまたはローカルクラウドリージョンに保持することで越境転送リスクを軽減できます。

グローバル展開する企業向け（EU AI法）： EU AI法は医療・金融・HR・重要インフラの高リスクシステムに対してAI出力のトレーサビリティを要求します。バージョン管理済みプロンプト履歴（作成者・日付・変更タイプ・承認記録）は追加ツールなしでこのトレーサビリティ要件を満たします。