@decencia/ch-cli 1.6.3 → 1.8.0

package/dist/utils.d.ts

@@ -1,9 +1,48 @@
 export declare function parseCommaSeparated(value: string): string[];
+/**
+ * content류(자유 텍스트/마크다운) 문자열을 정규화합니다.
+ * - 선행 BOM() 제거
+ * - CRLF(\r\n) / 고립 CR(\r) → LF(\n) 정규화 (PowerShell Out-File·Windows 호환)
+ *
+ * 업로드되는 본문은 항상 이 함수를 거쳐 일관된 LF 줄바꿈으로 전송합니다.
+ */
+export declare function normalizeContent(raw: string): string;
 /**
  * JSON 파일을 읽어 파싱합니다.
- * - BOM() 제거
- * - CRLF/CR을 LF로 정규화 (PowerShell Out-File 호환)
+ * - BOM() 제거 + CRLF/CR을 LF로 정규화 (PowerShell Out-File 호환)
  * - 파일 미존재/파싱 실패 시 명확한 에러 throw
  */
 export declare function readJsonFile<T = unknown>(filePath: string, label?: string): T;
+/**
+ * 파일 경로에서 content를 읽어 정규화합니다.
+ * - 파일 미존재/읽기 실패 시 명확한 에러 throw
+ * - normalizeContent로 BOM/CRLF 정규화
+ */
+export declare function readContentFile(filePath: string, label?: string): string;
+/**
+ * stdin(파이프)에서 content를 동기적으로 읽어 정규화합니다.
+ * TTY(대화형 터미널)면 입력이 없는 것으로 보고 null을 반환합니다(무한 대기 방지).
+ */
+export declare function readContentStdin(): string | null;
+export interface ContentInputOptions {
+    /** --file <경로>: 파일에서 content 읽기 (최우선) */
+    file?: string;
+    /** --content <문자열>: 인자로 직접 전달된 content */
+    content?: string;
+}
+/**
+ * content류 입력을 우선순위에 따라 해석합니다.
+ *
+ * 우선순위: --file > --content > stdin(파이프)
+ * - --file 지정 시: 파일을 읽어 정규화(미존재/읽기 실패는 throw).
+ * - --content 지정 시: 그 문자열을 정규화.
+ * - 둘 다 없으면 stdin(파이프) 입력을 시도하고, 그것도 없으면 undefined.
+ *
+ * 어떤 경로든 결과 content는 BOM 제거 + CRLF→LF 정규화되어
+ * Windows 인자길이 한계로 인한 무음 절단을 방지합니다.
+ *
+ * @param label 에러 메시지에 붙일 옵션명(예: '--file')
+ * @returns 정규화된 content 문자열, 입력이 없으면 undefined
+ */
+export declare function readContentInput(opts: ContentInputOptions, label?: string): string | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAyB7E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAoB7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAaxE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAchD;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,EACzB,KAAK,SAAW,GACf,MAAM,GAAG,SAAS,CAYpB"}

package/dist/utils.js

@@ -34,16 +34,35 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCommaSeparated = parseCommaSeparated;
+exports.normalizeContent = normalizeContent;
 exports.readJsonFile = readJsonFile;
+exports.readContentFile = readContentFile;
+exports.readContentStdin = readContentStdin;
+exports.readContentInput = readContentInput;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 function parseCommaSeparated(value) {
     return value.split(',').map((v) => v.trim()).filter(Boolean);
 }
+/**
+ * content류(자유 텍스트/마크다운) 문자열을 정규화합니다.
+ * - 선행 BOM() 제거
+ * - CRLF(\r\n) / 고립 CR(\r) → LF(\n) 정규화 (PowerShell Out-File·Windows 호환)
+ *
+ * 업로드되는 본문은 항상 이 함수를 거쳐 일관된 LF 줄바꿈으로 전송합니다.
+ */
+function normalizeContent(raw) {
+    let text = raw;
+    // BOM 제거
+    if (text.charCodeAt(0) === 0xfeff) {
+        text = text.slice(1);
+    }
+    // CRLF/CR → LF 정규화
+    return text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
 /**
  * JSON 파일을 읽어 파싱합니다.
- * - BOM() 제거
- * - CRLF/CR을 LF로 정규화 (PowerShell Out-File 호환)
+ * - BOM() 제거 + CRLF/CR을 LF로 정규화 (PowerShell Out-File 호환)
  * - 파일 미존재/파싱 실패 시 명확한 에러 throw
  */
 function readJsonFile(filePath, label) {
@@ -59,12 +78,7 @@ function readJsonFile(filePath, label) {
     catch (e) {
         throw new Error(`${tag}파일 읽기 실패: ${resolved} (${e?.message ?? e})`);
     }
-    // BOM 제거
-    if (raw.charCodeAt(0) === 0xfeff) {
-        raw = raw.slice(1);
-    }
-    // CRLF/CR → LF 정규화
-    raw = raw.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    raw = normalizeContent(raw);
     try {
         return JSON.parse(raw);
     }
@@ -72,4 +86,71 @@ function readJsonFile(filePath, label) {
         throw new Error(`${tag}JSON 파싱 실패: ${resolved} (${e?.message ?? e})`);
     }
 }
+/**
+ * 파일 경로에서 content를 읽어 정규화합니다.
+ * - 파일 미존재/읽기 실패 시 명확한 에러 throw
+ * - normalizeContent로 BOM/CRLF 정규화
+ */
+function readContentFile(filePath, label) {
+    const resolved = path.resolve(filePath);
+    const tag = label ? `${label} ` : '';
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`${tag}파일을 찾을 수 없습니다: ${resolved}`);
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(resolved, 'utf-8');
+    }
+    catch (e) {
+        throw new Error(`${tag}파일 읽기 실패: ${resolved} (${e?.message ?? e})`);
+    }
+    return normalizeContent(raw);
+}
+/**
+ * stdin(파이프)에서 content를 동기적으로 읽어 정규화합니다.
+ * TTY(대화형 터미널)면 입력이 없는 것으로 보고 null을 반환합니다(무한 대기 방지).
+ */
+function readContentStdin() {
+    if (process.stdin.isTTY) {
+        return null;
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(0, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    if (raw.length === 0) {
+        return null;
+    }
+    return normalizeContent(raw);
+}
+/**
+ * content류 입력을 우선순위에 따라 해석합니다.
+ *
+ * 우선순위: --file > --content > stdin(파이프)
+ * - --file 지정 시: 파일을 읽어 정규화(미존재/읽기 실패는 throw).
+ * - --content 지정 시: 그 문자열을 정규화.
+ * - 둘 다 없으면 stdin(파이프) 입력을 시도하고, 그것도 없으면 undefined.
+ *
+ * 어떤 경로든 결과 content는 BOM 제거 + CRLF→LF 정규화되어
+ * Windows 인자길이 한계로 인한 무음 절단을 방지합니다.
+ *
+ * @param label 에러 메시지에 붙일 옵션명(예: '--file')
+ * @returns 정규화된 content 문자열, 입력이 없으면 undefined
+ */
+function readContentInput(opts, label = '--file') {
+    if (opts.file !== undefined) {
+        return readContentFile(opts.file, label);
+    }
+    if (opts.content !== undefined) {
+        return normalizeContent(opts.content);
+    }
+    const stdin = readContentStdin();
+    if (stdin !== null) {
+        return stdin;
+    }
+    return undefined;
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,kDAEC;AAQD,oCAyBC;AAtCD,uCAAyB;AACzB,2CAA6B;AAE7B,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAc,QAAgB,EAAE,KAAc;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,aAAa,QAAQ,KAAK,CAAC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,SAAS;IACT,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QACjC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,mBAAmB;IACnB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,eAAe,QAAQ,KAAK,CAAC,EAAE,OAAO,IAAI,CAAC,GAAG,CACrD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.6.3",
+  "version": "1.8.0",
   "description": "Decencia Communication Channel CLI",
   "main": "dist/index.js",
   "bin": {
@@ -15,7 +15,7 @@
     "build": "node scripts/sync-skill-version.js && tsc",
     "dev": "tsc --watch",
     "start": "node dist/index.js",
-    "test": "npm run build && node test/output.printKeyValue.test.js",
+    "test": "npm run build && node test/run-all.js",
     "sync-skill-version": "node scripts/sync-skill-version.js",
     "prepublishOnly": "npm run build"
   },

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.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->

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.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -8,7 +8,7 @@ description: |
   (2) Task에 description/points/completedAt을 기록할 때,
   (3) ch db-tables 명령(list/get/create/update/delete)을 사용할 때,
   (4) Spec ID를 JIRA 스타일(`LOGIN-001`)로 직접 지정할 때 (`ch specs create --id`).
-version: 1.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->

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

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

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.6.3
+version: 1.8.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)+DB스키마 → 승인 → (3)SQA 시트. 각 단계 사용자 승인 게이트, 작성 디테일은 기존 2t-decencia-channel-*-v2 스킬을 적극 재사용. "새 기획 만들어줘"·"프로젝트 처음부터 세팅" 류 요청 시.
 allowed-tools: Bash(ch:*) Bash(git:*) Read Write
-version: 1.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -10,7 +10,7 @@ description: |
   (2) UI 메타데이터·비즈니스 로직·DB 참조를 함께 다룰 때,
   (3) Task를 JIRA 스타일(points·assignee·description·completedAt)로 잘게 쪼갤 때,
   (4) 신규 spec ID를 `LOGIN-001` 같은 JIRA 스타일로 부여하고 싶을 때 (`ch specs create --id`).
-version: 1.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -7,7 +7,7 @@ description: |
   (1) sprint를 구성할 때,
   (2) Story Point 합산 기반 sprint 용량 산정이 필요할 때,
   (3) Epic·도메인·의존성을 함께 고려해 spec을 sprint에 배분할 때.
-version: 1.6.3
+version: 1.8.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.6.3
+version: 1.8.0
 ---
 
 <!-- ch-version-gate -->
@@ -26,7 +26,7 @@ ch check
 이 스킬은 **라우터/오케스트레이터**다 — 실제 발행은 `github-issue` 스킬, 구현은 `issue-coder` 에이전트, 머지는 `pr-merger` 에이전트가 한다. **중복 서술하지 않고 위임만** 한다.
 
 핵심 성질:
-- **자체 상태를 두지 않는다.** GitHub(이슈 open/close·PR·milestone)가 SSOT. 매 호출마다 현재 상태를 읽어 **한 칸씩 전진**시키는 멱등 스킬.
+- **자체 상태를 두지 않는다.** 이슈의 open/close, PR, milestone, 그리고 `sprint-<id>` 브랜치까지 GitHub가 SSOT다. 스킬은 매 호출마다 현재 상태를 읽어 한 칸씩 전진시키는 멱등 스킬이다. 로컬 worktree는 상태가 아니라 원격을 받아 보는 복사본일 뿐이다.
 - **사람확인이 끼는 대화형**이라 메인 세션에서 돈다(자율 에이전트로 던지지 않음). 단, 구현·머지 같은 **자율 작업은 `Agent`로 위임**.
 
 ## 입력
@@ -36,16 +36,26 @@ ch check
 ## 전제 (시작 시 확인)
 - 인증: `gh auth status`, `ch auth status` — 미인증이면 중단하고 안내(`gh auth login` / `ch auth login`).
 - `.ch-project`에서 `projectId` 확보.
+- 기본 브랜치는 하드코딩하지 않고 감지한다. `gh repo view --json defaultBranchRef -q .defaultBranchRef.name`로 구하고, 실패하면 `git symbolic-ref --short refs/remotes/origin/HEAD`에서, 그래도 없으면 `main`을 먼저 그다음 `master`를 쓴다. 이렇게 하면 repo가 `main`이든 `master`든 그대로 대응한다.
 - **이 스킬은 로컬 `gh`(사람 인증)로 동작한다 — PAT 불필요.** (PAT는 대시보드[ch-api] 전용)
 
 ## 공통 규약 (다른 컴포넌트와 공유 — 깨지면 안 됨)
 | 규약 | 값 |
 |---|---|
 | Sprint ↔ 이슈 묶음 | **GitHub `milestone`** (sprint 1개 = milestone 1개) |
+| Sprint 통합 브랜치 | **`sprint-<id>`** (원격) — 이 sprint의 모든 이슈 PR이 모이는 base 브랜치. 원격이 정본이고 기본 브랜치로 곧장 머지하지 않는다 |
 | 이슈 ↔ spec | 이슈 본문 `## 관련 명세` specid 백링크 (**없어도 됨** = 인프라 등 비-spec 작업) |
 | 사람확인 항목 | **소통채널 DB가 SSOT** — issue-coder가 `ch github checklist set` 으로 등록, 사람이 웹 실행 탭에서 체크·메모, pr-merger가 `ch github checklist get` 으로 close 판단 (GitHub 코멘트 아님) |
 | 이슈 ↔ spec **status** | 착수=`developing`(coder), PR=`testing`(coder), **completed=러너가 롤업**(그 spec 백링크 이슈 전부 DONE일 때만) |
 
+## 브랜치와 worktree 운영
+
+이 sprint의 모든 이슈는 `sprint-<id>`라는 통합 브랜치 하나에 모은다. 이 브랜치는 원격에 있는 것이 정본이며, 어떤 이슈도 기본 브랜치로 곧장 머지하지 않는다.
+
+통합 브랜치를 체크아웃한 worktree를 로컬에 하나 둔다. 이슈가 머지될 때마다 이 worktree를 원격과 동기화하고, 여기서 dev 서버를 띄워 통합 결과를 테스트하고 검토한다. 코드 작성은 이 worktree에서 하지 않는다.
+
+issue-coder는 이슈마다 `sprint-<id>`에서 새 브랜치를 따 자기 worktree에서 구현하며, 그 PR이 머지되고 나면 해당 worktree를 정리한다.
+
 ---
 
 ## 절차
@@ -58,6 +68,8 @@ ch check
 
 ### 2. milestone 준비 + 멱등 발행
 - 이 Sprint의 **milestone 확보**: `gh api repos/{owner}/{repo}/milestones`로 조회, 없으면 생성(이름 = Sprint명/`sprint-<id>`).
+- 이 sprint의 **통합 브랜치 `sprint-<id>`를 확보한다.** 원격에 없으면 감지한 기본 브랜치에서 만들어 push하고, 이미 있으면 그대로 쓴다: `BASE=$(gh repo view --json defaultBranchRef -q .defaultBranchRef.name)` 로 구한 뒤 `git fetch origin "$BASE" && git branch sprint-<id> "origin/$BASE" && git push -u origin sprint-<id>`. 이 브랜치가 이후 모든 이슈 PR의 base가 된다.
+- 이 sprint의 **통합 worktree를 확보한다.** 없으면 `git worktree add ../<repo>-wt/sprint-<id> sprint-<id>`로 만든다. 이 worktree는 통합 스모크와 dev 서버, 사람 검토에 쓰며 sprint가 끝날 때까지 유지한다.
 - **멱등 체크(중복 발행 방지)**: `gh issue list --milestone "<m>" --state all` 로 기존 이슈 수집 → 각 할일이 **이미 이슈로 있는지**(제목 또는 `## 관련 명세` specid로 매칭) 확인.
 - **없는 것만** 발행: `2t-decencia-channel-github-issue` 스킬을 **`Skill`로 호출**(표준 양식: 작업내용·관련명세 백링크·완료조건). 발행 후 **각 이슈에 milestone 지정**(`gh issue edit <n> --milestone "<m>"`).
   - ⚠️ github-issue 스킬은 중복방지를 안 한다 → **무엇을 발행할지(=없는 것만)는 이 스킬이 책임진다.**
@@ -74,9 +86,12 @@ ch check
 | `FEEDBACK` | 미체크 항목에 **note(수정 방향)가 달림** 또는 이슈 재오픈 | issue-coder 재투입 (병렬, note 반영) |
 | `DONE` | 이슈 close | 완료 카운트 |
 
+이 모드에서 모든 이슈 PR의 base는 기본 브랜치가 아니라 `sprint-<id>`다. CI 체크, mergeable 판정, 머지 대상이 모두 이 브랜치를 기준으로 한다.
+
 ### 4. 자동 전진 (디스패치)
-- **병렬 — `Agent`**: `TODO` + `FEEDBACK` 이슈 각각을 `2t-decencia-channel-issue-coder`로 위임(각자 worktree 격리, 독립 이슈). 여러 개면 **한 메시지에 Agent 여러 개**로 동시 실행.
-- **직렬 — `Agent`**: `IN_PR(green)` 이슈를 `2t-decencia-channel-pr-merger`로 **한 번에 하나씩** 위임(머지하면 main 바뀜 → 다음 PR mergeability 재평가, 레이스 방지).
+- **병렬 — `Agent`**: `TODO`와 `FEEDBACK` 상태의 이슈를 각각 `2t-decencia-channel-issue-coder`에 위임한다. 이때 위임 프롬프트에 base 브랜치가 `sprint-<id>`임을 명시해, 이슈가 그 브랜치에서 분기하고 PR도 그 브랜치를 향하게 한다. 여러 개면 한 메시지에 Agent를 여러 개 띄워 동시에 실행한다.
+- **직렬 — `Agent`**: `IN_PR(green)` 상태의 이슈를 `2t-decencia-channel-pr-merger`에 한 번에 하나씩 위임한다. 머지하면 `sprint-<id>`가 바뀌므로 다음 PR의 mergeability를 다시 평가하며, 레이스를 막기 위해 동시에 머지하지 않는다. 머저는 PR을 그 base 브랜치에 모으기만 하고 기본 브랜치로 올리지 않는다.
+- **머지 직후 동기화와 스모크 검사**: pr-merger가 이슈를 `sprint-<id>`에 머지하면, 스킬은 통합 worktree에서 `git fetch origin sprint-<id>` 후 `git reset --hard origin/sprint-<id>`로 원격과 맞춘 뒤 Agent에게 스모크 검사를 맡긴다. 스모크 검사는 빌드, dev 서버 기동, 핵심 경로 한두 개 확인까지만 한다. 검사가 실패하면 진행을 멈추고, 어느 머지가 깨뜨렸는지를 사람에게 보고한다.
 - 코더가 PR을 만들면 다음 호출 때 `IN_PR`로 잡혀 머저로 넘어간다(단계 사이 배리어는 GitHub 상태가 대신함).
 
 ### 4.5 스펙 status 롤업 (전역 시야 — 러너만 가능)
@@ -95,7 +110,13 @@ ch check
 ### 6. 반복 (멱등 재호출)
 - 사람이 확인·체크하거나 피드백을 남긴 뒤 **재호출** → 1~5 반복.
 - 이미 끝난 건(DONE, 머지된 PR, 발행된 이슈)은 자연히 **skip**된다(상태 SSOT = GitHub). 새로 생긴 `FEEDBACK`만 다시 흐른다.
-- **종료 조건**: milestone의 모든 이슈가 `DONE` + 백링크된 spec이 모두 `completed`로 롤업됨.
+- **개발 단계의 종료 조건**: milestone의 모든 이슈가 `DONE` 상태가 되고(`sprint-<id>`로 머지되고 close됨), 백링크된 spec이 모두 `completed`로 롤업되면 개발 단계가 끝난다. 그다음 §7의 최종 게이트로 넘어간다.
+
+### 7. 최종 머지 (사람 게이트)
+
+모든 이슈가 `sprint-<id>`에 모이면, 스킬은 통합 worktree에서 dev 서버를 띄워 유저가 통합 결과를 직접 검토하게 한다. 최종 머지에 앞서 기본 브랜치를 `sprint-<id>`에 먼저 머지해 충돌을 미리 해소한다. 검토 중 새 할일이 나오면 별도 채널을 만들지 않고, 해당 이슈의 체크리스트 note로 피드백을 남기거나 milestone에 새 이슈로 추가한다.
+
+어디로 머지할지는 유저가 정해 직접 실행한다. 보통 기본 브랜치로 머지하며, 이 머지는 곧 자동 배포로 이어진다. 스킬은 특별한 지시가 없는 한 이 최종 머지를 직접 실행하지 않는다. 머지가 끝나면 `sprint-<id>` 브랜치와 통합 worktree, 남은 이슈 worktree를 정리한다.
 
 ---
 
@@ -108,7 +129,8 @@ ch check
 - 이 스킬은 **분해·분류·위임·보고만** 한다. 구현/머지/리뷰 디테일은 각 에이전트가 책임(재SQA·전면 재리뷰 안 함).
 - **이슈 close·main push는 하지 않는다** — issue-coder는 PR까지, pr-merger가 조건부 close(사람확인 미체크면 open 유지). 이 스킬도 그 경계를 침범하지 않는다.
 - **무한루프 금지**: 블로커(CI red·모호한 충돌·요구 모호)는 **자동 해결 시도하지 말고 사람에게 핸드오프**.
-- 배포는 master 머지 시 GitHub Actions 자동 — 이 스킬은 **수동 배포/머지 트리거를 하지 않는다**.
+- 배포는 기본 브랜치에 머지될 때 GitHub Actions가 자동으로 실행한다. 스킬은 수동 배포를 하지 않으며, 기본 브랜치로 올리는 최종 머지도 특별한 지시가 없는 한 직접 실행하지 않고 유저에게 맡긴다.
+- **작업 위치를 항상 브리핑한다.** 스킬은 통합 worktree와 여러 이슈 worktree, 그리고 `sprint-<id>`·이슈·기본 브랜치를 오가며 일한다. 따라서 매 단계마다 지금 어느 worktree의 어느 브랜치에서 무엇을 하고 있는지를 사용자에게 먼저 알린다. 그래야 사용자가 작업 위치를 착각하지 않는다.
 - 공통 함정(전 컴포넌트 공유): ch CLI content는 마크다운+CRLF 정제, spec 필드 단수+복수 동시, `--json`/`specs get` 윈도우 빈출력 시 PowerShell `Out-File` 우회 — 위임 대상이 이미 준수.
 
 ## 다른 컴포넌트와의 관계

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

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