agency-client-handoff

制作案件の引き継ぎ

完了した案件を、クライアントの社内チーム、DAM、または次の代理店へ引き渡せるようにパッケージ化します。アセット一式、プロンプトライブラリ、モデルの固定情報、権利に関するドキュメントなど、受け取ったチームがあなたの関与なしに一貫した成果物を再生成するために必要なものをすべて含めます。

案件完了 → 再現可能な引き継ぎバンドル。 囲い込みではなく、ナレッジの移転を重視します。受け取ったチームが代理店に問い合わせることなく、ブランドイメージに沿った制作を続けられるようにします。

使用する場面

• 案件の終了時に、クライアントが業務を社内に移す場合
• 新しい広告代理店への移行時に、前の代理店から引き継ぐ場合
• ピッチやキャンペーンの完了時に、出所情報付きのアセット一式をクライアントのDAMに納品する場合
• 再生成権を含む「ソースファイル」の納品が契約で義務付けられている場合
• 長期リテイナー契約のクライアント向けに、年度末のポートフォリオスナップショットを作成する場合

次の用途には使用しないでください。 進行中の作業のレビュー（Driveリンクを使用）、承認（校正PDFを使用）、社内アーカイブ（代理店のバックアップを使用）。引き継ぎとは、正式な、クライアントが所有する、再現可能なバンドルです。

前提条件

ユーザーに、次の項目を一度のメッセージで確認します。

1. クライアントのスラッグと案件の範囲 — どのクライアントの、どのプロジェクトまたはリテイナー期間を引き継ぐのか
2. 受け取りチーム — 社内のクリエイティブチームか、別の代理店か。どの形式やツール（Figma、Adobe、CapCut、Notion）を使用しているのか
3. 権利の状況 — すべての入力素材にライセンスが付与されているか。削除またはクレジット表記が必要なストック素材、フォント、参照用の顔写真はあるか
4. 再生成の想定 — クライアントが自分たちでアセットを再生成する必要があるか、それとも静的なアーカイブだけでよいか
5. 機密保持 — 納品前に削除が必要な社内プロンプト、競合他社の参照情報、タグ付きメタデータはあるか
6. 納品形式 — zip＋Driveリンクか、クライアントのS3／DAMへの直接納品か、物理ドライブか

クライアントが再生成機能を必要としている場合は、gen-ai CLIも必要になります。バンドルにインストールガイドを追加してください。

実行方法

1. INVENTORY   → pull every asset + results.json from clients/<slug>/ across the engagement
2. FILTER      → exclude drafts, rejected variants, internal-only WIP
3. STRIP       → white-label: remove agency tags, internal prompt notes, competitor refs
4. PIN MODELS  → lock every prompt's model to an exact ID + version (not "latest")
5. DOCUMENT    → generate README, RIGHTS.md, CHANGELOG, prompt library
6. PACKAGE     → zip with consistent folder structure + naming
7. VERIFY      → extract and cold-test: can a fresh machine regenerate one asset?
8. DELIVER     → upload to client destination, share link, brief the receiving team

ルール：

• すべてのモデルIDを固定します。 recraftv4 → recraftv4@2026-03-15（またはgen-ai models infoが返す正確なID）。「最新」は変化し、再現性が損なわれます。
• 社内メタデータを削除します。 retainer-week-2026-04-22やpitch-concept-bのようなタグは社内用であり、クライアントに見せるものではありません。
• 出力だけでなく、プロンプトも含めます。 プロンプトライブラリがあれば、クライアントの社内チームはシステムを一から作り直さずに反復作業を進められます。
• 実環境でテストしていない引き継ぎは、絶対に納品しないでください。 解凍してプロンプトを1つ選び、再生成します。出力にずれが生じる場合は、何かが固定されていません。

クイックリファレンス

{
  "handoff_kind": "client-final",
  "client_slug": "acme-fintech",
  "engagement": "2025-Q3 to 2026-Q2 retainer",
  "delivered_at": "2026-04-22",
  "brand_system": "docs/brand-system.json",
  "brand_rules": "docs/brand.md",
  "pinned_models": "docs/model-pins.json",
  "assets_count": 247,
  "prompts_count": 54,
  "rights_status": "all generated, no licensed stock",
  "regeneration_supported": true,
  "support_window_days": 30
}

これをdocs/handoff-manifest.jsonとして含めてください。受け取りチームに、何を受け取ったのか、何ができるのかを伝える単一のファイルです。

クイックリファレンス

引き継ぎで新しいアセットは生成せず、既存のアセットをパッケージ化します。ただし、再現性を確認するため、次の点を確認してください。

タスク	モデル	備考
再生成のドライランテスト（最安）	gemini-3.1-flash-image	出力品質ではなく、ペイロードの有効性を確認するために使用します
完全な再生成の証明（アセット1点）	元と同じモデルを固定	元のバンドルと照合し、出力を目視で比較します
高解像度での再エクスポート	topaz-upscale-image	クライアントのDAMで4K版が必要な場合

引き継ぎ時に、固定したモデルより新しいモデルに置き換えてはいけません。クライアントが代理店の出力を正確に再現できることが、引き継ぎの要点だからです。

手順

• 納品物は再現性です。 クライアントがあなたなしで再生成できなければ、アセットフォルダーがどれほど美しくても、引き継ぎは失敗です。
• 伏せ字にするのではなく、取り除いてください。 内部タグは完全に削除し、バンドルがクライアントにとって自然な状態になるようにします。
• 引き継ぎにはバージョンを付けてください — handoff-v1/、handoff-v2/。後日更新版のバンドルを依頼されても、上書きしないでください。
• 代理店サポートの終了日を記載してください — クライアントが自力で対応するのか、再依頼するのかを明確にできます。
• gen-ai models info <id> --json で正確なモデル ID を固定してください — 引き継ぎ時点の機能を保持できます。
• クリーンなマシンでテストしてください。 あなたのノート PC にはトークン、フォント、キャッシュがあります。バンドルはそれらがなくても動作する必要があります。
• ベンダーロックインにつながるフラグは使わないでください。 バンドル内のすべてが、標準の gen-ai インストールで実行できるようにします。
• プロンプト、ブランド、根拠を納品してください。 知識の引き継ぎでは、成果物よりもコンテキストが重要です。

注意点

• モデルが固定されていない — クライアントが 6 か月後に再生成すると出力が変わり、代理店の責任にされます。
• 内部メタデータの漏えい — 競合他社の参照情報、ピッチ用コンセプトタグ、レビュアー名がプロンプトファイルに残っています。
• 権利関連の文書がない — クライアントの法務担当者が再利用を承認できず、バンドルを利用できません。
• 再生成の過程に独自ツールがある — 標準の gen-ai CLI のみにしてください。
• クリーンな環境でのテストがない — バンドルを納品した後、README の手順 1 が失敗し、緊急の Slack メッセージが届きます。
• 一度きりで終わらせる姿勢 — 引き継ぎ後 30 日間の質疑応答を約束し、その費用を見積もりに含めてください。

検証

gen-ai whoami を実行して認証を確認してから、失敗したコマンドを --debug 付きで再実行してください。

ステップ 1：棚卸しとフィルタリング

CLIENT="acme-fintech"
HANDOFF="handoff/$CLIENT-$(date +%Y-%m-%d)"
mkdir -p "$HANDOFF"/{assets,prompts,source,docs}

find "clients/$CLIENT" -name "results.json" -exec cp {} "$HANDOFF/source/" \;
cp -r "clients/$CLIENT/deliverables/"* "$HANDOFF/assets/"
node scripts/extract-prompts.js "$HANDOFF/source/" > "$HANDOFF/prompts/prompt-library.json"

ステップ 2：モデルを固定し、内部データを削除

# Get pinned model IDs for every model the engagement used
for model in $(jq -r '.jobs[].model' "$HANDOFF/source/"*.json | sort -u); do
  gen-ai models info "$model" --json >> "$HANDOFF/docs/model-pins.json"
done

# Strip internal tags from the prompt library
jq 'del(.jobs[].tags[] | select(startswith("internal-") or startswith("retainer-")))' \
  "$HANDOFF/prompts/prompt-library.json" > "$HANDOFF/prompts/prompt-library.clean.json"
mv "$HANDOFF/prompts/prompt-library.clean.json" "$HANDOFF/prompts/prompt-library.json"

ステップ 3：ドキュメント作成

フォルダーの概要、再生成手順（CLI のインストールと実行例 1 件）、固定したモデルに関する注記、権利の状況、サポートの連絡先と終了日を記載した README.md を作成します。docs/brand-system.json、docs/brand.md、docs/model-pins.json、docs/RIGHTS.md、docs/CHANGELOG.md を含めてください。

README に含める再生成手順の最低限の内容：

1. Install CLI: curl -fsSL https://picsart.com/gen-ai-cli/install.sh | bash
2. gen-ai login
3. Pick a prompt from prompts/prompt-library.json
4. gen-ai generate -m <pinned-model-id> -p "<prompt>"

ステップ 4：パッケージ化と検証

cd handoff
zip -r "$CLIENT-handoff-$(date +%Y-%m-%d).zip" "$CLIENT-$(date +%Y-%m-%d)/" \
  -x "*.DS_Store" "*/.git/*"

# Cold test — extract to a clean dir, regenerate one asset
tmpdir=$(mktemp -d) && unzip -q "$CLIENT-handoff-$(date +%Y-%m-%d).zip" -d "$tmpdir"
cd "$tmpdir/$CLIENT-$(date +%Y-%m-%d)"
SAMPLE_PROMPT=$(jq -r '.jobs[0].prompt' prompts/prompt-library.json)
SAMPLE_MODEL=$(jq -r '.jobs[0].model' prompts/prompt-library.json)
gen-ai generate -m "$SAMPLE_MODEL" -p "$SAMPLE_PROMPT"  --dry-run --debug
# Dry-run validates = bundle is regeneration-ready.

コストと所要時間

フェーズ	費用	時間
棚卸し＋フィルタリング＋削除	$0	1-2 hrs
ドキュメント作成（README、RIGHTS、CHANGELOG）	$0	1-2 hrs
クリーンな環境での再生成テスト（アセット 1～2 件）	~$0.50	15 min
引き継ぎ合計	<$1	~4 hrs

実際にかかるのはクレジットではなく時間です。引き継ぎ 1 件につき半日を見込んでください。手順を省くと、その後何か月にもわたってサポートの問い合わせが発生します。

関連項目

• workflows/agency-brand-scoping/ — 引き継ぎに含める brand-system.json と brand.md
• workflows/agency-multi-brand-pack/ — クライアントごとの results.json アーカイブの作成元
• workflows/agency-pitch-mockups/ — 最終的な引き継ぎの一部となるピッチ用バンドル
• gen-ai-use.md — クライアント向けの再生成リファレンス