[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FCFJ9YVX3VG0D571DRKCS8":3,"skill-same:01M7FCFJ9YVX3VG0D571DRKCS8":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7FCFJ9YVX3VG0D571DRKCS8","implement",null,"Prevue 저장소의 코드를 바꾸는 작업을 그 작업의 워크트리 안에서 계획 합의부터 머지 · 치우기까지 끝까지 간다. PR로 가는 경로(src · bin · viewer · skills-src · dev-skills-src · tools · 워크플로 · 빌드 파일)를 고치거나 기능을 더해 달라는 요청에 쓴다 — 원인 조사 · 질문 · 문서만 고치는 일에는 쓰지 않는다. \u002Fimplement로도 부르고(\u002Fimplement grill이면 grilling으로 계획한다), 멈춘 자리부터 이어 간다.","kakao\u002Fprevue","kakao","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1267113?v=4","01M7FCF1H0YFGBTTV1CSBBQTTX","01M7FCF1HJM66W3S4SM08Z9X0Q",118,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplement\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: implement\ndescription: Prevue 저장소의 코드를 바꾸는 작업을 그 작업의 워크트리 안에서 계획 합의부터 머지 · 치우기까지 끝까지 간다. PR로 가는 경로(src · bin · viewer · skills-src · dev-skills-src · tools · 워크플로 · 빌드 파일)를 고치거나 기능을 더해 달라는 요청에 쓴다 — 원인 조사 · 질문 · 문서만 고치는 일에는 쓰지 않는다. \u002Fimplement로도 부르고(\u002Fimplement grill이면 grilling으로 계획한다), 멈춘 자리부터 이어 간다.\n---\n\u003C!-- 생성물이다. dev-skills-src\u002Fimplement\u002FSKILL.md 를 고치고 tools\u002Fgen-agents.sh 로 만든다 -->\n\n# implement — 작업 하나를 머지까지\n\n규칙(브랜치 · 워크트리 · 머지 권한 · 지우면 안 되는 것)은 `AGENTS.md`의 \"브랜치와 워크트리\" 절이 갖는다 — 여기는 절차만 갖는다.\n\n- **사람에게 묻는 곳은 계획 합의 한 번이다.** 그 뒤에는 머지 · 치우기까지 간다. 따로 멈추는 곳은 넷 — 대상 저장소의 Gradle 실행(`AGENTS.md` \"승인이 필요한 것\"), 합의한 성공 기준을 못 맞추거나 범위를 바꿔야 할 때(4단계 리뷰의 물을 것이 계획 · 범위 · 공개 계약 · 결정을 건드릴 때도), 리뷰 스킬이 설치돼 있는데 독립 리뷰어를 띄울 수 없을 때(4단계), 그리고 PR의 CI가 실패했을 때(5단계). 멈추면 무엇이 왜 어긋났는지 보고한다.\n- **워크트리를 만들고 지우는 것은 이 스킬 밖의 일이다** — 작업을 넘기는 쪽(사람이나 오케스트레이터)이 만들고, 머지 뒤에 지운다. 이 스킬은 그 워크트리 안에서만 돈다.\n- 상태는 git · GitHub에서 읽는다. 따로 적어 두는 파일이 없다 — 다시 불리면 0단계가 멈춘 자리를 찾는다.\n\n## 0. 어디서부터인가\n\n```sh\ngit rev-parse --abbrev-ref HEAD; git status --porcelain\ngit fetch -q origin\ngit rev-list --count origin\u002Fdevelop..HEAD\ngh pr list --head \"$(git rev-parse --abbrev-ref HEAD)\" --state all --json number,state,url\n```\n\n위에서부터 처음 맞는 줄로 간다.\n\n| 지금 | 간다 |\n|---|---|\n| 베이스 체크아웃 | 멈춘다 — 아래 \"베이스에서 불렸으면\" |\n| 워크트리, 이 브랜치의 PR이 `MERGED` | 6. 치우기 |\n| 워크트리, 열린 PR이 있다 | 5. 머지 |\n| 워크트리, `origin\u002Fdevelop` 위에 커밋이 있다 | 4. 리뷰 — 개발이 덜 끝났으면 3 |\n| 워크트리, 커밋이 없다 | 대화에 합의한 계획이 있으면 2, 없으면 1 |\n\n**베이스에서 불렸으면** 아무것도 만들지 않고, 이 작업의 워크트리를 먼저 만들어 그 안에서 다시 부르라고 알린다. 만드는 법으로 베이스에서 `git fetch -q origin` · `git worktree add .worktrees\u002F\u003C작업명> -b worktree-\u003C작업명> origin\u002Fdevelop`을 알려 준다.\n\n## 1. 계획 — 읽기만\n\n코드와 저장소 문서에서 사실을 먼저 확인한다. 재현이 필요하면 2단계의 빌드 뒤 이 워크트리의 `plugin\u002Fbin\u002Fprevue`로 본다 — 고치지 않는다.\n\n- **열린 결정이 있으면**(대안이 갈리거나 기준을 정해야 한다) 하나씩 정한다. 인자가 `grill`이면 늘 이쪽이다. `grilling` 스킬이 설치돼 있으면 그것으로 정하고 Prevue 규약은 부르는 여기가 넘긴다 — 없으면 대화로 하나씩 묻는다.\n  - 사실 확인 — 코드와 저장소 문서를 읽고 묻는다.\n  - 산출물 형식 — `[최종]`의 본문을 아래 한 화면 계획(무엇을 · 성공 기준 · 뺀 것)으로 쓴다.\n  - `[최종]`이 오면 그것이 합의다 — 다시 묻지 않고 2단계로 간다.\n- **없으면** 한 화면으로 보이고 \"진행할까요?\"를 받는다.\n\n```\n무엇을    \u003C바꾸는 것 한두 줄 · 고칠 자리>\n성공 기준  1. … (무엇으로 확인하나)  2. …\n뺀 것     … (이유)\n```\n\n합의가 이 스킬의 유일한 확인이다. 고쳐 달라면 고쳐 다시 보인다. 거절하면 아무것도 만들지 않고 멈춘다.\n\n## 2. 준비\n\n```sh\ngit log -1 --oneline                 # origin\u002Fdevelop 의 끝인지 본다 — 아니면 origin\u002FHEAD 가 main 이다(AGENTS.md 클론 직후)\n(cd plugin\u002Fdaemon && .\u002Fgradlew --offline installPrevue)    # 이 체크아웃의 plugin\u002Fbin\u002Fprevue 가 쓸 실행 파일. 스킬 · 문서만 고치면 건너뛴다\npython3 tools\u002Flint\u002Fviewer.py --deps 2>\u002Fdev\u002Fnull || npm ci --prefix viewer-src    # node_modules 는 git 밖이라 새 워크트리에 없다 — 없으면 tools\u002Flint.sh 가 종료 2로 멈춘다. 판정은 viewer.py 가 갖는다\n```\n\n## 3. 개발\n\n- **성공 기준마다 증거를 남긴다** — 무엇을 쳐서 무엇을 봤는지. 5단계의 검증 기록이 된다.\n  - 단위 테스트 `(cd plugin\u002Fdaemon && .\u002Fgradlew --offline test)` · CLI 판정 `python3 -m unittest discover -s tests\u002Fcli` · 스킬 두 벌 · `CLAUDE.md` `sh tools\u002Fgen-agents.sh --check`\n  - 통합 테스트 `(cd plugin\u002Fdaemon && .\u002Fgradlew --offline -q :daemon:integrationTest --tests …); echo \"gradle=$?\"; python3 tools\u002Ftest-summary.py` — `-q`면 결과가 출력에 없어 요약이 클래스별 tests · failures와 첫 실패 메시지를 찍는다. 판정은 `gradle=`이다 — 컴파일이 실패하면 태스크가 돌지 않아 요약은 지난 실행의 XML을 읽는다(시각 열로 보인다). 단위 테스트 결과는 `plugin\u002Fdaemon\u002Fdaemon\u002Fbuild\u002Ftest-results\u002Ftest`를 인자로 준다\n  - 렌더는 **이 워크트리의** `plugin\u002Fbin\u002Fprevue`로 본다(`AGENTS.md` \"브랜치와 워크트리\").\n  - 뷰어는 헤드리스 Chrome으로 본다. 모션 느낌 · Safari처럼 사람 눈이 필요한 것은 \"사람 확인 전\"으로 적어 두고 막지 않는다.\n- 사용자에게 보이는 변화는 `CHANGELOG.md` `[Unreleased]`에 적는다 — 무엇을 어떤 모양으로 쓰나, 외부 제보 · 기여를 어떻게 멘션하나는 `dev-skills-src\u002Frelease-notes.md`가 갖는다. 그 항목이 곧 GitHub Release 본문이다.\n- 검증장 · 대상 체크아웃은 `AGENTS.md` \"개발 위생\"을 따른다.\n- 커밋은 조각마다. 끝에 세션의 공동 저자 줄을 붙인다.\n\n## 4. 리뷰\n\n짠 쪽의 가정을 모르는 눈이 본다 — 리뷰어(`reviewer-\u003C등급>`)가 `review` 스킬과 이 저장소의 리뷰 규약(`dev-skills-src\u002Freview.md`, `AGENTS.md` \"리뷰\")으로 판정한다. 등급은 분류기가 고른다. 워크트리 루트에서 돌린다 — 규약 경로가 상대 경로다.\n\n**분류기를 돌리기 전에 파일이 있는지 본다**(아래 첫 줄). 없으면 `review` 스킬이 설치되지 않은 환경이다 — 이 단계를 건너뛰고 PR 본문과 7단계 보고에 \"독립 리뷰 없음\"을 적는다. 설치돼 있는데 리뷰어를 띄울 수 없으면 멈추고 독립 리뷰를 못 했다고 보고한다 — 자기 diff를 다시 읽는 것으로 대신하지 않는다.\n\n```sh\ntest -f ~\u002F.claude\u002Fskills\u002Freview\u002Fscripts\u002Freview_tier.py    # 실패하면 review 스킬이 없다 — 이 단계를 건너뛴다\npython3 ~\u002F.claude\u002Fskills\u002Freview\u002Fscripts\u002Freview_tier.py --range origin\u002Fdevelop..HEAD --config dev-skills-src\u002Freview.md\ngit merge-base origin\u002Fdevelop HEAD   # 기준 ref — 0단계의 fetch로 origin\u002Fdevelop이 앞서 나가도 이 작업분만 보게 SHA로 넘긴다\ngit rev-parse HEAD                   # 끝 커밋 — 리뷰 중에 고쳐도 범위가 흔들리지 않게 SHA로 고정한다\n```\n\n분류기 출력의 첫 줄이 등급, 둘째 줄부터 근거다.\n\n- **`skip`** — 바뀐 파일이 전부 규약의 건너뛰기 패턴에 맞는다. 리뷰어를 띄우지 않고 5단계로 간다.\n- **`medium` · `high` · `xhigh`** — 그 등급의 리뷰어에 위임한다. **종료 코드 2**(판정 못 함)면 `high`로 띄우고 stderr를 위임 프롬프트에 함께 넘긴다.\n\n위임 프롬프트에는 기준 ref(위 merge-base SHA) · 끝 커밋 SHA · 분류기 근거 줄 · 합의한 계획과 성공 기준 · 3단계 증거(무엇을 돌려 무엇을 봤나)를 넣는다.\n\n`Agent(subagent_type: \"reviewer-\u003C등급>\")`로 띄운다 — 리뷰어 정의가 effort와 `review` 스킬 로드를 고정한다. 서브에이전트 effort는 띄울 때 정해져, 안에서 로드한 스킬로는 바뀌지 않는다.\n\n결과를 이렇게 처리한다.\n\n- **고칠 것** — 고치거나, 고치지 않으면 이유를 PR 본문에 적는다. 고쳤으면 그 고침이 닿는 3단계 증거를 다시 본다.\n- **물을 것** — 계획 · 범위나 기존 공개 계약(CLI 출력 · 매니페스트)을 바꿔야 하거나, 결정(`D-\u003Cn>`)을 뒤집는 것이면 멈추고 묻는다. 나머지(API 모양 · 읽기 쉬움처럼 취향이 갈리는 것)는 리뷰어 추천안으로 처리하고 질문과 고른 것을 PR 본문에 적는다.\n- **머지 위험 줄**은 PR 본문에 옮긴다.\n\n## 5. 로컬 검증 → PR → 머지\n\n머지 관문은 둘이다 — 밀기 전에 마지막 커밋에서 돌리는 로컬 검증 다섯과, PR을 연 뒤 그 head에서 도는 CI(빌드 검증)의 성공. develop에는 필수 체크가 없어 서버가 막아 주지 않으므로 CI를 기다리는 것은 여기가 지킨다(`AGENTS.md`).\n\n```sh\nsh tools\u002Fgen-agents.sh --check     # 스킬 두 벌 · CLAUDE.md 가 원본과 같다\nsh tools\u002Fplugin-copies.sh --check   # plugin\u002F 의 LICENSE · NOTICE.md 가 루트 원본과 같다(D-123)\n\"$(command -v python3.9 || command -v python3)\" -m unittest discover -s tests\u002Fcli   # CI 는 python 3.9 — 있으면 그것으로 돌려 3.9에서만 깨지는 것을 밀기 전에 잡는다\n(cd plugin\u002Fdaemon && .\u002Fgradlew --offline test)   # 소스 · 빌드 파일을 안 건드렸으면(문서 · 스킬만) 건너뛴다\nsh tools\u002Flint.sh                     # Kotlin · 뷰어 날값 린트(D-70 · D-96) — 판단하지 말고 결과대로 고친다\n```\n\n하나라도 실패하면 고쳐 다시 돌린다. 통과한 결과(테스트 수)를 PR 본문의 검증 기록에 적는다.\n\n```sh\ngit push -u origin HEAD\ngh pr create --base develop --title \"\u003C무엇을 · 왜 한 줄>\" --body \"\u003C본문>\"   # 열린 PR이 이미 있으면(이어 가는 중) 밀기만 하고 건너뛴다\n```\n\n본문: 무엇을 · 왜, 성공 기준과 검증(여기가 원 기록이다), 리뷰 등급과 결과(고치지 않은 지적과 이유 · 추천안으로 처리한 물을 것 · 머지 위험, 건너뛰었으면 \"독립 리뷰 없음\"), 사람 확인이 남았으면 그것. 끝에 세션의 PR 서명 줄.\n\n- **develop이 앞서 충돌하면** `git fetch -q origin` · `git rebase origin\u002Fdevelop` 뒤 위의 로컬 검증을 다시 돌리고 `git push --force-with-lease`.\n\n**CI를 기다린다.** CI 결과가 나오기 전에는 머지 명령을 부르지 않는다.\n\n```sh\ngh pr checks \u003CN> --watch --fail-fast\n```\n\n\"빌드 검증\"(약 7~10분, job 시간 제한 20분이 기다림의 상한이다)이 초록이어야 한다. 막 연 PR은 체크가 아직 안 붙어 \"no checks\"로 끝나거나, `license\u002Fcla`만 붙은 채로 초록으로 끝날 수 있다 — 그래서 끝난 뒤의 아래 확인이 판정이다. 기다리는 사이 새 커밋을 밀었으면 앞 실행은 취소된다(`cancel-in-progress`) — 새 head의 실행을 다시 기다린다.\n기다림은 `run_in_background`로 돌리고 끝났다는 알림에 이어 간다(포그라운드 sleep은 막혀 있다).\n\n기다림이 끝나면 머지 직전에 `gh pr view \u003CN> --json headRefOid,statusCheckRollup`로 판정한다 — `statusCheckRollup`은 head 커밋의 체크다.\n\n- `headRefOid`가 기다림을 시작할 때의 `git rev-parse HEAD`와 다르거나, `build`가 아직 없거나 진행 중이면 조금 뒤 다시 기다린다.\n- head가 같고 `build`의 `conclusion`이 `SUCCESS`면 초록이다.\n- head가 같고 `build`의 `conclusion`이 `SUCCESS`가 아니면(`FAILURE` · `CANCELLED` · `SKIPPED` · `TIMED_OUT` 등) 실패다 — `gh pr checks`가 종료 0으로 끝났어도 그렇다.\n\n**실패하면 머지하지 않고 멈춘다.** 어느 job · 어느 스텝이 무엇으로 실패했는지(`gh run view \u003Cid> --log-failed`의 요지) 보고한다. 로컬 검증이 통과했는데 CI만 실패했다면 macOS에서만 통과하는 것(Ubuntu · `sh`)일 수 있다 — 그 짐작도 함께 적되 고치지는 않는다. 다시 불려 고친 커밋이 있으면 4단계 리뷰어를 수정 확인으로 띄운다 — 분류기에 `--range \u003CCI가 실패한 head>..HEAD --recheck`(곧 `medium`)를 주고, 위임 프롬프트의 직전 결과 자리에는 CI 실패 요지를 넘긴다. 그다음 이 단계의 로컬 검증부터 다시 돌아 민 뒤 CI를 기다린다.\n\n초록이면 PR 본문의 성공 기준 결과 · 검증 기록(CI 실행 링크 포함)을 채우고 머지한다.\n\n```sh\ngh pr merge \u003CN> --squash             # --delete-branch 를 붙이지 않는다\n```\n\n## 6. 치우기 — 이 작업의 것만\n\n다른 워크트리는 머지됐어도 건드리지 않는다 — 다른 세션이 쓰고 있을 수 있다.\n\n```sh\ngh pr view \u003CN> --json state -q .state     # MERGED 일 때만 아래로\nplugin\u002Fbin\u002Fprevue stop --mine\ngit ls-remote --exit-code --heads origin \u003C브랜치> && git push origin --delete \u003C브랜치>    # 이미 지웠으면 건너뛴다\n```\n\n워크트리와 로컬 브랜치는 지우지 않는다 — 이 세션이 그 안에 있고, 만든 쪽이 지운다. 7단계 보고에 \"워크트리 정리 남음 — \u003C워크트리 경로>\"를 적는다.\n\n**회고 남기기.** 치운 뒤 보고 전에 `retro` 스킬을 **남기기**로 로드한다 — 이 세션에서 환경 탓에 헤맨 자리를 기록만 하고 묻지 않는다. 돌려받은 노트 경로(또는 \"남길 것 없음\" · \"회고 규약 없음\")를 7단계 보고에 한 줄로 싣는다. 회고 규약은 `dev-skills-src\u002Fretro.md`다(`AGENTS.md` \"회고\"). `retro` 스킬이 없으면 건너뛰고 보고에 적는다. 노트 폴더는 베이스 체크아웃에 있어 워크트리 밖이다 — 쓰지 못하면(샌드박스 · 권한) 기다리지 않고 노트 본문을 7단계 보고에 싣는다.\n\n## 7. 보고\n\n무엇이 바뀌었나 · PR 링크 · 머지 커밋 · 성공 기준별 검증 · 리뷰 결과(\"독립 리뷰 없음\"이면 그대로) · 회고 노트 · 남은 사람 확인 · 워크트리 정리 남음을 한 덩어리로 말한다. 건너뛰거나 멈춘 단계는 그대로 말한다. develop에 쌓인 변화가 릴리즈할 만하면 `\u002Fship`을 권하기만 한다.\n","\u003C!-- 생성물이다. dev-skills-src\u002Fimplement\u002FSKILL.md 를 고치고 tools\u002Fgen-agents.sh 로 만든다 -->\n\n# implement — 작업 하나를 머지까지\n\n규칙(브랜치 · 워크트리 · 머지 권한 · 지우면 안 되는 것)은 `AGENTS.md`의 \"브랜치와 워크트리\" 절이 갖는다 — 여기는 절차만 갖는다.\n\n- **사람에게 묻는 곳은 계획 합의 한 번이다.** 그 뒤에는 머지 · 치우기까지 간다. 따로 멈추는 곳은 넷 — 대상 저장소의 Gradle 실행(`AGENTS.md` \"승인이 필요한 것\"), 합의한 성공 기준을 못 맞추거나 범위를 바꿔야 할 때(4단계 리뷰의 물을 것이 계획 · 범위 · 공개 계약 · 결정을 건드릴 때도), 리뷰 스킬이 설치돼 있는데 독립 리뷰어를 띄울 수 없을 때(4단계), 그리고 PR의 CI가 실패했을 때(5단계). 멈추면 무엇이 왜 어긋났는지 보고한다.\n- **워크트리를 만들고 지우는 것은 이 스킬 밖의 일이다** — 작업을 넘기는 쪽(사람이나 오케스트레이터)이 만들고, 머지 뒤에 지운다. 이 스킬은 그 워크트리 안에서만 돈다.\n- 상태는 git · GitHub에서 읽는다. 따로 적어 두는 파일이 없다 — 다시 불리면 0단계가 멈춘 자리를 찾는다.\n\n## 0. 어디서부터인가\n\n```sh\ngit rev-parse --abbrev-ref HEAD; git status --porcelain\ngit fetch -q origin\ngit rev-list --count origin\u002Fdevelop..HEAD\ngh pr list --head \"$(git rev-parse --abbrev-ref HEAD)\" --state all --json number,state,url\n```\n\n위에서부터 처음 맞는 줄로 간다.\n\n| 지금 | 간다 |\n|---|---|\n| 베이스 체크아웃 | 멈춘다 — 아래 \"베이스에서 불렸으면\" |\n| 워크트리, 이 브랜치의 PR이 `MERGED` | 6. 치우기 |\n| 워크트리, 열린 PR이 있다 | 5. 머지 |\n| 워크트리, `origin\u002Fdevelop` 위에 커밋이 있다 | 4. 리뷰 — 개발이 덜 끝났으면 3 |\n| 워크트리, 커밋이 없다 | 대화에 합의한 계획이 있으면 2, 없으면 1 |\n\n**베이스에서 불렸으면** 아무것도 만들지 않고, 이 작업의 워크트리를 먼저 만들어 그 안에서 다시 부르라고 알린다. 만드는 법으로 베이스에서 `git fetch -q origin` · `git worktree add .worktrees\u002F\u003C작업명> -b worktree-\u003C작업명> origin\u002Fdevelop`을 알려 준다.\n\n## 1. 계획 — 읽기만\n\n코드와 저장소 문서에서 사실을 먼저 확인한다. 재현이 필요하면 2단계의 빌드 뒤 이 워크트리의 `plugin\u002Fbin\u002Fprevue`로 본다 — 고치지 않는다.\n\n- **열린 결정이 있으면**(대안이 갈리거나 기준을 정해야 한다) 하나씩 정한다. 인자가 `grill`이면 늘 이쪽이다. `grilling` 스킬이 설치돼 있으면 그것으로 정하고 Prevue 규약은 부르는 여기가 넘긴다 — 없으면 대화로 하나씩 묻는다.\n  - 사실 확인 — 코드와 저장소 문서를 읽고 묻는다.\n  - 산출물 형식 — `[최종]`의 본문을 아래 한 화면 계획(무엇을 · 성공 기준 · 뺀 것)으로 쓴다.\n  - `[최종]`이 오면 그것이 합의다 — 다시 묻지 않고 2단계로 간다.\n- **없으면** 한 화면으로 보이고 \"진행할까요?\"를 받는다.\n\n```\n무엇을    \u003C바꾸는 것 한두 줄 · 고칠 자리>\n성공 기준  1. … (무엇으로 확인하나)  2. …\n뺀 것     … (이유)\n```\n\n합의가 이 스킬의 유일한 확인이다. 고쳐 달라면 고쳐 다시 보인다. 거절하면 아무것도 만들지 않고 멈춘다.\n\n## 2. 준비\n\n```sh\ngit log -1 --oneline                 # origin\u002Fdevelop 의 끝인지 본다 — 아니면 origin\u002FHEAD 가 main 이다(AGENTS.md 클론 직후)\n(cd plugin\u002Fdaemon && .\u002Fgradlew --offline installPrevue)    # 이 체크아웃의 plugin\u002Fbin\u002Fprevue 가 쓸 실행 파일. 스킬 · 문서만 고치면 건너뛴다\npython3 tools\u002Flint\u002Fviewer.py --deps 2>\u002Fdev\u002Fnull || npm ci --prefix viewer-src    # node_modules 는 git 밖이라 새 워크트리에 없다 — 없으면 tools\u002Flint.sh 가 종료 2로 멈춘다. 판정은 viewer.py 가 갖는다\n```\n\n## 3. 개발\n\n- **성공 기준마다 증거를 남긴다** — 무엇을 쳐서 무엇을 봤는지. 5단계의 검증 기록이 된다.\n  - 단위 테스트 `(cd plugin\u002Fdaemon && .\u002Fgradlew --offline test)` · CLI 판정 `python3 -m unittest discover -s tests\u002Fcli` · 스킬 두 벌 · `CLAUDE.md` `sh tools\u002Fgen-agents.sh --check`\n  - 통합 테스트 `(cd plugin\u002Fdaemon && .\u002Fgradlew --offline -q :daemon:integrationTest --tests …); echo \"gradle=$?\"; python3 tools\u002Ftest-summary.py` — `-q`면 결과가 출력에 없어 요약이 클래스별 tests · failures와 첫 실패 메시지를 찍는다. 판정은 `gradle=`이다 — 컴파일이 실패하면 태스크가 돌지 않아 요약은 지난 실행의 XML을 읽는다(시각 열로 보인다). 단위 테스트 결과는 `plugin\u002Fdaemon\u002Fdaemon\u002Fbuild\u002Ftest-results\u002Ftest`를 인자로 준다\n  - 렌더는 **이 워크트리의** `plugin\u002Fbin\u002Fprevue`로 본다(`AGENTS.md` \"브랜치와 워크트리\").\n  - 뷰어는 헤드리스 Chrome으로 본다. 모션 느낌 · Safari처럼 사람 눈이 필요한 것은 \"사람 확인 전\"으로 적어 두고 막지 않는다.\n- 사용자에게 보이는 변화는 `CHANGELOG.md` `[Unreleased]`에 적는다 — 무엇을 어떤 모양으로 쓰나, 외부 제보 · 기여를 어떻게 멘션하나는 `dev-skills-src\u002Frelease-notes.md`가 갖는다. 그 항목이 곧 GitHub Release 본문이다.\n- 검증장 · 대상 체크아웃은 `AGENTS.md` \"개발 위생\"을 따른다.\n- 커밋은 조각마다. 끝에 세션의 공동 저자 줄을 붙인다.\n\n## 4. 리뷰\n\n짠 쪽의 가정을 모르는 눈이 본다 — 리뷰어(`reviewer-\u003C등급>`)가 `review` 스킬과 이 저장소의 리뷰 규약(`dev-skills-src\u002Freview.md`, `AGENTS.md` \"리뷰\")으로 판정한다. 등급은 분류기가 고른다. 워크트리 루트에서 돌린다 — 규약 경로가 상대 경로다.\n\n**분류기를 돌리기 전에 파일이 있는지 본다**(아래 첫 줄). 없으면 `review` 스킬이 설치되지 않은 환경이다 — 이 단계를 건너뛰고 PR 본문과 7단계 보고에 \"독립 리뷰 없음\"을 적는다. 설치돼 있는데 리뷰어를 띄울 수 없으면 멈추고 독립 리뷰를 못 했다고 보고한다 — 자기 diff를 다시 읽는 것으로 대신하지 않는다.\n\n```sh\ntest -f ~\u002F.claude\u002Fskills\u002Freview\u002Fscripts\u002Freview_tier.py    # 실패하면 review 스킬이 없다 — 이 단계를 건너뛴다\npython3 ~\u002F.claude\u002Fskills\u002Freview\u002Fscripts\u002Freview_tier.py --range origin\u002Fdevelop..HEAD --config dev-skills-src\u002Freview.md\ngit merge-base origin\u002Fdevelop HEAD   # 기준 ref — 0단계의 fetch로 origin\u002Fdevelop이 앞서 나가도 이 작업분만 보게 SHA로 넘긴다\ngit rev-parse HEAD                   # 끝 커밋 — 리뷰 중에 고쳐도 범위가 흔들리지 않게 SHA로 고정한다\n```\n\n분류기 출력의 첫 줄이 등급, 둘째 줄부터 근거다.\n\n- **`skip`** — 바뀐 파일이 전부 규약의 건너뛰기 패턴에 맞는다. 리뷰어를 띄우지 않고 5단계로 간다.\n- **`medium` · `high` · `xhigh`** — 그 등급의 리뷰어에 위임한다. **종료 코드 2**(판정 못 함)면 `high`로 띄우고 stderr를 위임 프롬프트에 함께 넘긴다.\n\n위임 프롬프트에는 기준 ref(위 merge-base SHA) · 끝 커밋 SHA · 분류기 근거 줄 · 합의한 계획과 성공 기준 · 3단계 증거(무엇을 돌려 무엇을 봤나)를 넣는다.\n\n`Agent(subagent_type: \"reviewer-\u003C등급>\")`로 띄운다 — 리뷰어 정의가 effort와 `review` 스킬 로드를 고정한다. 서브에이전트 effort는 띄울 때 정해져, 안에서 로드한 스킬로는 바뀌지 않는다.\n\n결과를 이렇게 처리한다.\n\n- **고칠 것** — 고치거나, 고치지 않으면 이유를 PR 본문에 적는다. 고쳤으면 그 고침이 닿는 3단계 증거를 다시 본다.\n- **물을 것** — 계획 · 범위나 기존 공개 계약(CLI 출력 · 매니페스트)을 바꿔야 하거나, 결정(`D-\u003Cn>`)을 뒤집는 것이면 멈추고 묻는다. 나머지(API 모양 · 읽기 쉬움처럼 취향이 갈리는 것)는 리뷰어 추천안으로 처리하고 질문과 고른 것을 PR 본문에 적는다.\n- **머지 위험 줄**은 PR 본문에 옮긴다.\n\n## 5. 로컬 검증 → PR → 머지\n\n머지 관문은 둘이다 — 밀기 전에 마지막 커밋에서 돌리는 로컬 검증 다섯과, PR을 연 뒤 그 head에서 도는 CI(빌드 검증)의 성공. develop에는 필수 체크가 없어 서버가 막아 주지 않으므로 CI를 기다리는 것은 여기가 지킨다(`AGENTS.md`).\n\n```sh\nsh tools\u002Fgen-agents.sh --check     # 스킬 두 벌 · CLAUDE.md 가 원본과 같다\nsh tools\u002Fplugin-copies.sh --check   # plugin\u002F 의 LICENSE · NOTICE.md 가 루트 원본과 같다(D-123)\n\"$(command -v python3.9 || command -v python3)\" -m unittest discover -s tests\u002Fcli   # CI 는 python 3.9 — 있으면 그것으로 돌려 3.9에서만 깨지는 것을 밀기 전에 잡는다\n(cd plugin\u002Fdaemon && .\u002Fgradlew --offline test)   # 소스 · 빌드 파일을 안 건드렸으면(문서 · 스킬만) 건너뛴다\nsh tools\u002Flint.sh                     # Kotlin · 뷰어 날값 린트(D-70 · D-96) — 판단하지 말고 결과대로 고친다\n```\n\n하나라도 실패하면 고쳐 다시 돌린다. 통과한 결과(테스트 수)를 PR 본문의 검증 기록에 적는다.\n\n```sh\ngit push -u origin HEAD\ngh pr create --base develop --title \"\u003C무엇을 · 왜 한 줄>\" --body \"\u003C본문>\"   # 열린 PR이 이미 있으면(이어 가는 중) 밀기만 하고 건너뛴다\n```\n\n본문: 무엇을 · 왜, 성공 기준과 검증(여기가 원 기록이다), 리뷰 등급과 결과(고치지 않은 지적과 이유 · 추천안으로 처리한 물을 것 · 머지 위험, 건너뛰었으면 \"독립 리뷰 없음\"), 사람 확인이 남았으면 그것. 끝에 세션의 PR 서명 줄.\n\n- **develop이 앞서 충돌하면** `git fetch -q origin` · `git rebase origin\u002Fdevelop` 뒤 위의 로컬 검증을 다시 돌리고 `git push --force-with-lease`.\n\n**CI를 기다린다.** CI 결과가 나오기 전에는 머지 명령을 부르지 않는다.\n\n```sh\ngh pr checks \u003CN> --watch --fail-fast\n```\n\n\"빌드 검증\"(약 7~10분, job 시간 제한 20분이 기다림의 상한이다)이 초록이어야 한다. 막 연 PR은 체크가 아직 안 붙어 \"no checks\"로 끝나거나, `license\u002Fcla`만 붙은 채로 초록으로 끝날 수 있다 — 그래서 끝난 뒤의 아래 확인이 판정이다. 기다리는 사이 새 커밋을 밀었으면 앞 실행은 취소된다(`cancel-in-progress`) — 새 head의 실행을 다시 기다린다.\n기다림은 `run_in_background`로 돌리고 끝났다는 알림에 이어 간다(포그라운드 sleep은 막혀 있다).\n\n기다림이 끝나면 머지 직전에 `gh pr view \u003CN> --json headRefOid,statusCheckRollup`로 판정한다 — `statusCheckRollup`은 head 커밋의 체크다.\n\n- `headRefOid`가 기다림을 시작할 때의 `git rev-parse HEAD`와 다르거나, `build`가 아직 없거나 진행 중이면 조금 뒤 다시 기다린다.\n- head가 같고 `build`의 `conclusion`이 `SUCCESS`면 초록이다.\n- head가 같고 `build`의 `conclusion`이 `SUCCESS`가 아니면(`FAILURE` · `CANCELLED` · `SKIPPED` · `TIMED_OUT` 등) 실패다 — `gh pr checks`가 종료 0으로 끝났어도 그렇다.\n\n**실패하면 머지하지 않고 멈춘다.** 어느 job · 어느 스텝이 무엇으로 실패했는지(`gh run view \u003Cid> --log-failed`의 요지) 보고한다. 로컬 검증이 통과했는데 CI만 실패했다면 macOS에서만 통과하는 것(Ubuntu · `sh`)일 수 있다 — 그 짐작도 함께 적되 고치지는 않는다. 다시 불려 고친 커밋이 있으면 4단계 리뷰어를 수정 확인으로 띄운다 — 분류기에 `--range \u003CCI가 실패한 head>..HEAD --recheck`(곧 `medium`)를 주고, 위임 프롬프트의 직전 결과 자리에는 CI 실패 요지를 넘긴다. 그다음 이 단계의 로컬 검증부터 다시 돌아 민 뒤 CI를 기다린다.\n\n초록이면 PR 본문의 성공 기준 결과 · 검증 기록(CI 실행 링크 포함)을 채우고 머지한다.\n\n```sh\ngh pr merge \u003CN> --squash             # --delete-branch 를 붙이지 않는다\n```\n\n## 6. 치우기 — 이 작업의 것만\n\n다른 워크트리는 머지됐어도 건드리지 않는다 — 다른 세션이 쓰고 있을 수 있다.\n\n```sh\ngh pr view \u003CN> --json state -q .state     # MERGED 일 때만 아래로\nplugin\u002Fbin\u002Fprevue stop --mine\ngit ls-remote --exit-code --heads origin \u003C브랜치> && git push origin --delete \u003C브랜치>    # 이미 지웠으면 건너뛴다\n```\n\n워크트리와 로컬 브랜치는 지우지 않는다 — 이 세션이 그 안에 있고, 만든 쪽이 지운다. 7단계 보고에 \"워크트리 정리 남음 — \u003C워크트리 경로>\"를 적는다.\n\n**회고 남기기.** 치운 뒤 보고 전에 `retro` 스킬을 **남기기**로 로드한다 — 이 세션에서 환경 탓에 헤맨 자리를 기록만 하고 묻지 않는다. 돌려받은 노트 경로(또는 \"남길 것 없음\" · \"회고 규약 없음\")를 7단계 보고에 한 줄로 싣는다. 회고 규약은 `dev-skills-src\u002Fretro.md`다(`AGENTS.md` \"회고\"). `retro` 스킬이 없으면 건너뛰고 보고에 적는다. 노트 폴더는 베이스 체크아웃에 있어 워크트리 밖이다 — 쓰지 못하면(샌드박스 · 권한) 기다리지 않고 노트 본문을 7단계 보고에 싣는다.\n\n## 7. 보고\n\n무엇이 바뀌었나 · PR 링크 · 머지 커밋 · 성공 기준별 검증 · 리뷰 결과(\"독립 리뷰 없음\"이면 그대로) · 회고 노트 · 남은 사람 확인 · 워크트리 정리 남음을 한 덩어리로 말한다. 건너뛰거나 멈춘 단계는 그대로 말한다. develop에 쌓인 변화가 릴리즈할 만하면 `\u002Fship`을 권하기만 한다.\n",{"name":5,"description":7},"main","367545866c18ddac4a3e1f9530ba98859ee3c38f",".claude\u002Fskills\u002Fimplement",5,"https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue","https:\u002F\u002Fgithub.com\u002Fkakao","http:\u002F\u002Ftech.kakao.com\u002F","2026-11-14 00:17:09",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add kakao\u002Fprevue --skill implement",{"tool":37,"command":38},"bunx","bunx skills add kakao\u002Fprevue --skill implement",{"tool":40,"command":41},"pnpm","pnpm dlx skills add kakao\u002Fprevue --skill implement","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fimplement\u002FSKILL.md",true,[],[46,53,58,63,70,75],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M7FCGENPWS39YTT1D0F5FEP9","prevue","Renders Jetpack Compose @Preview in the browser, lets you edit it and check the result yourself, and reads what a person points at on screen as a file and line. Use it when changing Compose UI or matching it to a mockup or screenshot, when asked \"how does it look\", and when the user points at something on screen with words like \"this\" or \"here\". Also use it when asked whether the preview is ready (\"is the preview ready?\") or told to prepare the preview (read the build settings).","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fskills-src\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":54,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7FCG8E29RWQS0Z3PB1K93RJ","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fcodex\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":59,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M7FCG33JZFA79RGK0TFXZCKS","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fclaude\u002Fprevue\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M7FCFZMPWT3EQZ5Y130QTS23","ship","Prevue를 릴리즈한다. 버전 커밋을 develop에 올려 develop → main PR 하나를 열고, CI와 스킬 평가가 나란히 통과하면 머지(=배포)하고, 태그·GitHub Release를 남긴다. 사용자가 릴리즈·배포를 지시할 때만 쓴다(\u002Fship, \u002Fship 0.11.0). 멈춘 자리부터 이어 간다.","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fdev-skills-src\u002Fship\u002FSKILL.md",[],[],{"skillNo":71,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7FCFSE4ER2EJ9A47C9FYWZV","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002Fdev-skills-src\u002Fimplement\u002FSKILL.md",[],[],{"skillNo":76,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7FCFP4D2WNZRN8G2F9AJC2W","https:\u002F\u002Fgithub.com\u002Fkakao\u002Fprevue\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fship\u002FSKILL.md",[],[]]