@decencia/ch-cli 1.21.0 → 1.22.0

package/agent/2t-decencia-channel-issue-coder.md

@@ -3,7 +3,7 @@ name: 2t-decencia-channel-issue-coder
 description: GitHub issue 1개를 입력으로 받아 끝까지 처리하는 코딩 에이전트. 이슈 읽기 → 소통채널 spec/SQA 확인 → git worktree+브랜치에서 구현 → 자체 소프트리뷰 루프 → unittest + SQA → PR 생성 → 소통채널 workStatus·이슈 기록. 다수 병렬 실행 전제, PR까지만(머지·base 브랜치 직접 push·이슈 close는 사람).
 tools: Read, Write, Edit, Grep, Glob, Bash, Agent
 model: opus
-version: 1.21.0
+version: 1.22.0
 ---
 
 ## 역할

package/agent/2t-decencia-channel-pr-merger.md

@@ -3,7 +3,7 @@ name: 2t-decencia-channel-pr-merger
 description: issue-coder가 낸 PR을 기본 완전 자율로 base 브랜치(기본 브랜치 또는 sprint 통합 브랜치)에 머지하는 에이전트. 핵심 역량은 다수 병렬 worktree가 만든 충돌을 작업 의도 기반(semantic)으로 해결하는 것. CI green+충돌없음이면 바로 squash 머지, 충돌이면 의도대로 해결 후 테스트로 검증하여 머지. 재SQA·전면 재리뷰는 하지 않음. 다수 PR은 직렬 머지.
 tools: Read, Write, Edit, Grep, Glob, Bash
 model: opus
-version: 1.21.0
+version: 1.22.0
 ---
 
 ## 역할

package/agent/2t-decencia-channel-terraformer.md

@@ -3,7 +3,7 @@ name: 2t-decencia-channel-terraformer
 description: 소통채널을 쓰지 않던 기존 코드베이스를 역분석하여 소통채널 프로젝트로 편입(terraforming)하는 자율 에이전트. 코드가 single source of truth — 코드를 읽어 DB 스키마 → 기능명세(spec) → PRD를 bottom-up으로 역생성한다(SQA 제외). 대량 분석은 서브에이전트 병렬, 코드로 못 메우는 의도는 [추정]으로 채우고 "사람확인 질문 리스트"를 산출물로 남긴다. PR/머지·이슈 발행은 하지 않음.
 tools: Read, Write, Edit, Grep, Glob, Bash, Agent
 model: opus
-version: 1.21.0
+version: 1.22.0
 ---
 
 ## 역할

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Decencia Communication Channel CLI",
   "main": "dist/index.js",
   "bin": {

package/skill/2t-decencia-channel-change-manager/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-change-manager
 description: 기존 소통채널 프로젝트의 기능 추가/수정을 사용자와 대화로 명확화 → 전파 스킬로 연관 PRD/spec/DB/SQA 일괄 갱신 → 변경으로 생긴 새 할일을 GitHub 이슈로 발행하는 오케스트레이터 스킬. (1)대화로 변경 내용 확정 → (2)[게이트] 영향 범위 확인 후 전파 적용 → (3)[게이트] 할일 목록 확인 후 이슈 발행. "이 기능 바꿀래"·"기획 수정"·"이거 추가해줘(기존 프로젝트)" 류 요청 시.
 allowed-tools: Bash(ch:*) Bash(git:*) Bash(gh:*) Read Write
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->
@@ -85,6 +85,7 @@ ch check
 - `2t-decencia-channel-change-propagation-v2`로 **영향 분석**: 이 변경이 닿는 PRD·spec(ui·logic·dbTableRefs·points)·**screens(route·목적·접근권한·relatedSpecIds)**·db-schema/db-tables·SQA·workStatus를 빠짐없이 식별.
 - → **[게이트] 영향 범위를 사용자에게 제시하고 확인받는다** (어떤 문서가 어떻게 바뀌는지 요약). **붙는 화면 / 새로 생기는 화면**도 요약에 포함한다. 승인 전에는 문서를 건드리지 않는다.
 - 승인되면 전파 스킬 절차대로 **연관 문서를 순차 갱신**. `spec.dbTableRefs` ↔ `dbTable.relatedSpecIds` 양방향 동기화 유지.
+- 전파로 **화면이 바뀌었으면** 디자이너에게 안내한다: 바뀐 화면은 **핸드오프를 다시 받아** Claude Design에 재투입한다(핸드오프는 매번 최신 화면에서 새로 생성된다). 웹 [통합 핸드오프 zip 받기] / `ch handoff export --dir`, 화면 하나면 화면 상세 [이 화면 프롬프트 복사] / `ch handoff screen <화면id>`. 절차는 `docs/design-handoff-sop.md`.
 
 ## 3. 할일 → GitHub 이슈 (게이트 ②)
 *(기획 변경이면 전파 적용 후, 버그면 §1.5 직후)*

package/skill/2t-decencia-channel-change-propagation-v2/SKILL.md

@@ -10,7 +10,7 @@ description: |
   (3) 명세·DB·SQA가 서로 어긋나 있는 의심이 들 때 (정합성 점검),
   (4) PRD 갱신 후 하위 spec/db/SQA로 변경분을 흘려보내야 할 때,
   (5) Sprint 진행 중 도메인 규칙·스키마가 흔들렸을 때 연쇄 갱신이 필요할 때.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-cli-v2/SKILL.md

@@ -10,7 +10,7 @@ description: |
   (4) ch screens 명령(list/get/create/update/delete/migrate)으로 화면을 다루거나 레거시 프로젝트를 화면 모드로 이관할 때,
   (5) spec의 화면 연결을 CLI로 걸거나 풀 때 (`ch specs screen-refs`),
   (6) Spec ID를 JIRA 스타일(`LOGIN-001`)로 직접 지정할 때 (`ch specs create --id`).
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->
@@ -324,6 +324,21 @@ ch screens migrate --rollback --force            # 되돌아갈 route가 없어
 - **쓰기 순서**: 화면 생성 → 명세 연결 → `screensEnabled=true`(항상 마지막). 중간에 실패하면 플래그가 꺼진 채 남아 프로젝트는 레거시 모드 그대로다.
 - `--dry-run`은 계획만 낸다(쓰기 0건). 단, 계획을 서버 데이터로 계산하므로 **읽기 요청은 나간다** — 다른 커맨드의 `--dry-run`과 다른 점이다.
 
+## handoff 명령 (디자인 핸드오프)
+
+화면(screens)을 **디자이너용 화면 기획 묶음**으로 내보낸다. **읽기 전용 파생**이다 — 새로 저장하는 데이터가 없다. 생성 로직은 ch-api 단일 생성원이고 웹 버튼·CLI는 그 결과를 **배달만** 한다(웹·CLI에 별도 이미터 없음).
+
+```bash
+ch handoff export --dir <폴더>   # 통합 핸드오프 파일셋을 그 폴더에 기록
+ch handoff screen <화면id>       # 화면 하나의 프롬프트를 stdout으로 출력
+```
+
+- `ch handoff export --dir <폴더>` — `00-제품개요.md`(PRD content) · `01-화면지도.md`(화면 IA 트리) · `02-{NN}-{epic}.md × N`(epic별 화면 카드)를 그 폴더에 쓴다. **웹 화면 탭 [통합 핸드오프 zip 받기]와 같은 파일셋**이다. `NN`은 그 epic 소속 화면의 최소 order다. 총 파일 수 = 2 + (화면 있는 epic 수).
+- `ch handoff screen <화면id>` — 화면 하나의 카드 마크다운을 stdout으로 낸다. **웹 화면 상세 [이 화면 프롬프트 복사]와 같은 내용**이다. 없는 화면 id면 오류로 끝난다.
+- **레거시 가드**: `screensEnabled` 미설정(화면 0개) 프로젝트면 `screenCount:0`으로 **안내 후 중단**한다. 빈 폴더·빈 파일·크래시를 만들지 않는다.
+- 화면 카드에 담기는 것: 이름·route·접근권한 · 목적 · 화면 상태 · 진입/이탈 · 핵심 액션 · 필수 표시 정보 · 요소별 인터랙션. 한 화면에 명세가 여럿이면 `### 출처: <specId>`로 묶는다. 색·폰트·톤·DB 컬럼·구현 경로는 **일부러 뺀다**(디자인 입력에 불필요).
+- **정본 분리**: 이 섹션이 **명령 정본**(에이전트·개발자용)이다. 디자이너용 단계별 절차서(비전공자 온보딩)는 `docs/design-handoff-sop.md`가 정본이다. 절차를 여기서 중복 서술하지 않는다.
+
 ## 4. 운영 팁
 
 - Windows 한글 출력이 비어 보일 때: `ch specs get <id> --json | Out-File spec.json` (PowerShell)

package/skill/2t-decencia-channel-db-schema-v2/SKILL.md

@@ -8,7 +8,7 @@ description: |
   (2) DB 테이블 단위로 컬럼·인덱스·보안규칙을 등록·수정할 때,
   (3) 새 테이블을 추가하면서 전체 인벤토리도 함께 업데이트할 때,
   (4) spec.dbTableRefs와 양방향 동기화가 필요한 작업 시.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-github-issue/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-github-issue
 description: gh CLI로 현재 repo에 GitHub 이슈를 작성한다. 이슈 1개=유형 1개(feat/fix/bug), 표준 본문 양식(작업내용·관련 명세 백링크·완료조건)으로 발행. "이슈 만들어줘"/"깃헙 이슈로 등록해줘" 요청 시, 또는 소통채널 기획·명세 작업 후 처리할 일들을 GitHub 이슈로 옮길 때 사용. 멱등성/중복방지·확인단계는 다루지 않음(요청대로 바로 생성).
 allowed-tools: Bash(gh:*) Bash(git:*) Read Write
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-orchestrator/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-orchestrator
 description: 소통채널 작업의 단일 진입점(디스패처). 사용자 요청을 듣고 7종(bootstrap·terraformer·change-manager·github-issue·issue-coder·pr-merger·sprint-runner) 중 적절한 곳으로 라우팅하고, 필요하면 여러 단계를 순차 오케스트레이션한다. 대화형 스킬은 메인 세션에서 Skill로, 자율 에이전트는 Agent로 위임. "소통채널 작업 해줘"·"이거 어떻게 처리하지?"처럼 무엇부터 할지 모를 때, 또는 신규기획/코드편입/기획변경/이슈/구현/머지/스프린트실행 어디로든 시작할 때.
 allowed-tools: Skill Agent Read Bash(ch:*) Bash(gh:*) Bash(git:*)
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->
@@ -58,6 +58,7 @@ ch check
 - "이 레포 소통채널에 올리고 스프린트도 짜줘" → 2 terraformer(Agent) → 끝나면 `2t-decencia-channel-sprint-builder-v2`(Skill).
 - "로그인에 SNS 추가하고 개발까지" → 3 change-manager(Skill, 전파+이슈 발행) → 발행된 이슈로 5 issue-coder(Agent, 병렬) → PR 나오면 6 pr-merger(Agent, 직렬).
 - "스프린트 N 개발 진행해줘"(한 Sprint 통째) → **7 sprint-runner**(Skill). 4(발행)·5(구현)·6(머지)를 **내부에서 묶어** 돌리고 사람확인에서 멈춘다 → 수동으로 4→5→6 나열하지 말고 7로 보낸다.
+- "화면까지 다 짰고 이제 디자인 넘긴다" → **라우트가 아니다.** 디자이너가 웹 화면 탭 [통합 핸드오프 zip 받기] 또는 `ch handoff export --dir`로 화면 기획 묶음을 받아 Claude Design에 넣는다(절차 `docs/design-handoff-sop.md`, 명령 정본 [[2t-decencia-channel-cli-v2]]). 읽기전용 export라 위임할 대화형 스킬·자율 에이전트가 없다 — 이 단계는 **안내만** 한다.
 - 한 단계의 산출물(projectId·이슈번호·PR번호)을 다음 단계 입력으로 넘긴다.
 
 ## 경계/주의

package/skill/2t-decencia-channel-prd-v2/SKILL.md

@@ -7,7 +7,7 @@ description: |
   (1) PRD를 작성하거나 갱신할 때,
   (2) PRD 구성에서 Epic/스토리 구조를 후속 spec 작성에 매핑할 때,
   (3) Read-before-Write 규칙으로 PRD content를 안전하게 수정해야 할 때.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-project-bootstrap/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-project-bootstrap
 description: 신규 기획을 사용자와 대화하며 step-by-step으로 소통채널 프로젝트로 만드는 오케스트레이터 스킬. (1)대화로 PRD 완성 → (2)기능명세(spec) 내용 확정 → (3)DB 스키마 → (4)spec 업로드 → (5)화면 구성·연결 → (6)SQA 시트. 각 단계 사용자 승인 게이트, 작성 디테일은 기존 2t-decencia-channel-*-v2 스킬을 적극 재사용. "새 기획 만들어줘"·"프로젝트 처음부터 세팅" 류 요청 시.
 allowed-tools: Bash(ch:*) Bash(git:*) Read Write
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->
@@ -199,6 +199,9 @@ ch specs screen-refs PROJ-002 --screens SCR-PROJECTS,SCR-PROJECT-DETAIL   # 화
 *(화면 연결 후에만)*
 - `2t-decencia-channel-sqa-v2`로 SQA 작성: **A축**(명세별 기능 TC — 영역별 번들에서 도출) + **B축**(비기능 표준 40).
 
+### 디자인 핸드오프로 이어가기 (안내만)
+화면이 다 짜였으면 **디자인 핸드오프**로 넘어갈 수 있다. 디자이너가 웹 화면 탭 **[통합 핸드오프 zip 받기]** 또는 `ch handoff export --dir <폴더>`로 화면 기획 묶음을 받아 Claude Design에 넣는다. 절차는 `docs/design-handoff-sop.md`. 읽기전용 export라 이 스킬이 대신 실행하지 않는다 — 화면이 막 만들어진 이 지점에서 **사용자에게 안내만** 한다. (명령 상세는 [[2t-decencia-channel-cli-v2]] handoff 명령.)
+
 ---
 
 ## 업로드 주의 (전 단계 공통)

package/skill/2t-decencia-channel-spec-v2/SKILL.md

@@ -11,7 +11,7 @@ description: |
   (2) UI 메타데이터·비즈니스 로직·DB 참조를 함께 다룰 때,
   (3) Story 규모를 Story Point(`--points`)로 매길 때,
   (4) 신규 spec ID를 `LOGIN-001` 같은 JIRA 스타일로 부여하고 싶을 때 (`ch specs create --id`).
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-sprint-builder-v2/SKILL.md

@@ -7,7 +7,7 @@ description: |
   (1) sprint를 구성할 때,
   (2) Σ spec.points 기반 sprint 용량 산정이 필요할 때,
   (3) Epic·도메인·의존성을 함께 고려해 spec을 sprint에 배분할 때.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-sprint-runner/SKILL.md

@@ -2,7 +2,7 @@
 name: 2t-decencia-channel-sprint-runner
 description: 특정 Sprint를 끝까지 실행(run)하는 오케스트레이터 스킬. Sprint의 spec을 시드로 이슈 목록을 분해·발행(github-issue)하고, GitHub milestone에 묶인 이슈를 상태별로 분류해 issue-coder(병렬)·pr-merger(직렬)로 전진시킨 뒤, 사람확인이 필요한 곳에서 멈춘다. 사람이 확인·체크 후 재호출하면 멱등하게 이어간다(반복 루프). "스프린트 돌려줘"·"sprint N 실행"·"이 스프린트 개발 진행해줘" 류 요청 시.
 allowed-tools: Skill Agent Read Bash(ch:*) Bash(gh:*) Bash(git:*)
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-sqa-v2/SKILL.md

@@ -12,7 +12,7 @@ description: |
   (4) 명세 영역별 완성형 TC 번들(퍼블리싱/프론트/백엔드 디센시아 운영 관점 포함)을 가져다 쓸 때,
   (5) 새 명세 작업 중 반복 패턴을 발견해 영역별 번들을 보강할 때,
   (6) Sprint 종료 전 spec별 SQA 통과 여부를 점검할 때.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->

package/skill/2t-decencia-channel-work-status-v2/SKILL.md

@@ -8,7 +8,7 @@ description: |
   (2) "작업 현황 적어줘", "workStatus 갱신해줘" 요청 시,
   (3) Sprint 종료 회고나 인수인계용으로 spec별 진행 상태를 정리할 때,
   (4) `ch specs update --work-status` 또는 웹 "작업 현황" 탭에서 갱신할 때.
-version: 1.21.0
+version: 1.22.0
 ---
 
 <!-- ch-version-gate -->