@decencia/ch-cli 1.31.11 → 1.32.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.31.11
+version: 1.32.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.31.11
+version: 1.32.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.31.11
+version: 1.32.0
 ---
 
 ## 역할

package/dist/commands/ia.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+/**
+ * `ch ia` — IA(정보구조) 문서. 프로젝트당 1건.
+ *
+ * 분류 노드와 화면 노드로 세운 트리를 담는다. 계층은 **사람이 기능의 포함 관계로** 정하는 것이지
+ * route에서 유도하지 않는다 — route의 SSOT는 `ch screens --route`이고, 화면 목록의 경로 구조는
+ * 별개의 그림이다.
+ *
+ * 트리는 통째 교체다. IA는 사람이 승인한 그림을 그대로 저장하는 문서라, 부분 수정 경로를 두면
+ * 승인한 트리와 저장된 트리가 갈라진다.
+ */
+export declare function registerIaCommand(program: Command): void;
+//# sourceMappingURL=ia.d.ts.map

package/dist/commands/ia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ia.d.ts","sourceRoot":"","sources":["../../src/commands/ia.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkGxD"}

package/dist/commands/ia.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerIaCommand = registerIaCommand;
+const client_1 = require("../client");
+const output_1 = require("../output");
+const utils_1 = require("../utils");
+/** 사람이 읽을 트리 한 장. 저장 형식이 중첩이라 표로는 계층이 안 보인다. */
+function printTree(nodes, prefix = '') {
+    nodes.forEach((node, i) => {
+        const last = i === nodes.length - 1;
+        const label = node.type === 'group'
+            ? `${node.name ?? '(이름 없음)'}${node.note ? `  — ${node.note}` : ''}`
+            : `[${node.screenId ?? '(screenId 없음)'}]`;
+        (0, output_1.printInfo)(`${prefix}${last ? '└─ ' : '├─ '}${label}`);
+        if (node.children?.length) {
+            printTree(node.children, `${prefix}${last ? '   ' : '│  '}`);
+        }
+    });
+}
+/**
+ * `ch ia` — IA(정보구조) 문서. 프로젝트당 1건.
+ *
+ * 분류 노드와 화면 노드로 세운 트리를 담는다. 계층은 **사람이 기능의 포함 관계로** 정하는 것이지
+ * route에서 유도하지 않는다 — route의 SSOT는 `ch screens --route`이고, 화면 목록의 경로 구조는
+ * 별개의 그림이다.
+ *
+ * 트리는 통째 교체다. IA는 사람이 승인한 그림을 그대로 저장하는 문서라, 부분 수정 경로를 두면
+ * 승인한 트리와 저장된 트리가 갈라진다.
+ */
+function registerIaCommand(program) {
+    const ia = program.command('ia').description('IA(정보구조) 관리');
+    ia.command('get')
+        .description('IA 조회')
+        .action(async () => {
+        const globalOpts = program.opts();
+        try {
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.get('/ia');
+            if (globalOpts.json || globalOpts.csv || globalOpts.quiet) {
+                (0, output_1.formatOutput)(data, globalOpts);
+                return;
+            }
+            if (!data) {
+                (0, output_1.printInfo)('IA가 아직 작성되지 않았습니다.');
+                return;
+            }
+            (0, output_1.printInfo)(`${data.title} (v${data.currentVersion})`);
+            const tree = data.tree ?? [];
+            if (tree.length === 0) {
+                (0, output_1.printInfo)('트리가 비어 있습니다.');
+                return;
+            }
+            printTree(tree);
+        }
+        catch {
+            // Error already handled
+        }
+    });
+    ia.command('set')
+        .description('IA 생성/수정 (트리는 통째 교체)')
+        .requiredOption('--title <title>', 'IA 문서 제목')
+        .option('--file <jsonFile>', '트리 JSON 파일 (IaNode[]) — 통째 교체')
+        .option('--content <path>', '배치 근거 마크다운 파일 — 내용이 저장된다')
+        .option('--expected-version <n>', '내가 읽은 시점의 currentVersion. 그 사이 남이 저장했으면 409로 막는다')
+        .option('--no-version', '버전 기록 없이 수정 (기본: 항상 새 버전 기록)')
+        .action(async (options) => {
+        const globalOpts = program.opts();
+        try {
+            const body = { title: options.title };
+            if (options.content !== undefined) {
+                body.content = (0, utils_1.readContentFile)(options.content, '--content');
+            }
+            if (options.file !== undefined) {
+                const parsed = (0, utils_1.readJsonFile)(options.file, '--file');
+                if (!Array.isArray(parsed)) {
+                    (0, output_1.failInput)('--file: 트리는 JSON 배열이어야 합니다.');
+                    return;
+                }
+                body.tree = parsed;
+            }
+            if (options.expectedVersion !== undefined) {
+                const n = Number(options.expectedVersion);
+                if (!Number.isInteger(n) || n < 1) {
+                    (0, output_1.failInput)('--expected-version: 1 이상의 정수여야 합니다.');
+                    return;
+                }
+                body.expectedVersion = n;
+            }
+            if (globalOpts.dryRun) {
+                (0, output_1.printInfo)(`[DRY-RUN] IA "${options.title}" 생성/수정 요청`);
+                return;
+            }
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const params = {};
+            if (options.version === false)
+                params.newVersion = 'false';
+            const { data } = await client.put('/ia', body, { params });
+            (0, output_1.formatOutput)(data, globalOpts);
+            (0, output_1.printSuccess)(data.message || 'IA가 저장되었습니다.');
+        }
+        catch (e) {
+            // HTTP 오류는 client 인터셉터가 이미 찍고 종료코드를 세웠다(400 검증 실패·409 충돌 포함).
+            if (e?.__handled)
+                return;
+            (0, output_1.failInput)(e?.message ?? String(e));
+        }
+    });
+    ia.command('versions')
+        .description('IA 버전 이력 조회')
+        .action(async () => {
+        const globalOpts = program.opts();
+        try {
+            const client = (0, client_1.createClient)({ projectId: globalOpts.project });
+            const { data } = await client.get('/ia/versions');
+            (0, output_1.formatOutput)(data, globalOpts);
+        }
+        catch {
+            // Error already handled
+        }
+    });
+}
+//# sourceMappingURL=ia.js.map

package/dist/commands/ia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ia.js","sourceRoot":"","sources":["../../src/commands/ia.ts"],"names":[],"mappings":";;AAsCA,8CAkGC;AAvID,sCAAyC;AACzC,sCAA6E;AAC7E,oCAAyD;AAUzD,gDAAgD;AAChD,SAAS,SAAS,CAAC,KAAe,EAAE,MAAM,GAAG,EAAE;IAC7C,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACpC,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,OAAO;YACnB,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACnE,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,eAAe,GAAG,CAAC;QAC9C,IAAA,kBAAS,EAAC,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC1B,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,iBAAiB,CAAC,OAAgB;IAChD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAE5D,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,OAAO,CAAC;SACpB,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAEzC,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;gBAC1D,IAAA,qBAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAA,kBAAS,EAAC,oBAAoB,CAAC,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,IAAA,kBAAS,EAAC,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YACrD,MAAM,IAAI,GAAa,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAA,kBAAS,EAAC,cAAc,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,sBAAsB,CAAC;SACnC,cAAc,CAAC,iBAAiB,EAAE,UAAU,CAAC;SAC7C,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;SAC5D,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;SACtD,MAAM,CACL,wBAAwB,EACxB,kDAAkD,CACnD;SACA,MAAM,CAAC,cAAc,EAAE,8BAA8B,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAE/D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,GAAG,IAAA,uBAAe,EAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC/D,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,IAAA,kBAAS,EAAC,6BAA6B,CAAC,CAAC;oBACzC,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;YACrB,CAAC;YACD,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClC,IAAA,kBAAS,EAAC,qCAAqC,CAAC,CAAC;oBACjD,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;YAC3B,CAAC;YAED,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,IAAA,kBAAS,EAAC,iBAAiB,OAAO,CAAC,KAAK,YAAY,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAQ,EAAE,CAAC;YACvB,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK;gBAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;YAE3D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,IAAA,qBAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC/B,IAAA,qBAAY,EAAC,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,8DAA8D;YAC9D,IAAI,CAAC,EAAE,SAAS;gBAAE,OAAO;YACzB,IAAA,kBAAS,EAAC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAClD,IAAA,qBAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.js

@@ -55,6 +55,7 @@ const db_tables_1 = require("./commands/db-tables");
 const screens_1 = require("./commands/screens");
 const userflows_1 = require("./commands/userflows");
 const policies_1 = require("./commands/policies");
+const ia_1 = require("./commands/ia");
 const backup_1 = require("./commands/backup");
 const handoff_1 = require("./commands/handoff");
 const notifications_1 = require("./commands/notifications");
@@ -116,6 +117,7 @@ program.hook('preAction', (thisCommand) => {
 (0, screens_1.registerScreensCommand)(program);
 (0, userflows_1.registerUserflowsCommand)(program);
 (0, policies_1.registerPoliciesCommand)(program);
+(0, ia_1.registerIaCommand)(program);
 (0, backup_1.registerBackupCommand)(program);
 (0, handoff_1.registerHandoffCommand)(program);
 (0, notifications_1.registerNotificationsCommand)(program);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,yCAAoC;AACpC,2CAA6B;AAC7B,uCAAyB;AAEzB,0CAAsD;AACtD,0CAAsD;AACtD,kDAA8D;AAC9D,4CAAwD;AACxD,gDAA4D;AAC5D,kDAA8D;AAC9D,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,8CAA0D;AAC1D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAC/D,oDAA+D;AAC/D,gDAA4D;AAC5D,oDAAgE;AAChE,kDAA8D;AAC9D,8CAA0D;AAC1D,gDAA4D;AAE5D,4DAAwE;AACxE,oDAAgE;AAChE,8CAA0D;AAC1D,wDAAmE;AACnE,4CAAwD;AAExD,qCAA+D;AAE/D,iCAAiC;AACjC,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,UAAU,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC;KAC/C,MAAM,CACL,QAAQ,EACR,4DAA4D,CAC7D;KACA,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACtC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC;KAC9B,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;KAChD,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC;KAC/B,MAAM,CAAC,SAAS,EAAE,2CAA2C,CAAC;KAC9D,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAEtC,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,mEAAmE;AACnE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACxC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAA,4BAAmB,GAAE,CAAC;IACxB,CAAC;IACD,IAAA,uBAAc,EAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,+BAA+B;AAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;AAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;AAC9B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAC/B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,mCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAChC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAC/B,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;AAEhC,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAC/B,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;AACnC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;AAE9B,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.31.11",
+  "version": "1.32.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.31.11
+version: 1.32.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.31.11
+version: 1.32.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.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->
@@ -200,6 +200,20 @@ ch specs update <specId> --db-tables tbl_users,tbl_sessions
 ch specs update <specId> --db-tables ""              # 모두 해제
 ```
 
+## IA 명령 (`ch ia`)
+
+프로젝트당 1건인 정보구조 문서다. 작성 기준은 [[2t-decencia-channel-ia-v2]].
+
+```bash
+ch ia get [--json]
+ch ia set --title "<제목>" --file ./ia.md   --navigations ./navigations.json --hubs ./hubs.json --entry-rules ./entry-rules.json
+ch ia versions
+```
+
+- `--navigations`·`--hubs`·`--entry-rules`는 각각 **JSON 배열 파일**이고 **통째 교체**다. 수정 전 `ch ia get --json`으로 받아 편집한다(Read-before-Write).
+- 메뉴의 `screenId`는 실존 화면이어야 한다(없으면 400). 죽은 메뉴를 서버가 막는다.
+- **route는 여기 넣지 않는다** — 배치의 SSOT는 `ch screens --route`다.
+
 ### 화면 연결 (`ch specs screen-refs`)
 
 `ui.screenRefs`는 **서버 관리 필드**다. `ch specs update --ui`로 보내면 서버가 버리고 기존 값을 지킨다. 화면 연결은 이 전용 커맨드로만 바꾼다 (웹 화면 선택기와 같은 경로 — `PATCH /specs/:id/screen-refs`).

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

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

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

@@ -2,13 +2,13 @@
 name: 2t-decencia-channel-ia-v2
 description: |
   [2t][v2] 소통채널 화면 IA(정보구조) 설계 가이드.
-  화면을 만들기 전에 내비게이션 구조를 먼저 정한다 — 최상위 메뉴·허브·그룹 배치·route 부여.
-  배치 기준은 "사용자가 어디서 찾는가"(탐색)이지 "어느 기능에 속하는가"(도메인·Epic)가 아니다.
+  화면을 만들기 전에 정보구조를 먼저 정한다 — 사람이 이름 붙인 분류 노드와 화면 노드로 트리를 세운다.
+  배치 기준은 "사용자가 어디서 찾는가"(탐색)이지 "어느 기능에 속하는가"(도메인·Epic)도, URL 경로도 아니다.
   Use when:
   (1) 화면설계서를 쓰기 전에 화면들의 배치·route를 정할 때,
   (2) 기존 프로젝트의 IA가 어색해 재배치를 검토할 때,
   (3) "이 화면이 왜 여기 있지" 같은 구조 문제를 점검할 때.
-version: 1.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->
@@ -53,15 +53,30 @@ IA가 설계물이 아니라 **부산물**이 되는 것이다. 그러면 각
 - 🚫 **기능 소속으로 route를 정하지 마라.** "견적 작성은 공급자 기능이니 `/supplier`"는 개발자의 분류다.
   공급회원이 "내가 낸 견적"을 찾을 때 실제로 어디를 누르는지와는 별개다.
 
+### 계층은 route가 아니라 기능의 포함 관계로 나눈다
+
+**URL은 결과이지 기준이 아니다.** 슬래시 개수는 계층이 아니다.
+
+Depth를 가르는 것은 "이 화면이 저 화면의 하위 기능인가"다. 실무 예로 1차 "주문하기" → 2차
+"배송지 확인"·"결제" → 3차 "주소 검색"처럼 나눈다. 순서(Step)와 계층(Depth)도 다르다 —
+목록 다음에 상세가 온다고 해서 상세가 목록의 하위 분류인 것은 아니다.
+
+route는 개발 편의·REST 관례·SEO로 정해진다. 그 값으로 계층을 유도하면 IA가 URL에 종속된다.
+IA 트리와 route는 별개로 정하고, route는 노드에 붙는 부가 정보로 본다.
+
+**묶음의 근거가 흐릿하면 카드소팅을 쓴다.** 화면 이름을 카드로 만들어 사용자가 직접 묶게 하는
+표준 방법이고, 결과가 곧 분류 노드의 후보가 된다.
+
 ## 2. 배치 규칙 4가지
 
 1. **"내 ○○"는 한 부모 아래 모은다.** 내 공고·내 견적·내 거래·내 문의·내 계정은 역할이 달라도
    같은 허브에 둔다. 하나만 밖에 있다면 그 이유를 한 줄로 답할 수 있어야 한다.
 2. **역할 차이는 부모를 나누는 축이 아니다.** 같은 위치에서 내용이 갈리게 한다.
    구매회원이 `/my/deals`를 열면 구매 거래가, 공급회원이 열면 공급 거래가 보인다.
-3. **자식이 있는 경로에는 화면이 있어야 한다.** `/buyer` 아래 화면이 5개인데 `/buyer` 자체에 화면이
-   없으면 그 묶음은 입구가 없는 셈이다.
-4. **최상위는 GNB에 담기는 수만큼.** 보통 5~7개다. 넘으면 묶고, 3단계보다 깊어지면 평평하게 편다.
+3. **분류 노드는 화면이 없어도 된다.** "공개 영역"·"회원 영역"처럼 사람이 이름 붙인 묶음은
+   그 자체로 노드다. 다만 **이름이 있어야 한다** — 이름 없는 경로 조각을 노드로 남기지 않는다.
+   묶음에 입구 화면이 필요하다고 판단되면 그건 별개의 화면으로 만든다.
+4. **최상위는 GNB에 담기는 수만큼.** 보통 5~7개다. 넘으면 묶고, 3~4단계보다 깊어지면 평평하게 편다.
 
 ## 3. 절차
 
@@ -71,32 +86,81 @@ IA가 설계물이 아니라 **부산물**이 되는 것이다. 그러면 각
 2. **최상위 내비게이션 항목**을 뽑는다. 비회원에게 보이는 것과 회원에게 보이는 것을 나눈다.
 3. 화면을 항목 아래 **배치**한다. 배치할 때마다 §1의 기준 질문에 답한다. 답이 막히면 그 화면은
    자리가 틀린 것이다.
-4. **route를 부여한다.** 트리의 경로가 곧 route다. 화면 ID 슬러그도 같은 계층을 반영한다.
-5. **트리를 그려 사용자 승인을 받는다**(§4).
+4. **route는 따로 정한다.** 트리의 경로를 route로 그대로 옮기지 않는다. IA는 사용자가 찾는 길이고
+   route는 개발·SEO 제약을 받는다. 둘이 닮을 수는 있지만 한쪽이 다른 쪽을 결정하지는 않는다.
+5. **트리를 그려 사용자 승인을 받고, 그대로 저장한다**(§4).
 6. §5 구조 검증을 통과할 때까지 3~5를 되풀이한다.
 
 ## 4. 산출물 — 트리로 제시한다
 
 ```
-/ 메인                                    SCR-HOME            누구나
-├─ /products 제품 검색                     SCR-PRODUCTS        누구나
-├─ /rfqs 공개 공고                         SCR-RFQ-LIST        누구나
-│  └─ /rfqs/[id] 공고 상세                 SCR-RFQ-DETAIL      누구나
-├─ /my 마이페이지 (역할별 허브)             SCR-MY              회원
-│  ├─ /my/rfqs 내 구매공고                 SCR-MY-RFQS         구매회원
-│  ├─ /my/bids 내 견적                     SCR-MY-BIDS         공급회원
-│  ├─ /my/deals 내 거래                    SCR-MY-DEALS        회원 (역할별 내용)
-│  └─ /my/account 계정·회사 관리            SCR-MY-ACCOUNT      회원
-└─ /admin 관리자 콘솔                      SCR-ADMIN-DASH      관리자
+공개 영역                                  (분류)
+├─ 인증                                    (분류)
+│  ├─ 로그인                               SCR-LOGIN           누구나
+│  └─ 회원가입                             SCR-SIGNUP          누구나
+├─ 제품·공고                               (분류)
+│  ├─ 제품 검색                            SCR-PRODUCTS        누구나
+│  └─ 공개 공고                            SCR-RFQ-LIST        누구나
+└─ 고객지원                                (분류)
+   └─ 문의                                 SCR-SUPPORT         누구나
+회원 영역                                  (분류)
+├─ 구매 활동                               (분류)
+│  ├─ 내 구매공고                          SCR-MY-RFQS         구매회원
+│  └─ 내 견적                              SCR-MY-BIDS         공급회원
+└─ 계정                                    (분류)
+   └─ 계정·회사 관리                        SCR-MY-ACCOUNT      회원
+관리자                                     (분류)
+└─ 관리자 콘솔                             SCR-ADMIN-DASH      관리자
 ```
 
 **배치표(행=화면, 열 하나가 route)로 승인받지 않는다.** 표에서는 구조가 보이지 않아서, 잘못된 배치가
 그대로 통과한다. 사람은 트리를 봐야 "견적이 왜 마이페이지 밖에 있지"를 즉시 알아챈다.
 
+### 승인받은 트리가 곧 저장 형식이다
+
+트리를 승인받고 대화에만 남기면, 나중에 구조가 바뀌었을 때 무엇이 진실인지 판별할 수 없다.
+**IA 리소스**(프로젝트당 1건)에 올린다 — 웹 "IA" 페이지가 이 트리를 그대로 그린다.
+
+사람이 승인한 트리와 화면에 뜨는 트리는 **같아야 한다.** 도구가 route로 다시 그리던 시절에는
+둘이 갈라졌고, 그게 이 개편의 이유다.
+
+```bash
+ch ia get [--json]                  # 현재 IA (Read-before-Write)
+ch ia set --title "LUBridge 정보구조" \
+  --file ./ia-tree.json \           # 트리 (아래 형식)
+  --content ./ia.md                 # 배치 근거(마크다운)
+ch ia versions                      # 변경 이력
+```
+
+`ia-tree.json` — 노드는 두 종류다 (통째 교체):
+
+```json
+[
+  { "type": "group", "name": "공개 영역", "note": "로그인 없이 접근", "children": [
+      { "type": "group", "name": "인증", "children": [
+          { "type": "screen", "screenId": "SCR-LOGIN" },
+          { "type": "screen", "screenId": "SCR-SIGNUP" } ] },
+      { "type": "screen", "screenId": "SCR-PRODUCTS" } ] },
+  { "type": "group", "name": "관리자", "children": [
+      { "type": "screen", "screenId": "SCR-ADMIN-DASH" } ] }
+]
+```
+
+- `group`은 `name`이 필수다. **화면이 없어도 노드가 된다** — 분류 노드가 여기 산다.
+- `screen`은 `screenId`만 갖는다. 이름·route는 화면에서 가져와 라벨로 쓰므로 **적지 않는다.**
+  같은 값을 두 곳에 두면 반드시 어긋난다.
+- **배열 순서가 곧 표시 순서다.** 순서 필드를 따로 두지 않는다.
+- `screenId`는 **실존 화면만 허용**한다(없으면 서버가 400). 같은 화면을 두 번 배치해도 400이다.
+- 트리에 없는 화면은 IA 페이지에서 **"IA 미배치"**로 모여 보인다. 화면을 새로 만들고 IA에 안 넣으면
+  거기 쌓이므로, 작업을 끝낼 때 0건인지 본다.
+- `--content`에는 **배치 근거**를 적는다. 근거가 사라지면 다음 사람은 이유를 모른 채 트리만 보게 되고,
+  그때부터 IA는 다시 흐트러진다.
+
 ## 5. 구조 검증 (승인 전 필수)
 
 - [ ] **형제 일관성** — 같은 성격의 화면이 서로 다른 부모에 흩어져 있지 않은가. ("내 ○○"가 대표적)
-- [ ] **고아 부모** — 자식이 있는 경로에 화면이 있는가.
+- [ ] **IA 미배치 0건** — 트리에 안 들어간 화면이 남아 있지 않은가. IA 페이지가 따로 모아 보여준다.
+- [ ] **이름 없는 분류 없음** — 모든 `group`에 사람이 읽을 이름이 있는가. 경로 조각을 이름 대신 쓰지 않았는가.
 - [ ] **탐색 역질문** — 화면마다 "사용자가 이걸 찾으려면 어디부터 클릭하나"를 한 줄로 답할 수 있는가.
       답이 "URL 직접 입력"이면 그 화면은 IA에 자리가 없는 것이다.
 - [ ] **명세 대조** — 허브 성격 spec(마이페이지 등)이 "무엇을 담는다"고 적어놨으면 IA가 그대로 따르는가.
@@ -107,14 +171,21 @@ IA가 설계물이 아니라 **부산물**이 되는 것이다. 그러면 각
 
 ## 6. 기존 프로젝트의 IA를 고칠 때
 
-route는 수정할 수 있지만 **화면 ID는 불변**이다. 재배치하면 ID와 경로가 어긋나 보인다
-(`SCR-SUPPLIER-BID-LIST`가 `/my/bids`에 놓이는 식). 감수하거나 삭제 후 재생성해야 하는데,
-후자는 spec 연결(`screenRefs`)이 끊긴다. 와이어프레임의 GNB·서브내비와 `data-screen-link`도
+IA 트리만 고치는 것은 싸다. 트리는 통째 교체라 `ch ia set` 한 번이면 되고, route도 화면 ID도
+건드리지 않는다. **IA가 어색하다고 route부터 고치지 마라.**
+
+route까지 함께 바꾸기로 했다면 그때 비용이 든다. **화면 ID는 불변**이라 재배치하면 ID와 경로가
+어긋나 보인다(`SCR-SUPPLIER-BID-LIST`가 `/my/bids`에 놓이는 식). 감수하거나 삭제 후 재생성해야
+하는데, 후자는 spec 연결(`screenRefs`)이 끊긴다. 와이어프레임의 GNB·서브내비와 `data-screen-link`도
 함께 고쳐야 한다. **비용을 먼저 알리고 사용자 판단을 받는다.**
 
 ## 7. 흔한 함정
 
 - **Epic을 그대로 그룹으로 쓰기** — 이 단계가 생긴 이유다 (§1).
+- **URL로 IA를 짜기** — **슬래시 개수는 계층이 아니다.** route를 그대로 트리로 옮기면 성격이 다른
+  화면이 한 줄에 서고, 목록과 상세가 부모-자식이 되며, 깊이가 아무 정보도 주지 않는다 (§1).
 - **역할로 최상위를 가르기** — `/buyer`·`/supplier`로 시작하면 "내 것"이 두 곳으로 찢어진다 (§2-2).
 - **배치표로 승인받기** — 구조가 안 보인다 (§4).
 - **화면을 다 만든 뒤에 IA를 보기** — 그때는 되돌리는 비용이 크다 (§6).
+- **IA를 대화에만 남기기** — 승인받은 트리를 `ch ia set`으로 저장하지 않으면, 나중에 GNB가 바뀌어도
+  무엇이 진실인지 판별할 수 없다. 배치 근거는 특히 잃기 쉽다 (§4).

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.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -8,7 +8,7 @@ description: |
   (1) 정책정의서를 새로 쓰거나 수정할 때,
   (2) 유저플로우·기능명세를 검토하다 "이건 정해진 게 없다"는 질문이 나왔을 때,
   (3) 알림 발송 매트릭스·크레딧 지급 기준·타임아웃 처리 같은 횡단 정책을 정리할 때.
-version: 1.31.11
+version: 1.32.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.31.11
+version: 1.32.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)spec 업로드 → (4)유저플로우 → (5)정책정의서 → (6)DB 스키마·spec 연결 → (7)화면설계서(화면 생성·연결) → (8)검증기준서(SQA). 각 단계 사용자 승인 게이트, 작성 디테일은 기존 2t-decencia-channel-*-v2 스킬을 적극 재사용. "새 기획 만들어줘"·"프로젝트 처음부터 세팅" 류 요청 시.
 allowed-tools: Bash(ch:*) Bash(git:*) Read Write
-version: 1.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->
@@ -151,6 +151,9 @@ ch specs create --id PROJ-001 --name "프로젝트 목록" \
 3. [[2t-decencia-channel-ia-v2]] §5 **구조 검증**을 돌린다(형제 일관성·고아 부모·탐색 역질문·명세 대조·깊이/폭).
 4. → **[게이트] 사람이 승인한다.** **배치표가 아니라 트리로** 보여준다 — 표에서는 구조가 보이지 않아
    잘못된 배치가 그대로 통과한다. 승인 전에는 아무것도 만들지 않는다.
+5. 승인받은 결과를 **저장한다** — `ch ia set --title ... --file ./ia.md --navigations ./navigations.json
+   --hubs ./hubs.json --entry-rules ./entry-rules.json` ([[2t-decencia-channel-ia-v2]] §4).
+   대화에만 남기면 나중에 무엇이 진실인지 판별할 수 없다. 웹 "IA" 탭에서 같은 문서를 본다.
 - → OK면 8단계.
 
 ## 8. 화면설계서 — 화면 생성·연결

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

@@ -4,12 +4,12 @@ description: |
   [2t][v2] 소통채널 화면설계서 작성 가이드.
   화면당 필수 기재항목 6종(ID·화면명·접근권한 / 컴포넌트별 설명 / 액션별 동작·이동 /
   입력 검증 규칙 / 예외상태 4종 / 연결 기획 ID)과 디스크립션 작성규칙(출처까지·결과까지·검증까지·정책은 참조만).
-  IA 트리 뷰(zoom/pan)·와이어프레임+디스크립션 좌우 분할 뷰 기준.
+  화면 구조 뷰(경로 계층)·와이어프레임+디스크립션 좌우 분할 뷰 기준. 정보구조(IA)는 별도 스킬 소관.
   Use when:
   (1) 화면(screens) 문서를 작성·수정할 때,
   (2) 화면의 표시 데이터·액션·입력 검증·예외상태를 기재할 때,
-  (3) 웹 "화면" 탭의 IA 트리·화면 상세에 올릴 내용을 쓸 때.
-version: 1.31.11
+  (3) 웹 "화면" 탭의 화면 구조 뷰·화면 상세에 올릴 내용을 쓸 때.
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->
@@ -29,15 +29,17 @@ ch check
 
 # 화면설계서 — 작성 표준
 
-화면설계서는 화면(screen) 하나가 **무엇을 보여주고, 눌리면 어떻게 되고, 어떤 입력을 어떻게 검증하는지**를 적는 문서다. 웹 "화면" 탭의 IA 트리에서 노드를 클릭하면 보인다.
+화면설계서는 화면(screen) 하나가 **무엇을 보여주고, 눌리면 어떻게 되고, 어떤 입력을 어떻게 검증하는지**를 적는 문서다. 웹 "화면" 탭의 화면 구조 뷰에서 노드를 클릭하면 보인다.
 
 역할 분담: 흐름(시나리오)은 spec([[2t-decencia-channel-spec-v2]] §7), 여정 갈림길은 유저플로우([[2t-decencia-channel-userflow-v2]]), 횡단 정책은 정책정의서([[2t-decencia-channel-policy-v2]]). 화면설계서는 **그 화면 안에서 보이는 것·눌리는 것**만 적는다.
 
 > **작성 순서상 ⑤다** — ①기능명세 → ②유저플로우 → ③정책정의서 → DB 스키마 → **④IA 설계**가 끝난 뒤에 화면을 만든다. **spec보다 화면을 먼저 만들지 않는다.** 화면을 만들면서 `ch specs screen-refs <specId> --screens <ids>`로 기존 spec들과 연결하고, 그다음 ⑥검증기준서로 넘어간다.
 >
-> ⚠️ **route와 배치는 여기서 정하지 않는다.** 화면이 트리의 어디에 놓이고 route가 무엇인지는
-> ④에서 이미 결정돼 있어야 한다 — [[2t-decencia-channel-ia-v2]]. 화면마다 route를 즉석에서 지으면
-> IA가 설계물이 아니라 부산물이 되고, 그 순간 손에 잡히는 분류(Epic)를 근거로 삼게 된다.
+> ⚠️ **배치는 여기서 정하지 않는다.** 화면이 IA 트리의 어디에 놓이는지는 ④에서 이미 결정돼 있어야
+> 한다 — [[2t-decencia-channel-ia-v2]]. 화면을 만들면서 배치를 즉석에서 정하면 IA가 설계물이 아니라
+> 부산물이 되고, 그 순간 손에 잡히는 분류(Epic)를 근거로 삼게 된다.
+>
+> route는 화면이 갖는 값이라 여기서 적지만, **IA 계층에서 유도하지 않는다.** 둘은 별개다.
 
 ## 1. 필수 기재항목
 
@@ -74,12 +76,15 @@ ch check
 | 에러 | 실패 안내 + 재시도 수단 |
 | 권한 없음 | 차단 화면인지 리다이렉트인지, 안내 문구 |
 
-## 4. IA 트리 뷰
+## 4. 화면 구조 뷰 — IA가 아니다
 
-- 웹 "화면" 탭은 화면들을 **IA 트리**(route 계층)로 보여준다. 유저플로우와 같은 zoom in/out·pan 뷰어다.
+- 웹 "화면" 탭은 화면들을 **경로 구조**(route 계층)로 보여준다. 목록 줄(트리)과 표, 두 가지다.
 - 노드를 클릭하면 화면 상세가 열린다: **좌측 와이어프레임 뷰 · 우측 디스크립션**(§1 항목들).
 - 트리가 읽히려면 route를 계층적으로 짓는다 (`/store/orders` → `/store/orders/[id]`). 화면 ID 슬러그도 계층을 반영한다.
-- 이 트리의 **모양을 결정하는 것은 ④ IA 설계**다([[2t-decencia-channel-ia-v2]]). 여기서는 그 결정을 화면 문서에 옮겨 적을 뿐이다. 트리를 보고 배치가 어색하면 화면을 고치지 말고 IA 단계로 되돌아간다.
+- 🚫 **이건 IA가 아니다.** 화면 목록을 경로로 정렬해 훑는 개발자용 그림이다. 정보구조는 **IA 페이지**에 따로 있고,
+  거기 트리는 사람이 이름 붙인 분류 노드로 세운다([[2t-decencia-channel-ia-v2]]).
+  슬래시 개수는 계층이 아니므로, 이 화면의 깊이를 IA 깊이로 읽지 않는다.
+- 배치가 어색해 보이면 화면을 고치지 말고 ④ IA 설계로 되돌아간다.
 
 ## 4-1. 와이어프레임 — HTML로 실제 렌더
 
@@ -197,6 +202,18 @@ ch screens update SCR-ORDER-DETAIL \
 
 전부 ✅가 될 때까지 4를 반복한다. 완성된 대조표가 곧 사람 확인용 증빙이다.
 
+### IA 대조도 함께 한다
+
+위 대조는 **화면 누락**만 잡는다. IA가 낡은 것은 못 잡는다 — 실제로 대조표가 전부 ✅인데
+IA는 낡아 있던 적이 있다. `ch ia get`으로 IA 트리를 받아 두 가지를 더 본다.
+
+- [ ] **IA 미배치 0건** — 트리에 안 들어간 화면이 남아 있는가. 새로 만든 화면이 여기 쌓인다.
+      IA 페이지가 따로 모아 보여주므로 눈으로도 확인된다.
+- [ ] **죽은 참조** — 트리의 `screenId`가 전부 실존 화면인가. (서버가 저장 시 막지만, 화면을
+      지운 뒤에는 트리에 그대로 남는다)
+
+어긋나면 화면이 아니라 **IA를 고친다**([[2t-decencia-channel-ia-v2]] §4의 `ch ia set`).
+
 ## 6. 흔한 함정
 
 - **컴포넌트 설명에 모든 걸 밀어 넣기** — 조건절·정책 ID·조건 붙은 출처 표기까지 한 문장에 담으면

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

@@ -12,7 +12,7 @@ description: |
   (3) 스토리문장·사전 조건·로직 플로우·비즈니스 규칙을 작성할 때,
   (4) Story 규모를 Story Point(`--points`)로 매길 때,
   (5) 신규 spec ID를 `AUTH-001` 같은 JIRA 스타일로 부여할 때 (`ch specs create --id`).
-version: 1.31.11
+version: 1.32.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.31.11
+version: 1.32.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.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -12,7 +12,7 @@ description: |
   (4) 보안/성능/접근성/호환성 비기능 TC를 시트에 채워야 할 때,
   (5) 명세 영역별 완성형 TC 번들(퍼블리싱/프론트/백엔드 디센시아 운영 관점 포함)을 가져다 쓸 때,
   (6) Sprint 종료 전 spec별 TC 통과·시나리오 통과 여부를 점검할 때.
-version: 1.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->

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

@@ -8,7 +8,7 @@ description: |
   (1) 유저플로우(사용자 여정 분기도)를 새로 그리거나 수정할 때,
   (2) PRD·Epic-Story 목록에서 플로우로 그릴 대상을 고를 때,
   (3) 웹 "유저플로우" 탭에 올릴 Mermaid 코드를 작성할 때.
-version: 1.31.11
+version: 1.32.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.31.11
+version: 1.32.0
 ---
 
 <!-- ch-version-gate -->