@decencia/ch-cli 1.6.0 → 1.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3,7 +3,7 @@ name: 2t-decencia-channel-issue-coder
3
3
  description: GitHub issue 1개를 입력으로 받아 끝까지 처리하는 코딩 에이전트. 이슈 읽기 → 소통채널 spec/SQA 확인 → git worktree+브랜치에서 구현 → 자체 소프트리뷰 루프 → unittest + SQA → PR 생성 → 소통채널 workStatus·이슈 기록. 다수 병렬 실행 전제, PR까지만(머지·main push·이슈 close는 사람).
4
4
  tools: Read, Write, Edit, Grep, Glob, Bash, Agent
5
5
  model: opus
6
- version: 1.6.0
6
+ version: 1.6.2
7
7
  ---
8
8
 
9
9
  ## 역할
@@ -22,6 +22,7 @@ GitHub issue 1개를 입력으로 받아 **구현 → 자체검토 → 검증
22
22
 
23
23
  ### 1. 이슈 읽기
24
24
  - `gh issue view <num>` → 제목 · 작업내용 · `## 관련 명세`(specid 목록) · 완료조건 파싱.
25
+ - **milestone(=Sprint명)** 도 확보: `gh issue view <num> --json milestone`. (사람확인 체크리스트 등록 시 필요)
25
26
 
26
27
  ### 2. 명세·SQA 읽기
27
28
  - 이슈에서 얻은 specid로 `ch specs get <id>` (Windows에서 빈 출력이면 PowerShell `Out-File`로 우회).
@@ -30,6 +31,7 @@ GitHub issue 1개를 입력으로 받아 **구현 → 자체검토 → 검증
30
31
  ### 3. worktree + 브랜치 생성 후 구현
31
32
  - `git worktree add ../<repo>-wt/issue-<num> -b issue-<num> origin/main` → 이후 모든 작업은 그 worktree 안에서.
32
33
  - 이슈 작업내용 + spec 요구사항대로 구현.
34
+ - 관련 spec(이슈의 `## 관련 명세` specid)이 아직 `waiting`/`designing`이면 `ch specs set-status <id> developing` 으로 전이(이미 developing 이상이면 skip, specid 없으면 skip).
33
35
 
34
36
  ### 4. 자체 소프트 검토 → 수정 루프 (테스트 아님 · 최대 3회, 조기 종료)
35
37
  - 작성한 코드를 **여러 측면에서 스스로 리뷰하고 고친다**: 설계/아키텍처 정합, 가독성·네이밍, 엣지케이스·에러처리, 명세 부합, 중복·재사용, 보안.
@@ -50,14 +52,25 @@ GitHub issue 1개를 입력으로 받아 **구현 → 자체검토 → 검증
50
52
 
51
53
  ### 8. 소통채널 기록
52
54
  - `ch specs update <id> --work-status <file>` 로 진행상황·결정·블로커 기록 + 완료된 task 체크(정확한 플래그는 `ch specs update --help` 확인).
55
+ - PR·검증까지 끝났으면 관련 spec을 `ch specs set-status <id> testing` 으로 전이. **`completed`로는 올리지 않는다** — 한 spec이 여러 이슈에 걸칠 수 있어, 전체 완료 판정은 sprint-runner(전역 시야)의 몫.
53
56
  - ⚠️ 본문은 **파일로 전달 + CRLF 정제**(`tr -d '\r'`). PowerShell 인자 분리가 실패하면 Bash 도구로 우회.
54
57
 
55
- ### 9. 이슈 기록
56
- - `gh issue comment <num> --body-file <file>` 로 **진행 내용 + 사람이 확인해야 할 항목(체크리스트)** 기록.
58
+ ### 9. 이슈 기록 + 사람확인 체크리스트 등록
59
+ - `gh issue comment <num> --body-file <file>` 로 **진행 내용**을 이슈에 남긴다.
60
+ - **사람이 확인해야 할 항목은 GitHub 코멘트가 아니라 소통채널 DB에 등록**한다(=SSOT). 항목을 파일(줄당 1개)로 적고:
61
+ ```bash
62
+ ch github checklist set <num> --milestone "<milestone>" --items-file <file>
63
+ ```
64
+ - 이게 웹 "실행 탭"의 체크박스로 뜨고, 사람이 체크/메모(수정 방향)를 남긴다. pr-merger의 close 판단도 이 DB를 본다.
65
+ - 멱등: 같은 이슈에 다시 set 해도 기존 항목의 checked·note(사람 피드백)는 text 매칭으로 **보존**된다.
66
+ - ⚠️ **선별 기준 — 패딩 금지**: "코드/자동테스트/SQA로는 단정 못 하고 **사람이 직접 눈/손으로 확인해야만 판단되는 것**"만 적는다. **개수에 정답 없음(0개면 안 적는다)** — 형식 채우려 항목을 늘리지 말 것.
67
+ - **넣지 마라**: 이미 unittest·SQA·정적분석으로 검증되는 것, "기존 기능 회귀 없는지 확인" 류 상투구, **PR 머지·이슈 close·diff/base 검토 같은 진행·메타 작업**(그건 pr-merger·사람의 몫이지 사람확인 항목이 아니다).
68
+ - **넣어라**: 실제 화면 동작·UX 판단·디자인 적정성처럼 **사람만 yes/no 할 수 있는** 구체 항목.
57
69
  - **이슈 close는 하지 않는다**(사람/PR 머지가 닫는다).
58
70
 
59
71
  ## 원칙
60
72
  - **블로커**로 막히면 무한루프 금지 → workStatus·이슈에 블로커를 명시한 뒤 사람에게 핸드오프.
61
73
  - **재실행(멱등)**: 같은 이슈를 다시 받으면 기존 브랜치/worktree·이슈 코멘트·workStatus를 먼저 확인하고 이어간다.
74
+ - **피드백 반영(FEEDBACK)**: 재실행 시 `ch github checklist get <num>` 로 사람이 남긴 **note(수정 방향)**·미체크 항목을 읽어, 그 지시대로 고친 뒤 같은 이슈에 이어서 작업한다. (체크리스트가 사람→코더 피드백 채널이다)
62
75
  - **경계**: PR 생성까지만. 머지·main push·이슈 close는 절대 하지 않는다.
63
76
  - 본문(이슈/workStatus)은 HTML이 아닌 **마크다운**으로 작성.
@@ -3,7 +3,7 @@ name: 2t-decencia-channel-pr-merger
3
3
  description: issue-coder가 낸 PR을 기본 완전 자율로 main에 머지하는 에이전트. 핵심 역량은 다수 병렬 worktree가 만든 충돌을 작업 의도 기반(semantic)으로 해결하는 것. CI green+충돌없음이면 바로 squash 머지, 충돌이면 의도대로 해결 후 테스트로 검증하여 머지. 재SQA·전면 재리뷰는 하지 않음. 다수 PR은 직렬 머지.
4
4
  tools: Read, Write, Edit, Grep, Glob, Bash
5
5
  model: opus
6
- version: 1.6.0
6
+ version: 1.6.2
7
7
  ---
8
8
 
9
9
  ## 역할
@@ -16,7 +16,8 @@ issue-coder가 낸 PR을 **기본 완전 자율로 main에 머지**한다. 핵
16
16
  ## 절차
17
17
 
18
18
  ### 1. PR 파악
19
- - `gh pr view <n> --comments` → diff · 연결 이슈/specid · 작업 의도(작업내용·완료조건) · issue-coder가 남긴 **사람확인 항목 체크리스트**.
19
+ - `gh pr view <n> --comments` → diff · 연결 이슈/specid · 작업 의도(작업내용·완료조건).
20
+ - **사람확인 항목은 소통채널 DB**에서 본다: `ch github checklist get <이슈번호>` → 항목별 checked·note.
20
21
  - 필요 시 specid로 `ch specs get <id>`(충돌 해결의 판단 근거).
21
22
 
22
23
  ### 2. 상태 확인
@@ -34,12 +35,13 @@ issue-coder가 낸 PR을 **기본 완전 자율로 main에 머지**한다. 핵
34
35
  - **CI red**(테스트 실패 등) → **머지 금지**, PR에 반려 코멘트(→ issue-coder/사람 핑퐁).
35
36
 
36
37
  ### 4. 후속
37
- - **소통채널**: `ch specs update <id> --work-status <file>` 로 머지 완료 기록(필요 status 전이). ⚠️ 본문은 파일로 전달 + **CRLF 정제**(`tr -d '\r'`).
38
+ - **소통채널**: `ch specs update <id> --work-status <file>` 로 머지 완료 기록. **spec status enum은 건드리지 않는다**(이 PR이 그 spec의 전부인지 알 수 없음 — completed 판정은 sprint-runner). ⚠️ 본문은 파일로 전달 + **CRLF 정제**(`tr -d '\r'`).
38
39
  - worktree/브랜치 정리.
39
40
  - **이슈 처리(조건부 close)**:
40
41
  - PR/이슈에 머지 완료 코멘트.
41
- - 이슈의 **사람확인 항목 체크리스트에 미체크가 남아있으면 close 금지** → **open 유지** + "머지 완료, 사람확인 대기" 표시.
42
- - 사람확인 항목이 없거나 모두 체크돼 있을 때만 `gh issue close`.
42
+ - `ch github checklist get <이슈번호>` 로 확인 — **미체크 항목이 남아있으면 close 금지** → **open 유지** + "머지 완료, 사람확인 대기" 표시.
43
+ - 항목이 없거나(체크리스트 미등록) 모두 checked일 때만 `gh issue close`.
44
+ - ⚠️ note(수정 방향)가 달렸는데 미체크면 사람이 재작업을 요청한 것 → close하지 말고 issue-coder 재투입 대상(FEEDBACK)으로 남긴다.
43
45
 
44
46
  ### 5. 직렬 재평가
45
47
  - 한 PR 머지 후 main이 바뀌므로, 다음 PR은 **새 main 기준으로 mergeability 재평가**(앞 머지로 새 충돌이 생길 수 있음). **동시 머지 금지**(레이스 방지).
@@ -3,7 +3,7 @@ name: 2t-decencia-channel-terraformer
3
3
  description: 소통채널을 쓰지 않던 기존 코드베이스를 역분석하여 소통채널 프로젝트로 편입(terraforming)하는 자율 에이전트. 코드가 single source of truth — 코드를 읽어 DB 스키마 → 기능명세(spec) → PRD를 bottom-up으로 역생성한다(SQA 제외). 대량 분석은 서브에이전트 병렬, 코드로 못 메우는 의도는 [추정]으로 채우고 "사람확인 질문 리스트"를 산출물로 남긴다. PR/머지·이슈 발행은 하지 않음.
4
4
  tools: Read, Write, Edit, Grep, Glob, Bash, Agent
5
5
  model: opus
6
- version: 1.6.0
6
+ version: 1.6.2
7
7
  ---
8
8
 
9
9
  ## 역할
@@ -0,0 +1,3 @@
1
+ import { Command } from 'commander';
2
+ export declare function registerGithubCommand(program: Command): void;
3
+ //# sourceMappingURL=github.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/commands/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+D5D"}
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.registerGithubCommand = registerGithubCommand;
37
+ const fs = __importStar(require("fs"));
38
+ const client_1 = require("../client");
39
+ const output_1 = require("../output");
40
+ function registerGithubCommand(program) {
41
+ const github = program
42
+ .command('github')
43
+ .description('GitHub 연동 (Sprint 실행 보드 · 사람확인 체크리스트)');
44
+ const checklist = github
45
+ .command('checklist')
46
+ .description('이슈 사람확인 체크리스트 (우리 DB가 SSOT)');
47
+ // ch github checklist get <issueNumber>
48
+ // pr-merger: close 판단(전부 checked?) / issue-coder: note(수정 방향) 읽기
49
+ checklist
50
+ .command('get <issueNumber>')
51
+ .description('이슈 체크리스트 항목 조회 (text·checked·note)')
52
+ .action(async (issueNumber) => {
53
+ const globalOpts = program.opts();
54
+ try {
55
+ const client = (0, client_1.createClient)({ projectId: globalOpts.project });
56
+ const { data } = await client.get(`/github/checklist/${encodeURIComponent(issueNumber)}`);
57
+ (0, output_1.formatOutput)(data, globalOpts);
58
+ }
59
+ catch {
60
+ // Error already handled by client interceptor
61
+ }
62
+ });
63
+ // ch github checklist set <issueNumber> --milestone <m> --items-file <path>
64
+ // issue-coder: 사람확인 항목 일괄 등록 (기존 checked/note는 text 매칭으로 보존)
65
+ checklist
66
+ .command('set <issueNumber>')
67
+ .description('사람확인 항목 일괄 등록 (issue-coder)')
68
+ .requiredOption('--milestone <name>', 'milestone(=Sprint명)')
69
+ .option('--items-file <path>', '항목 파일 (줄당 1개)')
70
+ .option('--items <text...>', '항목 텍스트 (반복 가능)')
71
+ .action(async (issueNumber, options) => {
72
+ const globalOpts = program.opts();
73
+ try {
74
+ let items = [];
75
+ if (options.itemsFile) {
76
+ const raw = fs.readFileSync(options.itemsFile, 'utf-8');
77
+ items = raw
78
+ .split(/\r?\n/)
79
+ .map((l) => l.trim())
80
+ .filter((l) => l.length > 0);
81
+ }
82
+ else if (options.items) {
83
+ items = options.items;
84
+ }
85
+ if (items.length === 0) {
86
+ (0, output_1.printError)('등록할 항목이 없습니다. --items-file 또는 --items 를 지정하세요.');
87
+ return;
88
+ }
89
+ const client = (0, client_1.createClient)({ projectId: globalOpts.project });
90
+ const { data } = await client.put(`/github/checklist/${encodeURIComponent(issueNumber)}`, { milestone: options.milestone, items });
91
+ (0, output_1.printSuccess)(`체크리스트 ${items.length}개 항목을 등록했습니다 (이슈 #${issueNumber}).`);
92
+ (0, output_1.formatOutput)(data, globalOpts);
93
+ }
94
+ catch {
95
+ // Error already handled by client interceptor
96
+ }
97
+ });
98
+ }
99
+ //# sourceMappingURL=github.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/commands/github.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -53,6 +53,7 @@ const db_tables_1 = require("./commands/db-tables");
53
53
  const backup_1 = require("./commands/backup");
54
54
  const notifications_1 = require("./commands/notifications");
55
55
  const dashboard_1 = require("./commands/dashboard");
56
+ const github_1 = require("./commands/github");
56
57
  const setup_skill_1 = require("./commands/setup-skill");
57
58
  const check_1 = require("./commands/check");
58
59
  // Read version from package.json
@@ -95,6 +96,7 @@ program
95
96
  (0, backup_1.registerBackupCommand)(program);
96
97
  (0, notifications_1.registerNotificationsCommand)(program);
97
98
  (0, dashboard_1.registerDashboardCommand)(program);
99
+ (0, github_1.registerGithubCommand)(program);
98
100
  (0, setup_skill_1.registerSetupSkillCommand)(program);
99
101
  (0, check_1.registerCheckCommand)(program);
100
102
  // Parse and execute
package/dist/index.js.map CHANGED
@@ -1 +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,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAC/D,oDAA+D;AAC/D,8CAA0D;AAE1D,4DAAwE;AACxE,oDAAgE;AAChE,wDAAmE;AACnE,4CAAwD;AAExD,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,CAAC,QAAQ,EAAE,cAAc,CAAC;KAChC,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,gBAAgB,CAAC;KACnC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAEtC,+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,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,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,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAE/B,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,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"}
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,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAC/D,oDAA+D;AAC/D,8CAA0D;AAE1D,4DAAwE;AACxE,oDAAgE;AAChE,8CAA0D;AAC1D,wDAAmE;AACnE,4CAAwD;AAExD,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,CAAC,QAAQ,EAAE,cAAc,CAAC;KAChC,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,gBAAgB,CAAC;KACnC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AAEtC,+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,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;AACjC,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,8BAAqB,EAAC,OAAO,CAAC,CAAC;AAE/B,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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@decencia/ch-cli",
3
- "version": "1.6.0",
3
+ "version": "1.6.2",
4
4
  "description": "Decencia Communication Channel CLI",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -2,7 +2,7 @@
2
2
  name: 2t-decencia-channel-change-manager
3
3
  description: 기존 소통채널 프로젝트의 기능 추가/수정을 사용자와 대화로 명확화 → 전파 스킬로 연관 PRD/spec/DB/SQA 일괄 갱신 → 변경으로 생긴 새 할일을 GitHub 이슈로 발행하는 오케스트레이터 스킬. (1)대화로 변경 내용 확정 → (2)[게이트] 영향 범위 확인 후 전파 적용 → (3)[게이트] 할일 목록 확인 후 이슈 발행. "이 기능 바꿀래"·"기획 수정"·"이거 추가해줘(기존 프로젝트)" 류 요청 시.
4
4
  allowed-tools: Bash(ch:*) Bash(git:*) Bash(gh:*) Read Write
5
- version: 1.6.0
5
+ version: 1.6.2
6
6
  ---
7
7
 
8
8
  <!-- ch-version-gate -->
@@ -10,7 +10,7 @@ description: |
10
10
  (3) 명세·DB·SQA가 서로 어긋나 있는 의심이 들 때 (정합성 점검),
11
11
  (4) PRD 갱신 후 하위 spec/db/SQA로 변경분을 흘려보내야 할 때,
12
12
  (5) Sprint 진행 중 도메인 규칙·스키마가 흔들렸을 때 연쇄 갱신이 필요할 때.
13
- version: 1.6.0
13
+ version: 1.6.2
14
14
  ---
15
15
 
16
16
  <!-- ch-version-gate -->
@@ -8,7 +8,7 @@ description: |
8
8
  (2) Task에 description/points/completedAt을 기록할 때,
9
9
  (3) ch db-tables 명령(list/get/create/update/delete)을 사용할 때,
10
10
  (4) Spec ID를 JIRA 스타일(`LOGIN-001`)로 직접 지정할 때 (`ch specs create --id`).
11
- version: 1.6.0
11
+ version: 1.6.2
12
12
  ---
13
13
 
14
14
  <!-- ch-version-gate -->
@@ -8,7 +8,7 @@ description: |
8
8
  (2) DB 테이블 단위로 컬럼·인덱스·보안규칙을 등록·수정할 때,
9
9
  (3) 새 테이블을 추가하면서 전체 인벤토리도 함께 업데이트할 때,
10
10
  (4) spec.dbTableRefs와 양방향 동기화가 필요한 작업 시.
11
- version: 1.6.0
11
+ version: 1.6.2
12
12
  ---
13
13
 
14
14
  <!-- ch-version-gate -->
@@ -2,7 +2,7 @@
2
2
  name: 2t-decencia-channel-github-issue
3
3
  description: gh CLI로 현재 repo에 GitHub 이슈를 작성한다. 이슈 1개=유형 1개(feat/fix/bug), 표준 본문 양식(작업내용·관련 명세 백링크·완료조건)으로 발행. "이슈 만들어줘"/"깃헙 이슈로 등록해줘" 요청 시, 또는 소통채널 기획·명세 작업 후 처리할 일들을 GitHub 이슈로 옮길 때 사용. 멱등성/중복방지·확인단계는 다루지 않음(요청대로 바로 생성).
4
4
  allowed-tools: Bash(gh:*) Bash(git:*) Read Write
5
- version: 1.6.0
5
+ version: 1.6.2
6
6
  ---
7
7
 
8
8
  <!-- ch-version-gate -->
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: 2t-decencia-channel-orchestrator
3
- description: 소통채널 작업의 단일 진입점(디스패처). 사용자 요청을 듣고 6종(bootstrap·terraformer·change-manager·github-issue·issue-coder·pr-merger) 중 적절한 곳으로 라우팅하고, 필요하면 여러 단계를 순차 오케스트레이션한다. 대화형 스킬은 메인 세션에서 Skill로, 자율 에이전트는 Agent로 위임. "소통채널 작업 해줘"·"이거 어떻게 처리하지?"처럼 무엇부터 할지 모를 때, 또는 신규기획/코드편입/기획변경/이슈/구현/머지 어디로든 시작할 때.
3
+ description: 소통채널 작업의 단일 진입점(디스패처). 사용자 요청을 듣고 7종(bootstrap·terraformer·change-manager·github-issue·issue-coder·pr-merger·sprint-runner) 중 적절한 곳으로 라우팅하고, 필요하면 여러 단계를 순차 오케스트레이션한다. 대화형 스킬은 메인 세션에서 Skill로, 자율 에이전트는 Agent로 위임. "소통채널 작업 해줘"·"이거 어떻게 처리하지?"처럼 무엇부터 할지 모를 때, 또는 신규기획/코드편입/기획변경/이슈/구현/머지/스프린트실행 어디로든 시작할 때.
4
4
  allowed-tools: Skill Agent Read Bash(ch:*) Bash(gh:*) Bash(git:*)
5
- version: 1.6.0
5
+ version: 1.6.2
6
6
  ---
7
7
 
8
8
  <!-- ch-version-gate -->
@@ -22,7 +22,7 @@ ch check
22
22
 
23
23
  # 2t-decencia-channel-orchestrator — 소통채널 작업 디스패처
24
24
 
25
- 소통채널 관련 요청의 **단일 진입점**. 사용자 의도를 분류해 아래 6종 중 알맞은 것으로 보내고, 여러 단계가 필요하면 **순차 오케스트레이션**한다.
25
+ 소통채널 관련 요청의 **단일 진입점**. 사용자 의도를 분류해 아래 7종 중 알맞은 것으로 보내고, 여러 단계가 필요하면 **순차 오케스트레이션**한다.
26
26
  이 스킬은 라우터다 — 실제 작업 디테일은 각 스킬/에이전트가 가지고 있으니 **중복 서술하지 않고 위임만** 한다.
27
27
 
28
28
  ## 핵심 규칙
@@ -40,6 +40,7 @@ ch check
40
40
  | 4 | **이슈만 발행** ("이거 이슈로 등록") | `2t-decencia-channel-github-issue` | 스킬 | `Skill` |
41
41
  | 5 | **이슈를 구현** ("이슈 #N 작업해줘") | `2t-decencia-channel-issue-coder` | 에이전트(자율) | `Agent` |
42
42
  | 6 | **PR을 머지** ("PR #N 머지", "쌓인 PR 정리") | `2t-decencia-channel-pr-merger` | 에이전트(자율) | `Agent` |
43
+ | 7 | **Sprint를 끝까지 실행** ("스프린트 돌려줘", "sprint N 실행" — 이슈 발행→구현→머지→사람확인 반복을 한 번에) | `2t-decencia-channel-sprint-runner` | 스킬(대화형) | `Skill` |
43
44
 
44
45
  ## 판별 신호 (먼저 확인)
45
46
  - cwd(또는 상위)의 **`.ch-project` 존재 여부** → 이미 온보딩된 repo인지.
@@ -56,6 +57,7 @@ ch check
56
57
  ## 순차 오케스트레이션 예시
57
58
  - "이 레포 소통채널에 올리고 스프린트도 짜줘" → 2 terraformer(Agent) → 끝나면 `2t-decencia-channel-sprint-builder-v2`(Skill).
58
59
  - "로그인에 SNS 추가하고 개발까지" → 3 change-manager(Skill, 전파+이슈 발행) → 발행된 이슈로 5 issue-coder(Agent, 병렬) → PR 나오면 6 pr-merger(Agent, 직렬).
60
+ - "스프린트 N 개발 진행해줘"(한 Sprint 통째) → **7 sprint-runner**(Skill). 4(발행)·5(구현)·6(머지)를 **내부에서 묶어** 돌리고 사람확인에서 멈춘다 → 수동으로 4→5→6 나열하지 말고 7로 보낸다.
59
61
  - 한 단계의 산출물(projectId·이슈번호·PR번호)을 다음 단계 입력으로 넘긴다.
60
62
 
61
63
  ## 경계/주의
@@ -7,7 +7,7 @@ description: |
7
7
  (1) PRD를 작성하거나 갱신할 때,
8
8
  (2) PRD 구성에서 Epic/스토리/태스크 구조를 후속 spec 작성에 매핑할 때,
9
9
  (3) Read-before-Write 규칙으로 PRD content를 안전하게 수정해야 할 때.
10
- version: 1.6.0
10
+ version: 1.6.2
11
11
  ---
12
12
 
13
13
  <!-- ch-version-gate -->
@@ -2,7 +2,7 @@
2
2
  name: 2t-decencia-channel-project-bootstrap
3
3
  description: 신규 기획을 사용자와 대화하며 step-by-step으로 소통채널 프로젝트로 만드는 오케스트레이터 스킬. (1)대화로 PRD 완성 → 승인 → (2)페이지명세(spec)+DB스키마 → 승인 → (3)SQA 시트. 각 단계 사용자 승인 게이트, 작성 디테일은 기존 2t-decencia-channel-*-v2 스킬을 적극 재사용. "새 기획 만들어줘"·"프로젝트 처음부터 세팅" 류 요청 시.
4
4
  allowed-tools: Bash(ch:*) Bash(git:*) Read Write
5
- version: 1.6.0
5
+ version: 1.6.2
6
6
  ---
7
7
 
8
8
  <!-- ch-version-gate -->
@@ -10,7 +10,7 @@ description: |
10
10
  (2) UI 메타데이터·비즈니스 로직·DB 참조를 함께 다룰 때,
11
11
  (3) Task를 JIRA 스타일(points·assignee·description·completedAt)로 잘게 쪼갤 때,
12
12
  (4) 신규 spec ID를 `LOGIN-001` 같은 JIRA 스타일로 부여하고 싶을 때 (`ch specs create --id`).
13
- version: 1.6.0
13
+ version: 1.6.2
14
14
  ---
15
15
 
16
16
  <!-- ch-version-gate -->
@@ -7,7 +7,7 @@ description: |
7
7
  (1) sprint를 구성할 때,
8
8
  (2) Story Point 합산 기반 sprint 용량 산정이 필요할 때,
9
9
  (3) Epic·도메인·의존성을 함께 고려해 spec을 sprint에 배분할 때.
10
- version: 1.6.0
10
+ version: 1.6.2
11
11
  ---
12
12
 
13
13
  <!-- ch-version-gate -->
@@ -0,0 +1,115 @@
1
+ ---
2
+ name: 2t-decencia-channel-sprint-runner
3
+ description: 특정 Sprint를 끝까지 실행(run)하는 오케스트레이터 스킬. Sprint의 spec을 시드로 이슈 목록을 분해·발행(github-issue)하고, GitHub milestone에 묶인 이슈를 상태별로 분류해 issue-coder(병렬)·pr-merger(직렬)로 전진시킨 뒤, 사람확인이 필요한 곳에서 멈춘다. 사람이 확인·체크 후 재호출하면 멱등하게 이어간다(반복 루프). "스프린트 돌려줘"·"sprint N 실행"·"이 스프린트 개발 진행해줘" 류 요청 시.
4
+ allowed-tools: Skill Agent Read Bash(ch:*) Bash(gh:*) Bash(git:*)
5
+ version: 1.6.2
6
+ ---
7
+
8
+ <!-- ch-version-gate -->
9
+ ## ⚠️ 시작 전 필수 — 버전 게이트 (생략 금지)
10
+
11
+ 이 스킬로 **어떤 작업이든 수행하기 전에 가장 먼저** 아래를 실행한다:
12
+
13
+ ```bash
14
+ ch check
15
+ ```
16
+
17
+ - exit code 0(통과)이 **아니면 즉시 중단**한다. 출력에 안내된 업데이트 명령(`npm install -g @decencia/ch-cli@latest` 또는 `ch setup-skill`)을 사용자에게 전달하고, 갱신이 끝나기 전까지 **이 스킬의 어떤 단계도 진행하지 않는다.**
18
+ - `ch`가 미설치/미인증이어도 먼저 `ch check`를 시도한다. (네트워크 불가 시 ch check는 통과시키되 경고를 남긴다.)
19
+
20
+ 구버전 스킬·CLI 사용을 막기 위한 게이트다. 건너뛰지 말 것.
21
+
22
+
23
+ # 2t-decencia-channel-sprint-runner — Sprint 실행 오케스트레이터
24
+
25
+ 하나의 Sprint를 **이슈 발행 → 구현 → 머지 → 사람확인 → 반복**까지 끝까지 굴리는 스킬.
26
+ 이 스킬은 **라우터/오케스트레이터**다 — 실제 발행은 `github-issue` 스킬, 구현은 `issue-coder` 에이전트, 머지는 `pr-merger` 에이전트가 한다. **중복 서술하지 않고 위임만** 한다.
27
+
28
+ 핵심 성질:
29
+ - **자체 상태를 두지 않는다.** GitHub(이슈 open/close·PR·milestone)가 SSOT. 매 호출마다 현재 상태를 읽어 **한 칸씩 전진**시키는 멱등 스킬.
30
+ - **사람확인이 끼는 대화형**이라 메인 세션에서 돈다(자율 에이전트로 던지지 않음). 단, 구현·머지 같은 **자율 작업은 `Agent`로 위임**.
31
+
32
+ ## 입력
33
+ - **Sprint 식별자**: 소통채널 `sprintId`(권장) 또는 GitHub `milestone` 이름.
34
+ - 실행 cwd = 대상 코드 repo (`.ch-project`로 projectId 확보).
35
+
36
+ ## 전제 (시작 시 확인)
37
+ - 인증: `gh auth status`, `ch auth status` — 미인증이면 중단하고 안내(`gh auth login` / `ch auth login`).
38
+ - `.ch-project`에서 `projectId` 확보.
39
+ - **이 스킬은 로컬 `gh`(사람 인증)로 동작한다 — PAT 불필요.** (PAT는 대시보드[ch-api] 전용)
40
+
41
+ ## 공통 규약 (다른 컴포넌트와 공유 — 깨지면 안 됨)
42
+ | 규약 | 값 |
43
+ |---|---|
44
+ | Sprint ↔ 이슈 묶음 | **GitHub `milestone`** (sprint 1개 = milestone 1개) |
45
+ | 이슈 ↔ spec | 이슈 본문 `## 관련 명세` specid 백링크 (**없어도 됨** = 인프라 등 비-spec 작업) |
46
+ | 사람확인 항목 | **소통채널 DB가 SSOT** — issue-coder가 `ch github checklist set` 으로 등록, 사람이 웹 실행 탭에서 체크·메모, pr-merger가 `ch github checklist get` 으로 close 판단 (GitHub 코멘트 아님) |
47
+ | 이슈 ↔ spec **status** | 착수=`developing`(coder), PR=`testing`(coder), **completed=러너가 롤업**(그 spec 백링크 이슈 전부 DONE일 때만) |
48
+
49
+ ---
50
+
51
+ ## 절차
52
+
53
+ ### 1. 이슈 목록 구성 (분해) — ⚠️ spec 1:1 매핑이 아니다
54
+ - `ch sprints get <id>` → 이 Sprint에 묶인 **spec 목록(시드)**.
55
+ - 시드만으로는 불완전하다(spec은 기획이라 인프라 구축 등 실행작업이 빠진다). → **spec에 없는 실행작업을 사용자와 짧게 확정해 보강**한다.
56
+ - 모호하면 추측하지 말고 **사용자에게 한 번 물어** 목록을 확정.
57
+ - 결과 = "이 Sprint를 끝내기 위한 완전한 할일 목록".
58
+
59
+ ### 2. milestone 준비 + 멱등 발행
60
+ - 이 Sprint의 **milestone 확보**: `gh api repos/{owner}/{repo}/milestones`로 조회, 없으면 생성(이름 = Sprint명/`sprint-<id>`).
61
+ - **멱등 체크(중복 발행 방지)**: `gh issue list --milestone "<m>" --state all` 로 기존 이슈 수집 → 각 할일이 **이미 이슈로 있는지**(제목 또는 `## 관련 명세` specid로 매칭) 확인.
62
+ - **없는 것만** 발행: `2t-decencia-channel-github-issue` 스킬을 **`Skill`로 호출**(표준 양식: 작업내용·관련명세 백링크·완료조건). 발행 후 **각 이슈에 milestone 지정**(`gh issue edit <n> --milestone "<m>"`).
63
+ - ⚠️ github-issue 스킬은 중복방지를 안 한다 → **무엇을 발행할지(=없는 것만)는 이 스킬이 책임진다.**
64
+
65
+ ### 3. 상태 분류
66
+ `gh issue list --milestone "<m>" --state all` + 각 이슈의 연결 PR/CI를 보고 **이슈별 상태**를 판정한다.
67
+
68
+ | 상태 | 판별 | 다음 동작 |
69
+ |---|---|---|
70
+ | `TODO` | open + 연결 PR 없음 | issue-coder (병렬) |
71
+ | `IN_PR` green | open PR + `gh pr checks` green + 충돌 없음 | pr-merger (직렬) |
72
+ | `IN_PR` red/conflict | CI red 또는 모호한 충돌 | 블로커 — 사람 보고(머지 금지) |
73
+ | `AWAIT_HUMAN` | PR 머지됨 + 이슈 open + **체크리스트 미체크 남음**(`ch github checklist get`) | **사람 게이트 — 멈춤** |
74
+ | `FEEDBACK` | 미체크 항목에 **note(수정 방향)가 달림** 또는 이슈 재오픈 | issue-coder 재투입 (병렬, note 반영) |
75
+ | `DONE` | 이슈 close | 완료 카운트 |
76
+
77
+ ### 4. 자동 전진 (디스패치)
78
+ - **병렬 — `Agent`**: `TODO` + `FEEDBACK` 이슈 각각을 `2t-decencia-channel-issue-coder`로 위임(각자 worktree 격리, 독립 이슈). 여러 개면 **한 메시지에 Agent 여러 개**로 동시 실행.
79
+ - **직렬 — `Agent`**: `IN_PR(green)` 이슈를 `2t-decencia-channel-pr-merger`로 **한 번에 하나씩** 위임(머지하면 main 바뀜 → 다음 PR mergeability 재평가, 레이스 방지).
80
+ - 코더가 PR을 만들면 다음 호출 때 `IN_PR`로 잡혀 머저로 넘어간다(단계 사이 배리어는 GitHub 상태가 대신함).
81
+
82
+ ### 4.5 스펙 status 롤업 (전역 시야 — 러너만 가능)
83
+ - milestone 이슈들의 `## 관련 명세` 백링크를 모아 **spec → 이슈 집합** 역인덱스를 만든다.
84
+ - 각 spec에 대해: 백링크한 이슈가 **전부 DONE(close)** 이면 `ch specs set-status <specid> completed`.
85
+ - 하나라도 미완(TODO/IN_PR/AWAIT_HUMAN/FEEDBACK)이면 **올리지 않는다**(부분완료 spec은 testing/developing 유지).
86
+ - 멱등: 이미 completed면 skip. 백링크 이슈가 0개인 spec은 대상 아님.
87
+
88
+ ### 5. 사람 게이트 + 리포트
89
+ 더 자동 전진할 게 없으면 멈추고 **현황을 요약 보고**한다:
90
+ - ✅ **DONE** n개
91
+ - ⏳ **AWAIT_HUMAN** m개 — 이슈 링크 + 미체크 항목(사람확인 체크리스트) 바로 확인할 수 있게
92
+ - ⛔ **블로커** k개 — CI red/모호한 충돌(어느 이슈·PR인지)
93
+ - 안내: **"확인·체크(또는 피드백) 후 다시 이 스킬을 같은 Sprint로 호출하면 이어서 진행합니다."**
94
+
95
+ ### 6. 반복 (멱등 재호출)
96
+ - 사람이 확인·체크하거나 피드백을 남긴 뒤 **재호출** → 1~5 반복.
97
+ - 이미 끝난 건(DONE, 머지된 PR, 발행된 이슈)은 자연히 **skip**된다(상태 SSOT = GitHub). 새로 생긴 `FEEDBACK`만 다시 흐른다.
98
+ - **종료 조건**: milestone의 모든 이슈가 `DONE` + 백링크된 spec이 모두 `completed`로 롤업됨.
99
+
100
+ ---
101
+
102
+ ## 병렬/직렬 규칙 (재확인)
103
+ - **issue-coder = 병렬**(독립 이슈, worktree 격리).
104
+ - **pr-merger = 직렬**(main 변동 → 다음 PR 재평가, 동시 머지 금지).
105
+ - 한 호출에서 **코딩(병렬)을 먼저 띄우고, 이미 green인 PR을 머지(직렬)** 하는 식으로 섞어도 되지만, **같은 이슈에 코더와 머저를 동시에 걸지 않는다.**
106
+
107
+ ## 경계 / 주의
108
+ - 이 스킬은 **분해·분류·위임·보고만** 한다. 구현/머지/리뷰 디테일은 각 에이전트가 책임(재SQA·전면 재리뷰 안 함).
109
+ - **이슈 close·main push는 하지 않는다** — issue-coder는 PR까지, pr-merger가 조건부 close(사람확인 미체크면 open 유지). 이 스킬도 그 경계를 침범하지 않는다.
110
+ - **무한루프 금지**: 블로커(CI red·모호한 충돌·요구 모호)는 **자동 해결 시도하지 말고 사람에게 핸드오프**.
111
+ - 배포는 master 머지 시 GitHub Actions 자동 — 이 스킬은 **수동 배포/머지 트리거를 하지 않는다**.
112
+ - 공통 함정(전 컴포넌트 공유): ch CLI content는 마크다운+CRLF 정제, spec 필드 단수+복수 동시, `--json`/`specs get` 윈도우 빈출력 시 PowerShell `Out-File` 우회 — 위임 대상이 이미 준수.
113
+
114
+ ## 다른 컴포넌트와의 관계
115
+ - **대시보드(web "실행" 탭 + ch-api `github` 모듈)** 는 같은 규약(milestone=sprint, 체크리스트 포맷)을 공유하는 **관측·사람게이트 UI**다. 이 스킬은 손발, 대시보드는 눈 — 서로 GitHub 상태를 통해 맞물린다(코드 공유 없음).
@@ -12,7 +12,7 @@ description: |
12
12
  (4) 명세 영역별 완성형 TC 번들(퍼블리싱/프론트/백엔드 디센시아 운영 관점 포함)을 가져다 쓸 때,
13
13
  (5) 새 명세 작업 중 반복 패턴을 발견해 영역별 번들을 보강할 때,
14
14
  (6) Sprint 종료 전 spec별 SQA 통과 여부를 점검할 때.
15
- version: 1.6.0
15
+ version: 1.6.2
16
16
  ---
17
17
 
18
18
  <!-- ch-version-gate -->
@@ -8,7 +8,7 @@ description: |
8
8
  (2) "작업 현황 적어줘", "workStatus 갱신해줘" 요청 시,
9
9
  (3) Sprint 종료 회고나 인수인계용으로 spec별 진행 상태를 정리할 때,
10
10
  (4) `ch specs update --work-status` 또는 웹 "작업 현황" 탭에서 갱신할 때.
11
- version: 1.6.0
11
+ version: 1.6.2
12
12
  ---
13
13
 
14
14
  <!-- ch-version-gate -->