Skip to content

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

Description

@trz-21

배경

#28(UI 리프레시)·#31(E2E 추가)이 머지됐는데 canonical 스펙인 GitHub Wiki에 반영이 누락됐다(6/14 이후 정체). 원인 분석 결과 spec-sync-check.sh(Stop 훅, 비차단 Wiki 리마인드)에 구조적 결함이 있다.

원인

  1. 타이밍 창: git diff(워킹트리/스테이징)만 보므로 커밋 후엔 리마인드가 사라진다. 작업 마무리 시점엔 이미 커밋돼 있어 침묵.
  2. 패턴 누락: frontend/src/features/만 Frontend로 매칭. frontend/tests/(Harness), frontend/app/·frontend/src/shared/(Frontend) 변경은 탐지조차 안 됨. fix: Frontend CI 'No tests found' 해결 — 랜딩 스모크 E2E 추가 #31(tests/e2e)이 정확히 여기 해당.

해결

spec-sync-check.sh 개선:

  • 탐지 소스를 커밋 diff(merge-base main...HEAD) ∪ 워킹트리 diff로 확장 → 피처 브랜치에서 커밋 후에도 Stop 시 리마인드 유지
  • 패턴 추가: frontend/tests/ → Harness, frontend/app/·frontend/src/shared/ → Frontend, .github/workflows/ → Harness

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

완료 조건

  • tests/·app/·shared/ 변경 시 Wiki 리마인드가 뜬다
  • 커밋 후에도(피처 브랜치) Stop 시 리마인드가 유지된다

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions