新規Variant昇格実習例

公式variantであるco-workと、まだプロトタイプ段階のco-retailのトップレベルのファイル一覧を比較する。

diff <(ls templates/co-work/) <(ls Projects/co-retail/)

通常、variant.json、README.md/README_ko.md、docs/adr/は公式テンプレートには存在するが、Phase Aプロトタイプ段階ではまだ欠落しているか空のままである。まず、公式テンプレート（co-work）側にこれらのファイルが実際に存在することを確認する。

ls templates/co-work/variant.json templates/co-work/README_ko.md templates/co-work/docs/adr/

次に、co-retailプロトタイプのフォルダ一覧を確認し、上記ファイルがまだ存在しないことを確認する。

ls Projects/co-retail/

チェックリストには一般に「必須検証スクリプトが通過すること」「プラットフォームパリティが確保されていること」「エージェントのフロントマターが完了していること」などの項目が含まれる。co-retailの場合、第6章§2で作成したresearcher.mdとwriter.mdにすべての必須フィールドが揃っているかを再確認するところから始める。2つのスクリプトは異なる内容をチェックするため、それぞれ別々に実行し結果を個別に確認する。

① エージェントフロントマター完全性チェック — name、tier、handoffなどの必須フィールドがすべて入力されていることを確認する。

bun run agent:verify

② スキルマニフェストチェック — variantが参照するスキルが実際に存在し、3つのプラットフォーム（.claude/.gemini/.agents）に均等にデプロイされていることを確認する。

bun scripts/validate-skills.ts

co-retailが使用するスキル（例：campaign-research、copywriting）をskill_manifest.variant_specificに登録し、variant固有のスクリプトがあればscript_manifestに登録する。

{
  "name": "co-retail",
  "inherits_common": "1.0.0",
  "skill_manifest": {
    "variant_specific": ["campaign-research", "copywriting"]
  },
  "script_manifest": []
}

--l3-pathはPhase Aプロトタイプのパス、--nameは最終的なvariant名、--typeはドメインタイプ、--descriptionはvariantの説明である。--descriptionと、オプションフラグの--version（デフォルト0.1.0）、--status（デフォルトbeta）は、昇格結果のtemplates/co-retail/variant.jsonに直接書き込まれる。

bun scripts/l3-to-variant-pipeline.ts --l3-path=Projects/co-retail --name=co-retail --type=collaboration --description="Retail domain agent team"

diffを使用して、.claude/・.gemini/・.agents/のcommands/skillsディレクトリ一覧が対応していることを確認する（Claude/Gemini/Antigravityの3プラットフォームパリティ）。

diff <(ls templates/co-retail/.claude/commands/) <(ls templates/co-retail/.gemini/commands/)
diff <(ls templates/co-retail/.gemini/commands/) <(ls templates/co-retail/.agents/commands/)
diff <(ls templates/co-retail/.claude/skills/) <(ls templates/co-retail/.gemini/skills/)
diff <(ls templates/co-retail/.gemini/skills/) <(ls templates/co-retail/.agents/skills/)

すべてのステップが完了した後、構造検証をもう一度実行し、新しいvariantがワークスペース全体のルールを満たしていることを確認する。

bun scripts/validate-templates.ts