신규 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/

체크리스트에는 대체로 "필수 검증 스크립트 통과", "플랫폼 패리티 확보", "에이전트 frontmatter 완결성" 같은 항목이 들어간다. co-retail의 경우 6장 §2에서 만든 researcher.md, writer.md가 필수 필드를 모두 갖췄는지부터 다시 확인한다. 두 스크립트는 서로 다른 것을 검사하므로 각각 실행하고 결과를 따로 확인한다.

① 에이전트 frontmatter 완결성 검사 — name, tier, handoff 등 필수 필드가 빠짐없이 채워졌는지 확인한다.

bun run agent:verify

② 스킬 매니페스트 검사 — 베리언트(variant)가 참조하는 스킬이 실제로 존재하고 네 플랫폼(.claude/.gemini/.agents/.codex)에 고르게 배포돼 있는지 확인한다.

bun scripts/validate-skills.ts

co-retail이 사용하는 스킬(예: campaign-research, copywriting)과 변형 전용 스크립트가 있다면 skill_manifest.variant_specific과 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"

.claude/와 .gemini/, 그리고 .agents/·.codex/의 commands·skills·prompts 디렉터리 목록이 서로 대응하는지 diff로 확인한다(Claude/Gemini/Antigravity/Codex 네 플랫폼 패리티).

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/)
diff <(ls templates/co-retail/.agents/skills/) <(ls templates/co-retail/.codex/skills/)

모든 절차가 끝난 뒤 마지막으로 구조 검증을 한 번 더 돌려, 신규 베리언트(variant)가 워크스페이스 전체 규정을 만족하는지 확인한다.

bun scripts/validate-templates.ts