llm-model-migration

---

name: llm-model-migration description: LLM provider가 default model을 업데이트(M2.7→M3, GPT-4→GPT-5, claude-3.5→3.7)하거나 pricing/Token Plan을 변경했을 때 코드/문서/카탈로그를 일관되게 마이그레이션하는 표준 절차. scope 분해 → grep inventory → catalog+production+docs 병렬 patch → 3단계 verification (AST, runtime, grep) → out-of-scope flagging → memory 영구 저장. title: LLM Model Migration — Provider Default Update domain: software-development space: growth type: workflow tags: [llm, model-migration, provider-update, token-plan, {{AGENT_NAME_LOWER}}] created: 2026-06-01 updated: 2026-06-01 links:

• "[[@memory/growth/INTEGRATION_PROTOCOL]]"
• "[[@identity/SELF_MODEL]]"
• "[[@identity/brain/{{AGENT_NAME}}-brain/P0-brainstem/禁/禁task_qa_gate.neuron]]"
• "[[@identity/brain/{{AGENT_NAME}}-brain/P0-brainstem/禁/禁blind_write.neuron]]"
• "[[@identity/brain/{{AGENT_NAME}}-brain/P0-brainstem/禁/禁karpathy_coding_principles.neuron]]"
• "[[@identity/brain/rules]]"---

LLM Model Migration — Provider Default Update

LLM provider가 default model을 업데이트했을 때 (M2.7→M3, GPT-4→GPT-5, claude-3.5→3.7 등) 코드/문서/설정을 일관되게 마이그레이션하는 표준 절차.

트리거 조건

다음 중 하나라도 해당되면 이 스킬을 로드:

• Provider 모델 업데이트 발표 (new default)
• Token Plan / pricing 변경 (per-call 정액제 → input/output 단가제 등)
• 모델 context window 변경 (8K → 1M 등)
• Legacy catalog 정리 (구 모델 deprecation)

1단계: Scope 확정 (사용자 입력 파싱)

사용자가 제시한 scope를 명확히 분리:

• In-scope files: 사용자가 명시한 파일 (예: "production code 4개 파일")
• Catalog/registry: model_metadata.py 같은 lookup table
• Docs: providers.md, SKILL.md, README, ARCHITECTURE
• Comments: source code 주석/문서
• Out-of-scope candidates: scope 밖이지만 영향 받을 수 있는 파일 (orchestrator, test fixture 등)

⚠️ Scope 밖 후보는 사용자에게 보고만 하고 변경하지 않는다 — silently 바꾸면 사용자의 의도(intent)를 무시하게 된다.

2단계: 재고 (Inventory) — grep으로 모든 참조 수집

# In-scope + catalog + docs
grep -rn "M2.7" --include="*.py" --include="*.md" \
  scripts/ plugins/ P0-brainstem/ agent/ \
  website/docs/ skills/ CHANGELOG.md

2-1. Multi-source file discovery (필수)

{{AGENT_NAME}} vault는 같은 파일이 여러 위치에 복사돼있을 수 있다. catalog/config 단일 파일로 가정하면 안 됨: