Skip to content

Sync SKILL/README/install guide after worktreeConfig migration + onboarding gaps #68

Description

@reopt-eric

Problem

PR #65로 `worktreeConfig`가 `dev-proxy.config.mjs`에서도 동작하게 됐고, `.dev-proxy.json`은 read-only legacy fallback이 됐습니다. 그러나 다음 문서·스킬이 아직 옛 모델(`.dev-proxy.json`에 worktreeConfig)을 가르치고 있고, 신규 사용자가 막히는 알려진 지점이 보강 안 된 상태입니다:

정확성 갭 (PR #65 미반영)

  • `.claude/skills/dev-proxy-init/SKILL.md` — Phase 3.2/3.3 중복·혼란, worktreeConfig가 어느 파일에 가는지 모순
  • `.claude/skills/dev-proxy-review/SKILL.md` — `.releaserc.json`/semantic-release 구성 검증 단계 부재, 최근 CI 변경(prettier ignore, GH Packages 미러) 미반영
  • `docs/guide/installation.md` — 모든 worktreeConfig 예제가 `.dev-proxy.json` 기준
  • `README.md` / `README_KO.md` — worktreeConfig 위치 안내 옛 모델
  • `CLAUDE.md` — Config 단락이 이미 mjs 가정 (✓) 단 legacy fallback 명시 부족

온보딩 갭

  • DNS resolver 설정 후 timing 안내 없음 (신규 사용자 1순위 실패)
  • init이 worktreeConfig를 묻지 않는다는 제약이 약하게 묻혀 있음
  • sudo 명령 옆 1줄 주석 부족
  • 한/영 README ~98% 동기화, 일부 축약 (포트 변경 예제)

메타데이터

  • 두 SKILL.md 모두 버전 하드코딩(1.0.0, 2.0.0) — frontmatter `verified-against`로 대체

Acceptance

  • 두 SKILL.md가 mjs 기준 (Phase 3.2/3.3 정리, framework matrix 단순화)
  • dev-proxy-review SKILL에 semantic-release 구성 검증 단계 + 최근 CI 변경 반영
  • installation.md 모든 예제 mjs 기준, DNS timing 팁, worktree 제약 박스, sudo 주석
  • README.md / README_KO.md mjs 기준 + 한/영 동기화
  • CLAUDE.md legacy fallback 명시 한 줄
  • `pnpm check` 통과 (단순 docs라 test 추가 없음)

Out of scope

  • 코드 변경 (PR #65에서 처리됨)
  • 새 기능 추가

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions