@decencia/ch-cli 1.0.0 → 1.1.0

package/dist/commands/setup-skill.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSetupSkillCommand(program: Command): void;
+//# sourceMappingURL=setup-skill.d.ts.map

package/dist/commands/setup-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-skill.d.ts","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyBhE"}

package/dist/commands/setup-skill.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSetupSkillCommand = registerSetupSkillCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const output_1 = require("../output");
+function registerSetupSkillCommand(program) {
+    program
+        .command('setup-skill')
+        .description('Claude Code 스킬을 ~/.claude/skills/에 설치')
+        .action(() => {
+        const srcPath = path.join(__dirname, '..', 'skill', 'SKILL.md');
+        const destDir = path.join(os.homedir(), '.claude', 'skills', '2t-decencia-channel-cli');
+        const destPath = path.join(destDir, 'SKILL.md');
+        try {
+            if (!fs.existsSync(srcPath)) {
+                (0, output_1.printError)(`패키지 내 SKILL.md를 찾을 수 없습니다: ${srcPath}`);
+                return;
+            }
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            fs.copyFileSync(srcPath, destPath);
+            (0, output_1.printSuccess)(`Claude Code 스킬이 설치되었습니다: ~/.claude/skills/2t-decencia-channel-cli/SKILL.md`);
+        }
+        catch (err) {
+            (0, output_1.printError)(`스킬 설치 중 오류가 발생했습니다: ${err.message}`);
+        }
+    });
+}
+//# sourceMappingURL=setup-skill.js.map

package/dist/commands/setup-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-skill.js","sourceRoot":"","sources":["../../src/commands/setup-skill.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,8DAyBC;AA9BD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,sCAAqD;AAErD,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,yBAAyB,CAAC,CAAC;QACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,IAAA,mBAAU,EAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnC,IAAA,qBAAY,EAAC,4EAA4E,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAA,mBAAU,EAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.js

@@ -51,6 +51,7 @@ const prd_1 = require("./commands/prd");
 const db_schema_1 = require("./commands/db-schema");
 const notifications_1 = require("./commands/notifications");
 const dashboard_1 = require("./commands/dashboard");
+const setup_skill_1 = require("./commands/setup-skill");
 // Read version from package.json
 function getVersion() {
     try {
@@ -89,6 +90,7 @@ program
 (0, db_schema_1.registerDbSchemaCommand)(program);
 (0, notifications_1.registerNotificationsCommand)(program);
 (0, dashboard_1.registerDashboardCommand)(program);
+(0, setup_skill_1.registerSetupSkillCommand)(program);
 // Parse and execute
 program.parseAsync(process.argv).catch((err) => {
     console.error(err);

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,wCAAoD;AACpD,wCAAoD;AACpD,kDAA8D;AAC9D,gDAA4D;AAC5D,sDAAiE;AACjE,wCAAoD;AACpD,oDAA+D;AAE/D,4DAAwE;AACxE,oDAAgE;AAEhE,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;AAEjC,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAElC,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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;AAE/D,4DAAwE;AACxE,oDAAgE;AAChE,wDAAmE;AAEnE,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;AAEjC,IAAA,4CAA4B,EAAC,OAAO,CAAC,CAAC;AACtC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;AAClC,IAAA,uCAAyB,EAAC,OAAO,CAAC,CAAC;AAEnC,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

@@ -1,11 +1,15 @@
 {
   "name": "@decencia/ch-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Decencia Communication Channel CLI",
   "main": "dist/index.js",
   "bin": {
     "ch": "dist/index.js"
   },
+  "files": [
+    "dist/",
+    "skill/"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",

package/skill/SKILL.md

@@ -0,0 +1,490 @@
+---
+name: "[2t] decencia-channel-cli"
+tier: 2t
+description: |
+  [2t] 디센시아 소통채널 CLI(ch) 설치, 설정, 사용법 가이드. AI 에이전트가 소통채널 내 문서(PRD, 기능명세, 스프린트, QnA, SQA, 아카이브, 개발현황, DB 스키마)를 CLI로 조작할 수 있도록 한다.
+  Use when: (1) 소통채널 CLI를 설치하거나 설정할 때,
+  (2) AI 에이전트가 소통채널 데이터를 조회/조작해야 할 때,
+  (3) "ch" 명령어 사용법이 필요할 때,
+  (4) "소통채널 CLI" or "ch-cli" 관련 작업을 할 때,
+  (5) 프로젝트의 기능명세/스프린트/QnA/SQA/아카이브/개발현황/DB스키마를 CLI로 관리할 때.
+---
+
+# Decencia Communication Channel CLI (ch)
+
+소통채널의 모든 기능을 CLI로 조작하는 도구. API Key + Project ID 인증 기반.
+
+## 1. 설치
+
+```bash
+# npm에서 글로벌 설치 (권장)
+npm install -g @decencia/ch-cli
+
+# 또는 소스에서 직접 빌드
+cd C:\myprojects\decenciahomepage\ch-cli
+npm install && npm run build
+npm link
+```
+
+## 2. 초기 설정
+
+### 2-1. 로그인 (글로벌 설정)
+
+```bash
+# API Key + Project ID로 로그인 (설정은 ~/.ch/config.json에 저장)
+ch auth login --key <API_KEY> --project-id <PROJECT_ID>
+
+# 인증 상태 확인
+ch auth status
+
+# 프로젝트 전환
+ch auth switch --project-id <OTHER_PROJECT_ID>
+
+# 로그아웃
+ch auth logout
+```
+
+### 2-2. 로컬 프로젝트 설정 (.ch-project)
+
+여러 프로젝트를 오갈 때 projectId가 뒤바뀌는 사고를 방지하기 위해, 프로젝트 디렉토리마다 `.ch-project` 파일을 생성한다.
+
+```bash
+# 현재 디렉토리에 .ch-project 파일 생성 (API에서 프로젝트명 자동 조회)
+ch init --project-id <PROJECT_ID>
+
+# 프로젝트명 직접 지정
+ch init --project-id <PROJECT_ID> --project-name "프로젝트명"
+
+# 현재 설정 상태 확인 (로컬 + 글로벌)
+ch status
+```
+
+#### 설정 우선순위
+
+```
+--project CLI 옵션  >  .ch-project (로컬)  >  ~/.ch/config.json (글로벌)
+```
+
+- `.ch-project` 파일은 현재 디렉토리 → 상위 디렉토리로 탐색 (monorepo 지원)
+- `.ch-project`에 `projectName`이 있으면 CLI 출력에 프로젝트명 프리픽스 표시:
+  `[법인·개인 자동수취 프로그램] DB 스키마가 저장되었습니다.`
+
+#### .ch-project 파일 형식
+```json
+{
+  "projectId": "yRZxS9CFfMa3Y0Q5Ey7x",
+  "projectName": "법인·개인 자동수취 프로그램"
+}
+```
+
+#### ~/.ch/config.json (글로벌 설정)
+```json
+{
+  "apiKey": "발급받은 API Key",
+  "projectId": "프로젝트 ID (폴백용)",
+  "apiUrl": "https://ch-api-618529407342.asia-northeast3.run.app",
+  "defaultFormat": "table"
+}
+```
+
+> **주의**: `.ch-project` 없이 글로벌 config만 사용하면, 프로젝트를 전환할 때 다른 프로젝트에 데이터가 들어가는 사고가 발생할 수 있다. **프로젝트 디렉토리마다 `ch init`을 실행하는 것을 강력 권장한다.**
+
+## 3. 글로벌 옵션
+
+모든 명령에 적용 가능한 옵션:
+
+| 옵션 | 설명 |
+|------|------|
+| `--json` | JSON 형식 출력 (AI 에이전트 파싱에 적합) |
+| `--table` | 테이블 형식 출력 (기본값) |
+| `--csv` | CSV 형식 출력 |
+| `--project <id>` | 프로젝트 ID 오버라이드 (config 무시) |
+| `--verbose` | 상세 로그 (디버깅용) |
+| `--quiet` | 결과만 출력 (스크립팅용) |
+| `--dry-run` | 쓰기 작업 시뮬레이션 (실제 반영 안함) |
+
+**AI 에이전트 사용 시 `--json` 필수 권장** — 파싱이 쉬운 JSON 출력.
+
+## 4. 전체 명령어 레퍼런스
+
+---
+
+### 4.0 init / status — 로컬 프로젝트 설정
+
+```bash
+ch init --project-id <PID> [--project-name <NAME>]   # .ch-project 파일 생성
+ch status                                              # 현재 프로젝트 설정 상태 확인
+```
+
+---
+
+### 4.1 auth — 인증/세션 관리
+
+```bash
+ch auth login --key <KEY> --project-id <PID> [--api-url <URL>]  # 로그인
+ch auth status                                                    # 인증 상태 확인
+ch auth logout                                                    # 로그아웃
+ch auth switch --project-id <PID>                                 # 프로젝트 전환
+ch auth keys list                                                 # API Key 목록
+ch auth keys create --name <NAME>                                 # API Key 발급
+ch auth keys revoke <keyId>                                       # API Key 폐기
+```
+
+---
+
+### 4.2 projects — 프로젝트 관리
+
+```bash
+ch projects list                                        # 프로젝트 목록
+ch projects create --name <NAME> [--desc <DESC>]        # 프로젝트 생성
+ch projects info                                        # 현재 프로젝트 상세
+ch projects update [--name <NAME>] [--desc <DESC>]      # 프로젝트 수정
+ch projects archive                                     # 아카이브
+ch projects unarchive                                   # 아카이브 해제
+ch projects delete --confirm <PROJECT_NAME>             # 영구 삭제
+
+# 스키마 관리 (기능명세의 드롭다운 옵션 설정)
+ch projects set-schema [--devices d1,d2] [--domains d1,d2] [--types t1,t2] [--permissions p1,p2]
+ch projects get-schema                                  # 현재 스키마 조회
+```
+
+---
+
+### 4.3 prd — PRD 관리
+
+```bash
+# 조회
+ch prd get                                              # PRD 조회
+
+# 생성/수정
+ch prd set --title <TITLE> --content <CONTENT>          # PRD 생성/수정
+ch prd set --title <TITLE> --content "$(cat prd.md)"    # 파일에서 읽어서 설정
+ch prd set --title <TITLE> --content <CONTENT> --new-version  # 새 버전으로 기록
+
+# 버전 이력
+ch prd versions                                         # PRD 버전 이력 조회
+```
+
+**권한**: admin, developer만 생성/수정 가능. 전체 역할 조회 가능.
+
+---
+
+### 4.4 specs — 기능명세 관리
+
+```bash
+# 메타/스키마 조회
+ch specs meta                                           # 드롭다운 옵션 조회 (devices, domains, types, permissions)
+
+# 조회
+ch specs list [--device <DEV>] [--domain <DOM>] [--type <TYPE>] [--status <STATUS>] [--group-by <FIELD>] [--search <KEYWORD>] [--sort <FIELD>] [--desc] [--page N] [--per-page N]
+ch specs get <specId>
+ch specs versions <specId>                              # 버전 이력
+ch specs related <specId> --type sprints|qna|sqa        # 관련 데이터
+ch specs export [--format json|csv]                     # 전체 내보내기
+
+# 생성/수정/삭제
+ch specs create --name <NAME> --device <DEV> --domain <DOM> --type <TYPE> [--permission <PERM>] [--content <CONTENT>] [--dto <DTO>] [--status <STATUS>] [--note <NOTE>]
+ch specs update <specId> [--name] [--device] [--domain] [--type] [--permission] [--content] [--dto] [--status] [--note] [--new-version]
+ch specs set-status <specId> <STATUS>
+ch specs delete <specId>
+```
+
+**상태 전이 규칙**: 정의됨 → 개발중 → 개발완료 → 검수완료 (역방향 불가)
+
+---
+
+### 4.5 sprints — 스프린트 관리
+
+```bash
+# 조회
+ch sprints list [--status scheduled|inProgress|completed] [--sort <FIELD>] [--desc] [--page N]
+ch sprints get <sprintId>
+ch sprints timeline [--weeks N]                         # 타임라인 (기본 8주)
+ch sprints progress <sprintId>                          # 진행률
+
+# 생성/수정/삭제
+ch sprints create --name <NAME> --start YYYY-MM-DD --end YYYY-MM-DD [--content <CONTENT>] [--status <STATUS>] [--specs id1,id2,...]
+ch sprints update <sprintId> [--name] [--content] [--status]
+ch sprints set-status <sprintId> <STATUS>
+ch sprints set-dates <sprintId> --start YYYY-MM-DD --end YYYY-MM-DD
+
+# 기능명세 연결
+ch sprints add-specs <sprintId> <specId1,specId2,...>
+ch sprints remove-specs <sprintId> <specId1,specId2,...>
+
+ch sprints delete <sprintId>
+```
+
+---
+
+### 4.6 qna — QnA 관리
+
+```bash
+# 조회
+ch qna list [--status awaitingReply|replied|reflected] [--category modification|question|etc] [--search <KEYWORD>] [--sort <FIELD>] [--desc] [--page N]
+ch qna get <qnaId>
+ch qna pending-count                                    # 답변대기 건수
+ch qna navigate <qnaId> --direction prev|next           # 이전/다음
+
+# 생성/수정/삭제
+ch qna create --title <TITLE> --category <CAT> --content <CONTENT> [--spec <SPEC_ID>]
+ch qna answer <qnaId> --content <ANSWER>                # 답변 등록
+ch qna update-answer <qnaId> --content <NEW_ANSWER>     # 답변 수정
+ch qna reflect <qnaId> --note <REFLECTION_NOTE>         # 반영 완료
+ch qna delete <qnaId>
+```
+
+---
+
+### 4.7 sqa — SQA 관리 (시트 + 수행 2계층 구조)
+
+SQA는 **시트(Sheet)**와 **수행(Run)** 2계층으로 구성된다:
+- **시트**: 테스트 항목의 템플릿. 여러 번 재사용 가능.
+- **수행(Run)**: 시트를 기반으로 특정 날짜에 실행한 테스트 인스턴스.
+
+```bash
+# === 시트(Sheet) 관리 ===
+ch sqa list [--sort <FIELD>] [--desc] [--page N]        # 시트 목록
+ch sqa get <sheetId>                                    # 시트 상세 (항목 포함)
+ch sqa create --name <NAME>                             # 시트 생성
+ch sqa update <sheetId> [--name <NAME>]                 # 시트 수정
+ch sqa delete <sheetId>                                 # 시트 삭제
+
+# 시트에 테스트 항목 추가
+ch sqa add-item <sheetId> --test <TEST_ITEM> [--spec <SPEC_ID>]
+
+# === 수행(Run) 관리 ===
+ch sqa start-run <sheetId> --date YYYY-MM-DD            # 시트 기반으로 수행 시작
+ch sqa runs [--sort <FIELD>] [--desc] [--page N]        # 수행 목록
+ch sqa run <runId>                                      # 수행 상세
+ch sqa delete-run <runId>                               # 수행 삭제
+
+# 수행에서 항목 체크
+ch sqa check <runId> <itemId> --result yes|no [--note <NOTE>]
+ch sqa check-bulk <runId> --file results.json           # 일괄 체크
+
+# 수행 완료/집계/내보내기
+ch sqa complete <runId>                                 # 수행 완료 처리
+ch sqa summary <runId>                                  # Pass/Fail 집계
+ch sqa export <runId> --output <FILE_PATH>              # 엑셀 Export
+
+# === Import ===
+ch sqa import --file <EXCEL_PATH> [--name <NAME>] [--date YYYY-MM-DD]
+ch sqa import-preview --file <EXCEL_PATH>               # 미리보기
+```
+
+**일괄 체크 JSON 형식**:
+```json
+{
+  "results": [
+    { "itemId": "item1", "result": "yes", "note": "정상" },
+    { "itemId": "item2", "result": "no", "note": "버그 발견" }
+  ]
+}
+```
+
+---
+
+### 4.8 archives — 아카이브 관리
+
+```bash
+# 조회
+ch archives list [--category <CAT>] [--date-from YYYY-MM-DD] [--date-to YYYY-MM-DD] [--search <KEYWORD>] [--sort <FIELD>] [--desc] [--page N]
+ch archives get <archiveId>
+ch archives navigate <archiveId> --direction prev|next
+
+# 생성/수정/삭제
+ch archives create --title <TITLE> --category <CAT> --date YYYY-MM-DD [--files path1,path2] [--memo <MEMO>]
+ch archives update <archiveId> [--title] [--category] [--date] [--memo]
+ch archives delete <archiveId>
+
+# 파일 관리
+ch archives add-files <archiveId> --files path1,path2
+ch archives remove-file <archiveId> <fileName>
+ch archives download <archiveId> --output <DIR> [--file <FILENAME>]
+
+# 카테고리 관리
+ch archives categories list
+ch archives categories add <NAME>
+ch archives categories remove <NAME>
+```
+
+---
+
+### 4.9 members — 멤버 관리
+
+```bash
+ch members list                                         # 멤버 목록
+ch members invite --email <EMAIL> --role developer|client
+ch members set-role <userId> --role admin|developer|client
+ch members remove <userId>
+```
+
+---
+
+### 4.10 dev-status — 개발현황 문서 관리
+
+스프린트/기능명세와 연계되는 개발현황 문서를 관리한다.
+
+```bash
+# 조회
+ch dev-status list [--sprint <SPRINT_ID>] [--spec <SPEC_ID>] [--search <KEYWORD>] [--sort <FIELD>] [--desc] [--page N] [--per-page N]
+ch dev-status get <docId>
+ch dev-status versions <docId>                          # 버전 이력
+
+# 생성/수정/삭제
+ch dev-status create --title <TITLE> [--content <CONTENT>] [--sprints id1,id2] [--specs id1,id2]
+ch dev-status update <docId> [--title] [--content] [--sprints id1,id2] [--specs id1,id2] [--change-note <NOTE>] [--new-version]
+ch dev-status delete <docId>
+```
+
+---
+
+### 4.11 db-schema — DB 스키마 관리
+
+```bash
+ch db-schema get                                        # DB 스키마 조회
+ch db-schema set --title <TITLE> --content <CONTENT> [--db-type firestore|supabase|mysql|generic] [--new-version]
+ch db-schema versions                                   # 버전 이력
+```
+
+---
+
+### 4.12 notifications — 알림 설정
+
+```bash
+ch notifications get                                    # 현재 설정 조회
+ch notifications set-webhook [--kakao <URL>] [--slack <URL>]
+ch notifications remove-webhook [--kakao] [--slack]
+ch notifications test [--kakao] [--slack]               # 테스트 발송
+ch notifications toggle <eventName> [--on|--off]        # 이벤트 알림 토글
+ch notifications logs [--page N]                        # 발송 로그
+```
+
+---
+
+### 4.13 dashboard — 대시보드
+
+```bash
+ch dashboard                                            # 전체 요약
+ch dashboard progress                                   # 전체 진행률
+ch dashboard sprint                                     # 현재 Sprint 요약
+ch dashboard qna-pending                                # 답변대기 QnA
+ch dashboard sqa-latest                                 # 최근 SQA 결과
+ch dashboard recent-changes [--limit N]                 # 최근 변경 (기본 10건)
+ch dashboard members-summary                            # 멤버 요약
+```
+
+---
+
+## 5. AI 에이전트 사용 패턴
+
+### 기본 원칙
+1. 항상 `--json` 옵션으로 JSON 출력을 사용한다
+2. 쓰기 작업 전 `--dry-run`으로 시뮬레이션하여 확인할 수 있다
+3. 에러 발생 시 stderr에 한국어 메시지가 출력된다
+4. **[필수] 기능명세 생성/수정 전 반드시 `ch specs meta --json`으로 드롭다운 옵션을 먼저 조회하고, schema에 정의된 값만 사용한다**
+   - devices, domain, featureTypes, permissions 필드는 프로젝트에 정의된 옵션 값을 **그대로** 사용해야 한다
+   - 임의의 영문 번역(예: "웹" → "web")이나 축약어를 사용하면 안 된다
+   - schema에 없는 값을 사용하면 API가 `400 BadRequest`로 거부한다
+
+### 에이전트 세션 초기화 예시
+```bash
+# 0. 프로젝트 디렉토리에서 로컬 설정 (최초 1회, 강력 권장)
+ch init --project-id "proj_xxxxx"
+
+# 1. 로그인 (최초 1회)
+ch auth login --key "sk-xxxxx" --project-id "proj_xxxxx"
+
+# 1-1. 현재 설정 확인 (어떤 프로젝트에 연결되어 있는지)
+ch status
+
+# 2. 대시보드로 프로젝트 상태 파악
+ch dashboard --json
+
+# 3. 기능명세 메타 조회 (드롭다운 옵션 확인 — 생성/수정 전 필수!)
+ch specs meta --json
+# → schema.devices, schema.domains, schema.featureTypes, schema.permissions 확인
+
+# 4. 기능명세 전체 조회
+ch specs list --json --per-page 100
+```
+
+### 일반적인 워크플로우
+
+#### 기능명세 생성 및 스프린트 연결
+```bash
+# [필수] 먼저 메타 조회 → 사용 가능한 옵션 확인
+ch specs meta --json
+# 예시 응답: schema.devices=["웹","모바일","키오스크"], schema.domains=["사용자","관리자"], ...
+
+# 기능명세 생성 — schema에서 확인한 값을 그대로 사용
+ch specs create --name "로그인 기능" --device "웹" --domain "사용자" --type "인증" --json
+
+# 생성된 specId 확인 후 스프린트에 연결
+ch sprints add-specs <sprintId> <specId>
+```
+
+#### QnA 답변 처리
+```bash
+# 답변대기 QnA 확인
+ch qna list --status awaitingReply --json
+
+# 답변 등록
+ch qna answer <qnaId> --content "답변 내용"
+
+# 반영 완료 처리
+ch qna reflect <qnaId> --note "v1.2에 반영됨"
+```
+
+#### SQA 테스트 수행 (시트 → 수행 → 체크)
+```bash
+# 1. 시트 조회
+ch sqa list --json
+ch sqa get <sheetId> --json
+
+# 2. 시트 기반으로 수행(Run) 시작
+ch sqa start-run <sheetId> --date 2026-05-14
+
+# 3. 수행에서 항목 체크 (runId 사용!)
+ch sqa check <runId> <itemId> --result yes
+ch sqa check <runId> <itemId> --result no --note "재현됨"
+
+# 또는 일괄 체크
+ch sqa check-bulk <runId> --file results.json
+
+# 4. 수행 완료
+ch sqa complete <runId>
+
+# 5. 결과 확인
+ch sqa summary <runId>
+```
+
+## 6. 인프라 정보
+
+| 항목 | 값 |
+|------|------|
+| npm 패키지 | `@decencia/ch-cli` |
+| API 서버 | Cloud Run (asia-northeast3) |
+| API URL | `https://ch-api-618529407342.asia-northeast3.run.app` |
+| Swagger 문서 | `https://ch-api-618529407342.asia-northeast3.run.app/api/docs` |
+| GCP 프로젝트 | `decenciasofthomepage` |
+| DB | Firebase Firestore (ch_ 접두사 컬렉션) |
+| 파일 저장소 | Firebase Storage |
+| 인증 방식 | Bearer Token (API Key) + X-Project-Id 헤더 |
+| 역할(RBAC) | admin, developer, client |
+| CLI 소스 | `C:\myprojects\decenciahomepage\ch-cli` |
+| API 소스 | `C:\myprojects\decenciahomepage\ch-api` |
+| 소통채널 웹앱 | `C:\myprojects\decencia-channel` (channel.decenciasoft.com) |
+
+## 7. 트러블슈팅
+
+| 증상 | 원인 | 해결 |
+|------|------|------|
+| `API Key가 설정되지 않았습니다` | 로그인 안됨 | `ch auth login --key ... --project-id ...` |
+| `인증 실패` (401) | API Key 무효/만료 | 새 키 발급: `ch auth keys create --name "new"` |
+| `권한이 없습니다` (403) | 역할 부족 | admin에게 역할 변경 요청 |
+| `리소스를 찾을 수 없습니다` (404) | 잘못된 ID | `--json`으로 목록 조회 후 ID 재확인 |
+| `서버에 연결할 수 없습니다` | 네트워크/URL 문제 | `--verbose`로 요청 URL 확인 |
+| 다른 프로젝트에 데이터 들어감 | `.ch-project` 미설정 | `ch init --project-id <PID>`로 로컬 설정 |
+| `ch status`에서 projectId 불일치 | 로컬/글로벌 설정 충돌 | `ch status`로 확인 후 `.ch-project` 재설정 |