sync

/sync - Git Pull + 문서 동기화

---

플래그

플래그	설명
--no-pull	pull 건너뛰고 문서 동기화만 실행 (/sync-docs와 동일)
--check-only	문서 변경 필요 사항만 보여주고 수정하지 않음
(없음)	pull + 문서 동기화 모두 실행

---

Phase 1: Git Pull (--no-pull 시 스킵)

1-1. 현재 상태 확인

git branch --show-current
git status --short

커밋되지 않은 변경사항이 있으면 경고:

작업 중인 변경사항이 있습니다. stash 후 진행할까요? (Y/n)

• Y: git stash 후 진행, pull 후 git stash pop
• n: 그대로 pull 시도

1-2. Pull 실행

git pull origin main

충돌 발생 시 Phase 2 진행하지 않고 충돌 보고 후 중단.

---

Phase 2: 문서 동기화 (sync-docs v7 로직)

2-0. 모드 결정 (CRITICAL)

--check-only 플래그가 있으면:

• 모든 Write/Edit 도구 호출을 금지한다.
• 각 단계에서 "변경이 필요한 항목"만 수집한다.
• Read/Glob/Grep/Bash(git)만 사용한다.

2-1. 작업 설명 확인

인자로 전달된 작업 설명을 확인한다. 인자가 없으면 최근 커밋 메시지에서 작업 내용을 추론한다.

git log --oneline -5

2-2. 변경된 코드 분석

diff 범위 자동 감지:

BASE=$(git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null)
if [ -n "$BASE" ] && [ "$BASE" != "$(git rev-parse HEAD)" ]; then
  git diff --name-only "$BASE"..HEAD
  git diff --stat "$BASE"..HEAD
else
  COMMIT_COUNT=$(git rev-list --count HEAD 2>/dev/null || echo "0")
  if [ "$COMMIT_COUNT" -eq 0 ]; then
    echo "NO_COMMITS"
  elif [ "$COMMIT_COUNT" -ge 3 ]; then
    git diff --name-only HEAD~3..HEAD
    git diff --stat HEAD~3..HEAD
  else
    git diff --name-only HEAD~1..HEAD
    git diff --stat HEAD~1..HEAD
  fi
fi

NO_COMMITS가 출력되면 동기화할 변경사항이 없으므로 사용자에게 알리고 종료한다.

충돌 해결 원칙

소스 코드(git diff)가 최우선 진실 소스(source of truth)이다.

2-3. prompt_plan.md 동기화

Glob 패턴으로 prompt_plan.md를 탐색한다:

• ./prompt_plan.md
• ./.claude/prompt_plan.md
• ./docs/prompt_plan.md

업데이트 항목:

• 완료된 작업 항목 체크 (- [x])
• 진행 상황 갱신
• 다음 단계 업데이트

파일이 없으면 건너뛴다.

2-4. spec.md 동기화

Glob 패턴으로 spec.md를 탐색한다:

• ./spec.md
• ./docs/spec.md
• ./.claude/spec.md

업데이트 항목:

• 구현된 기능 반영
• API 변경사항 반영
• 데이터 모델 변경 반영

파일이 없으면 건너뛴다.

2-5. CLAUDE.md 동기화 (200줄 원칙 (Anthropic 공식))