Skip to content

fix: Wiki 동기화 누락 재발방지 — spec-sync-check 타이밍·범위 개선#33

Merged
trz-21 merged 1 commit into
mainfrom
fix/issue-32-wiki-sync-hook
Jun 16, 2026
Merged

fix: Wiki 동기화 누락 재발방지 — spec-sync-check 타이밍·범위 개선#33
trz-21 merged 1 commit into
mainfrom
fix/issue-32-wiki-sync-hook

Conversation

@trz-21

@trz-21 trz-21 commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

배경

#28(UI 리프레시)·#31(E2E 추가)이 머지됐으나 canonical 스펙인 Wiki 반영이 누락(6/14 이후 정체)됐다. 원인은 Wiki 리마인드 훅 spec-sync-check.sh의 구조적 결함 2가지.

변경 (.claude/hooks/spec-sync-check.sh)

  1. 타이밍: git diff(워킹트리/스테이징)만 보던 탐지 소스를 merge-base main...HEAD 커밋 diff와의 합집합으로 확장. 피처 브랜치에서 커밋 후에도 Stop 훅 리마인드가 유지된다. (기존: 커밋되면 diff가 비어 침묵 → 마무리 시점에 안 뜸)
  2. 범위: 패턴 추가

자동 GitHub 이슈 등록안은 Stop 훅마다 네트워크/중복 위험이 커서 미채택. 비차단 리마인드를 "올바른 타이밍 + 올바른 범위"로 만드는 데 집중.

검증

  • bash -n 구문 OK
  • 패턴 매핑 표 테스트: tests→Harness / app·shared·features→Frontend / workflows→Harness / backend src→Backend·API 전부 일치
  • 통합: 피처 브랜치에서 frontend/tests 변경을 커밋한 뒤 실행 → Wiki: Harness 리마인드 발생(타이밍 수정 실증). 훅 파일만 변경 시 오탐 없음.

관련 Wiki 따라잡기 (이 PR과 별개로 이미 반영)

Closes #32

Wiki 동기화가 반복 누락된 구조적 원인 2가지를 수정한다.

1. 타이밍: git diff(워킹트리)만 보던 것을 merge-base main...HEAD
   커밋 diff와 합집합으로 확장. 피처 브랜치에서 커밋 후에도 Stop 시
   리마인드가 유지된다(기존엔 커밋되면 diff가 비어 침묵).
2. 범위: frontend/src/features 만 매칭하던 패턴에
   frontend/{app,src/shared} → Frontend, frontend/tests·backend/tests·
   .github/workflows → Harness 추가. #31(tests/e2e)이 탐지 안 되던 문제 해소.

Closes #32

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@trz-21 trz-21 merged commit e419a4b into main Jun 16, 2026
@trz-21 trz-21 deleted the fix/issue-32-wiki-sync-hook branch June 16, 2026 00:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

재발방지: Wiki 동기화 누락 — spec-sync-check 패턴/타이밍 개선

1 participant