enterprise-pinned-registry

エンタープライズ向け固定レジストリ

AI 生成のためのロックファイルの概念です。モデルのバージョン、プロンプト、ブランドトークン、シードをマニフェストに固定し、6 か月後、1 年後、あるいは 3 年後でも、同じキャンペーンをまったく同じように再生成できます。法的保全、ブランドキャンペーンの継続性、規制対応、前年比較において再現性を必要とする企業向けに構築されています。

---

使用するタイミング

• 複数チームへの展開：20 人以上のデザイナー／PM／代理店が同じブランドで生成し、全員で同一の出力を得る必要がある場合
• 年次キャンペーン（年次報告書、四半期決算のグラフィック）で、前年の見た目を正確に再現する必要がある場合
• 「再現可能であること」が選択肢ではなく、コンプライアンス要件となる規制対象業界
• 法的保全 — 訴訟支援のため、特定のアセットをまったく同じように再生成する必要が生じる場合がある
• モデルプロバイダーの変更管理 — 新しいバージョンは毎週リリースされるため、意図しない変化ではなく、明示的にレビューされたアップグレードを望む場合
• 監査証跡：公開するすべてのアセットについて、特定のモデルバージョン＋プロンプト＋ブランドトークンセットにさかのぼって追跡する必要がある

以下の場合には使用しないでください：単発の試行、草案／アイデア出しの段階、個人向けプロジェクト。

---

前提条件

レジストリを作成する前に、次の点を確認してください。

1. 対象範囲 — どのモデル、プロンプト、ブランドトークンを対象にしますか？まずは範囲を狭く（ヒーロー画像のみ）始めてから拡大します。
2. 更新頻度 — 四半期ごとですか？オンデマンドのみですか？更新を承認するのは誰ですか？
3. 回帰テスト用コーパス — 更新を承認する前に再実行する必要があるプロンプトのセットは何ですか？（通常、代表的なプロンプトを 10〜20 件用意します。）
4. 保存場所 — キャンペーンリポジトリ、専用の brand-registry リポジトリ、または中央ガバナンスリポジトリにレジストリを置きますか？
5. ロールバック計画 — 更新によって許容できない差異が生じた場合、どのように元に戻しますか？（レジストリが git にある場合は、通常 Git revert で十分です。）
6. 監査用の保持期間 — レジストリと生成出力をどのくらいの期間保持する必要がありますか？SOX 関連では 7 年、製薬では 10 年、商標防御では無期限です。

---

実行方法

5 つのステップで進めます。レジストリが契約となり、すべての生成はそれに基づいて行われます。

1. registry.json を作成する — モデルのエイリアス、プロンプトテンプレート、ブランドトークン、デフォルトパラメーターを設定します。各エイリアスは明示的な model@version に固定します。
2. プロンプトにフィンガープリントを付ける — 各プロンプトテンプレートに SHA256 ハッシュを付け、テンプレートと一緒に保存します。プロンプト文字列を変更するとフィンガープリントも変わり、バージョン付きの更新となります。
3. CLI を設定する — gen-ai config set registry <path> を実行すると、このマシンからのすべての呼び出しでレジストリが参照されます。チームでレジストリを git にコミットし、clone/pull で同期します。
4. エイリアスを使って生成する — デザイナーは [email protected]（直接指定）ではなく、flux（エイリアス）を使用します。エイリアスの解決はレジストリの役割です。
5. 四半期ごとに更新する — 回帰テスト用コーパスを新しいバージョン候補で実行し、出力を比較して承認を得たら、レジストリを更新し、リリースにタグを付けます（brand-registry-v2026.2）。

クイックリファレンス

レジストリ自体がマニフェストです。コミットし、タグを付け、更新のたびに差分を確認してください。

{
  "registry_version": "2026.2.0",
  "locked_at": "2026-04-01T00:00:00Z",
  "locked_by": "[email protected]",
  "previous_version": "2026.1.0",
  "regression_run_id": "REG-2026Q2-APPROVED",
  "models": {
    "flux":     { "id": "[email protected]",          "commercial_use": true,  "notes": "Hero, editorial" },
    "kontext":  { "id": "[email protected]",    "commercial_use": true,  "notes": "Product edit-mode" },
    "upscale":  { "id": "[email protected]", "commercial_use": true,  "notes": "Print prep" },
    "kling":    { "id": "[email protected]",       "commercial_use": true,  "notes": "I2V broadcast" },
    "portrait": { "id": "[email protected]",  "commercial_use": true,  "notes": "Portrait, verify license" }
  },
  "prompt_templates": {
    "hero_launch": {
      "text": "Editorial hero, {subject}, {environment}, brand palette, natural light",
      "fingerprint": "sha256:7b4f2a...c8e1"
    }
  },
  "brand_tokens": {
    "palette": { "primary": "#FF006E", "ink": "#0D0A1F", "accent": "#FFBE0B" },
    "aspect_ratios_allowed": ["16:9", "9:16", "1:1", "3:2"],
    "seed_default": 42
  },
  "audit_id": "REGISTRY-2026.2"
}

すべての生成アセットの results.json エントリには registry_version を含め、1 つのコマンドで再現できるようにしてください。

---

クイックリファレンス

レジストリはモデルを固定しますが、選択はしません。選び方については、ワークフローごとのスキルを参照してください。一般的なエンタープライズレジストリの内容は次のとおりです。

エイリアス	固定先	用途
flux	[email protected]	主なフォトリアルなヒーロー画像
kontext	[email protected]	編集モード、製品の正確性を維持
portrait	[email protected]	顔、商用利用に安全（ライセンスを確認）
upscale	[email protected]	印刷／配線準備
remove-bg	[email protected]	透明 PNG の派生物
change-bg	[email protected]	カタログ画像の背景差し替え
kling	[email protected]	放送用の画像から動画への変換

更新時には、gen-ai models info <id> を実行して、商用利用と地域での提供状況を確認してください。プロバイダーの規約は変更されます。モデルの固定はライセンスを意味しません。

---

手順

• どこでもエイリアスを使い、IDを直接記述しない。 デザイナーがプロンプトで [email protected] を目にすることがあってはなりません。flux だけを使います。
• レジストリは Git で管理します。 コミット、タグ付け、差分確認、レビュー、リバートができ、完全な監査証跡を無料で残せます。
• 更新のたびに回帰テスト用コーパスを用意します。 代表的なプロンプトを10～20件用意し、旧バージョンと新バージョンで実行して、ブランド責任者の承認を得たうえで視覚的な差分を確認します。
• モデルが対応している場合は、再現性を確保するためにシードを固定します。 --seed 42 を指定すると、同じ出力を決定論的に再生成できます。
• プロンプトテンプレートにフィンガープリントを設定します。 テンプレートの文字列を変更した場合は、黙って編集するのではなく、バージョンを上げます。
• レジストリのバージョンにはセマンティックバージョニングに準じたタグを付けます（2026.2.0 = 年・四半期・パッチ）。誤字修正はパッチ、新しいエイリアスの追加はマイナー、モデルの入れ替えはメジャーにします。
• 削除ではなく非推奨にします。 エイリアスを削除すると、過去の再実行に支障が出ます。非推奨としてマークし、ピン留めした状態で残して、CLI 出力に警告を表示します。
• 更新内容を記録します。 バージョンを上げるたびに、対象モデル、理由、回帰テストの結果、承認者を記載した変更履歴を公開します。
• 過去のキャンペーンを四半期ごとに、そのキャンペーンのレジストリバージョンから再実行し、再現性が保たれていることを確認します。再実行できない場合は、プロバイダーがそのバージョンを非推奨にしたということなので、移行を計画します。

---

注意点

• マニフェストでエイリアスと生の ID が混在している — チームが意図せずレジストリから逸脱します。PR で生の ID が使われていないか、Lint を実行します。
• 回帰テスト用コーパスがない — 更新が反映されても、コミュニケーション責任者が1年後に気づくまで差異が見えません。
• プロバイダーがピン留めしたバージョンを非推奨にする — いずれ起こります。法務上の再生成が必要になる前に検知できるよう、レジストリの過去のバージョンを四半期ごとに実行します。
• フィンガープリントのバージョンを上げずにプロンプトを編集する — 誰かがテンプレートの「誤字を修正」すると、出力が変わってしまいます。フィンガープリントを更新し、バージョンを上げます。
• シードが固定されていない — シードがなければ再現性は不完全です。レジストリのデフォルトシードを設定します。
• 個人のリポジトリでレジストリを管理している — 組織としてのアクセスを失います。ガバナンス管理下のリポジトリに置く必要があります。

---

検証

gen-ai whoami を実行して認証を確認し、その後、失敗したコマンドを --debug 付きで再実行します。

コマンド

# Point the CLI at the registry
gen-ai config set registry.path ./brand-registry/registry.json

# Pin a model alias
gen-ai config set registry.flux [email protected]
gen-ai config set registry.kontext [email protected]
gen-ai config set registry.kling [email protected]
gen-ai config set registry.upscale [email protected]

# Verify a given alias resolves to the pinned version
gen-ai config get registry.flux
# → [email protected]

# Generate using the alias (reproducible)
gen-ai generate --model flux --prompt-file prompts/hero-launch.txt \
  --seed 42

# Batch resolves all aliases against the registry
gen-ai batch run campaign.json

すべてのマニフェストでエイリアスを参照し、生のモデル ID は使いません。エイリアスからバージョンへの対応付けを行うのは、レジストリだけです。

---

コストと所要時間

レジストリの運用コストは低く、価値は問題の発生を防ぐことにあります。

作業	コスト	所要時間
初期レジストリの作成	0	エンジニア1人日
四半期ごとの回帰テスト用コーパス（プロンプト20件）	約200クレジット	生成に約1時間＋レビューに約2時間
バージョン更新とタグ付け	0	約30分
1年前のキャンペーンの再現	当初と同じクレジット数	当初と同じ実時間
プロバイダーの非推奨化に伴う移行	約500クレジット	エンジニア1～2人日

コスト削減効果はチームの規模に応じて高まります。20人のデザインチームで偶発的な更新を行うと、差異によるコストは四半期ごとにレビュー済みの更新を1回行う場合を大幅に上回ります。

---

関連項目

• enterprise-brand-governor — brand.md によるゲーティング。完全なポリシー・アズ・コードの実現に向けてレジストリと組み合わせます。
• product-photo-studio — カタログの一括処理（再撮影モード）。レジストリのエイリアスを使用します。
• enterprise-press-batch — 情報解禁日時を考慮したパイプライン。前年比の一貫性を保つため、ピン留めします。
• gen-ai-use — CLI リファレンス