베이스 업데이트 받기

라이선시 fork는 한 번 받고 끝이 아닙니다. 베이스(ddakit/scene-studio)가 새 스킬을 추가하거나, 훅을 고치거나, AI_AUTOMATION.md의 트랙 라우팅이나 license-policy 레벨을 갱신할 때마다 그 변경이 fork에 도달해야 라이선스 가치가 유지됩니다. /update-from-base는 git rebase를 몰라도 안전하게 받도록 해 주는 명령입니다.

자동으로 적용하는 영역, 절대 건드리지 않는 영역, 사람이 결정하는 영역. 이 세 갈래 분기가 핵심입니다.

영역별 owner

base-owned: 자동 갱신 대상

경로	무엇
`.claude/skills/{base-skill-name}/`	베이스 스킬 (start, 두 오케스트레이터, license-policy, pipeline-performance 등)
`.claude/agents/*.md`	9 에이전트 (코어 8 + 옵션 blog-writer)
`.claude/hooks/*.sh`, `.claude/settings.json`	베이스 훅과 등록
`AI_AUTOMATION.md`	도메인 기준 문서 (트랙 라우팅, scene type, license-policy 레벨, S1~S8)
`.env.example`, `.gitignore`	자리 표시 값과 표준

베이스 스킬 본문은 직접 수정하지 않는 것이 원칙입니다. 본인 스킬을 추가하고 싶으면 별도 디렉터리에 만듭니다.

user-owned: 절대 건드리지 않는 영역

경로	무엇
`_workspace/{video_slug}/`, `_workspace/videos.json`, `_workspace/channel.json`	작업 중인 모든 영상, 채널 정체성, 캐시
`.env`	OPENAI_API_KEY, REPLICATE_API_TOKEN 등
`.claude/agent-memory/`, `.claude/state/`, `.claude/session-state/`	메모리, 런타임, 세션 핸드오프
`LICENSE`, `COMMERCIAL-LICENSE.md`	라이선스

작업 중인 영상과 채널 정체성은 전부 user-owned라 업데이트가 건드리지 않습니다. 베이스가 갱신되어도 영상 작업이 사라지지 않습니다.

mixed: 3-way 안내

CLAUDE.md, AGENTS.md, README.md 세 파일입니다. 베이스와 사용자 양쪽 편집이 동시에 들어갈 수 있어 자동으로 갱신하지 않고 diff만 보여 주고 묻습니다. README.md는 /start가 본인 채널 이름과 정체성으로 다시 쓰는 파일이라, 통째로 덮어쓰면 사용자 채널 정체성이 사라집니다.

한 사이클

/update-from-base 또는 “베이스 업데이트 받아줘”라고 실행하면 다음 절차를 거칩니다.

git status --porcelain으로 작업 트리가 깨끗한지 검사합니다. 저장하지 않은 변경이 있으면 git stash를 권합니다.
git fetch base main으로 최신 변경을 가져옵니다.
git diff --name-status <last_synced_commit>..base/main으로 변경 파일을 영역별로 분류합니다.
base-owned 변경을 요약합니다. 새 스킬 N개, 갱신된 훅 M개, AI_AUTOMATION.md 갱신 여부를 알려 줍니다.
사용자가 동의하면 base-owned 경로만 적용합니다.
mixed 파일은 한 개씩 세 가지 선택지(통째 덮어쓰기, 3-way merge, 미루기) 중 하나를 골라 적용합니다.
적용한 다음 검증하고 commit을 권합니다.

사전 설정으로 베이스를 git remote로 등록하는 절차는 첫 호출이 자동으로 안내합니다.

git remote add base https://github.com/ddakit/scene-studio.git

상태 파일은 .claude/state/base-upstream.json에 들어가고, last_synced_commit부터 base/main까지의 변경분만 확인합니다.

license-policy가 갱신되면

베이스 스킬을 본인이 수정한 흔적이 있을 때

.claude/skills/{base-skill}/ 안의 파일을 사용자가 commit으로 수정한 적이 있으면(git log로 감지합니다) 그 파일은 base-owned가 아니라 mixed로 처리됩니다. 자동으로 덮어쓰면 사용자 작업이 사라지기 때문입니다. 이런 상황을 피하려면 베이스 스킬을 직접 고치지 말고, 같은 trigger 키워드를 가진 별도 스킬을 본인 디렉터리에 만듭니다.

인접 문서

같은 절차를 비개발자 눈높이로 따라가는 문서는 비개발자용 업데이트에 있습니다.