fe-doc-sync

fe-doc-sync — 사용자 프로젝트 문서 동기화 스킬

이 스킬은 fe-rail 플러그인 자체가 아니라, 이 플러그인을 설치한 사용자 프로젝트 (예: Vibe App, 모노레포 등)에서 호출됩니다. 호출 시점의 작업 디렉토리(cwd)를 기준으로 프로젝트 전반을 스캔해 해당 프로젝트의 CLAUDE.md / README.md 가 실제 코드와 일치하도록 동기화합니다.

중요: 사용자 프로젝트에 CLAUDE.md 또는 README.md 가 없다면 생성을 제안한다. 단, 새 파일을 임의로 만들지 말고 Phase 4 수정안 → Phase 5 승인 절차를 거친다.

---

Phase 1: 프로젝트 식별 및 전체 스캔

(A) 프로젝트 타입 감지

package.json 을 읽어 프레임워크와 구조를 판별한다.

# 루트 + 모노레포 앱들의 package.json 위치
fd -t f -e json --max-depth 4 --hidden -E node_modules -E .next -E dist 'package.json' . 2>/dev/null \
  || find . -maxdepth 4 -name package.json -not -path '*/node_modules/*' -not -path '*/.next/*' -not -path '*/dist/*'

# 워크스페이스 여부
cat package.json 2>/dev/null | grep -E '"workspaces"|"packageManager"'

판별 매트릭스:

package.json 의존성	판별
next	Next.js 앱 (App Router 여부는 app/ vs pages/ 존재로 추가 판별)
vite + @tanstack/react-router	Vite SPA (TanStack Router)
vite + (react-router 또는 react-router-dom) v7 이상	Vite SPA (React Router 7·8) — 데이터는 TanStack Query 단독 소유. v8 은 react-router-dom 제거됨
vite + react-router-dom v6 이하	Vite SPA (React Router 레거시)
workspaces 필드 존재 + apps/·packages/	모노레포
react-native	RN Web (참고만, fe-rail 주 대상 아님)

(B) 프로젝트 구조 스캔

# 핵심 디렉토리 트리 (깊이 3까지)
fd -t d --max-depth 3 -E node_modules -E .next -E dist -E .git . 2>/dev/null \
  || find . -maxdepth 3 -type d -not -path '*/node_modules/*' -not -path '*/.next/*' -not -path '*/dist/*' -not -path '*/.git/*'

# 라우트 파일 카운트
# - Next App Router
fd 'page\.(tsx|ts|jsx|js)$' app 2>/dev/null | wc -l
# - Next Pages Router
fd '\.(tsx|ts|jsx|js)$' pages 2>/dev/null | wc -l
# - TanStack Router
fd '\.(tsx|ts)$' src/routes 2>/dev/null | wc -l

# 주요 디렉토리 카운트
for d in components hooks lib services stores api features; do
  count=$(fd -t f --max-depth 5 . "$d" 2>/dev/null | wc -l | tr -d ' ')
  [ "$count" != "0" ] && echo "$d: $count"
done

# 모노레포면 apps/ packages/ 목록
ls -1 apps/ packages/ 2>/dev/null