@decencia/ch-cli 1.3.4 → 1.4.0

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

@@ -0,0 +1,189 @@
+---
+name: 2t-decencia-channel-work-status-v2
+description: |
+  [2t][v2] 소통채널 spec.workStatus(작업 현황) 작성/갱신 가이드.
+  spec 작성 시점이 아니라 **개발 진행 중에 누적 갱신**되는 작업 일지 전용.
+  Use when:
+  (1) spec 개발 진행 중 일지·블로커·의사결정을 기록할 때,
+  (2) "작업 현황 적어줘", "workStatus 갱신해줘" 요청 시,
+  (3) Sprint 종료 회고나 인수인계용으로 spec별 진행 상태를 정리할 때,
+  (4) `ch specs update --work-status` 또는 웹 "작업 현황" 탭에서 갱신할 때.
+version: 1.4.0
+---
+
+<!-- ch-version-gate -->
+## ⚠️ 시작 전 필수 — 버전 게이트 (생략 금지)
+
+이 스킬로 **어떤 작업이든 수행하기 전에 가장 먼저** 아래를 실행한다:
+
+```bash
+ch check
+```
+
+- exit code 0(통과)이 **아니면 즉시 중단**한다. 출력에 안내된 업데이트 명령(`npm install -g @decencia/ch-cli@latest` 또는 `ch setup-skill`)을 사용자에게 전달하고, 갱신이 끝나기 전까지 **이 스킬의 어떤 단계도 진행하지 않는다.**
+- `ch`가 미설치/미인증이어도 먼저 `ch check`를 시도한다. (네트워크 불가 시 ch check는 통과시키되 경고를 남긴다.)
+
+구버전 스킬·CLI 사용을 막기 위한 게이트다. 건너뛰지 말 것.
+
+
+# spec.workStatus — 작업 일지
+
+`spec.workStatus`는 spec 자체를 작성하는 시점이 아니라, **그 spec을 실제로 개발하면서 누적되는 일지**다. 그래서 spec 작성 스킬과는 라이프사이클이 분리되어 있다.
+
+---
+
+## 0. Read-before-Write (BLOCKING)
+
+기존 일지를 통째로 날리지 않도록 항상 기존 본문을 먼저 받아서 그 위에 append/edit 한다.
+
+```bash
+ch specs get <specId> --json | jq -r '.workStatus // ""' > /tmp/status.md
+# /tmp/status.md를 열어 새 엔트리 추가 (윗부분 또는 아랫부분)
+ch specs update <specId> --work-status /tmp/status.md --no-version
+```
+
+`--work-status`는 **본문 통째 교체**. 기존 내용이 있는 상태에서 짧은 새 파일만 보내면 옛 일지가 날아간다.
+
+---
+
+## 1. 언제 갱신하는가
+
+| 시점 | 내용 예시 |
+|---|---|
+| **개발 착수일** | `D-0: 설계 완료, Firebase Auth v9 채택` |
+| **하루 작업 종료 시** | `D-3: 로그인 폼 구현 완료. 다음: 잠금 로직` |
+| **블로커 발생 시** | `[BLOCK] Figma 노드 12345:67890 미확정 — 디자이너 대기` |
+| **의사결정 시** | `[DECISION] RC4 호환성 문제로 SDK v8 유지` |
+| **외부 의존이 풀린 시점** | `[UNBLOCK] D-5 Figma 확정, 진행 재개` |
+| **Sprint 회고 시** | `[RETRO] 잠금 로직은 별도 spec으로 분리 결정` |
+
+spec 작성 시점에는 비어 있는 게 정상. workStatus는 "방금 만든 명세"가 아니라 "진행 중인 작업"에 붙는다.
+
+---
+
+## 2. 권장 포맷 — D-N 일지 + 태그
+
+```markdown
+## 2026-06-01 ~ 2026-06-14 (Sprint 1)
+
+### D-0 (06-01)
+- 설계 완료, Firebase Auth v9 채택
+- 의존: spec [회원가입] 의 users 테이블 스키마 확정 필요
+
+### D-2 (06-03)
+- 로그인 폼 UI 구현 완료 (Task: 491be2f9)
+- React Hook Form + Yup
+- [DECISION] 비밀번호 표시 토글은 input 우측 아이콘으로
+
+### D-3 (06-04)
+- [BLOCK] Firebase Auth rate limit 응답이 spec에 없음 — Sprint 계획 시 누락
+- 임시: 클라이언트 throttle로 우회. 영구 해결은 별도 spec [인증 rate limit] 분리
+
+### D-5 (06-06)
+- [UNBLOCK] PM이 [인증 rate limit] spec 추가, 다음 sprint 배정
+- 잠금 로직(5회 실패 → 1시간) 구현 진행
+
+## 참고 링크
+- PR: github.com/.../pull/123
+- Figma: figma.com/file/.../?node-id=12345:67890
+- 관련 spec: [인증 rate limit] (id: xxx)
+```
+
+권장 태그:
+- `[DECISION]` 의사결정 로그
+- `[BLOCK]` 외부 의존으로 멈춤
+- `[UNBLOCK]` 의존 해소
+- `[RETRO]` Sprint 회고 메모
+- `[NOTE]` 일반 메모
+
+---
+
+## 3. 무엇을 적고, 무엇을 적지 않는가
+
+### 적어야 할 것
+- 개발 진척 일자별 메모
+- 블로커와 그 우회/해소 기록
+- 설계 변경 이유 (왜 v9가 아니라 v8을 썼는지)
+- 외부 의존 (디자이너 컨펌, 다른 spec, 인프라 상태)
+- 참고 링크 (PR, 이슈, Figma, 회의록)
+
+### 적지 말 것
+| 잘못된 위치 | 진짜 위치 |
+|---|---|
+| AC/완료 보고 ("로그인 통과 확인") | SQA 항목 |
+| 작업 정의 ("Firebase Auth 연결할 것") | tasks[].description |
+| 영구 도메인 규칙 ("5회 실패 시 잠금") | logic.businessRules |
+| 화면 인터랙션 ("입력 → 검증") | ui.interactionMap |
+| 컬럼 스펙 | db-tables 문서 |
+
+→ workStatus는 **시간축 기록**. 시점이 의미를 가지는 것만 적는다. 항구적 규칙은 다른 필드로.
+
+---
+
+## 4. CLI 갱신 절차
+
+### 4-1. 새 엔트리 추가 (가장 흔함)
+
+```bash
+# 1) 기존 본문 가져오기
+ch specs get <specId> --json | jq -r '.workStatus // ""' > /tmp/status.md
+
+# 2) /tmp/status.md를 열어 위쪽에 새 D-N 엔트리 append (최신이 위)
+# 또는 사용자 정책에 맞게 아래쪽 append
+
+# 3) 갱신
+ch specs update <specId> --work-status /tmp/status.md --no-version
+
+# 4) 검증
+ch specs get <specId> --json | jq -r '.workStatus' | head
+```
+
+### 4-2. 초기화 (잘못 들어간 경우)
+
+```bash
+echo "" > /tmp/empty.md
+ch specs update <specId> --work-status /tmp/empty.md --no-version
+```
+
+빈 문자열 저장 시 서버가 필드 자체를 제거하고, 웹 UI에는 "(클릭해서 작업 현황 작성)" placeholder로 표시된다.
+
+### 4-3. 여러 spec 일괄 갱신은 권장하지 않음
+
+workStatus는 spec마다 컨텍스트가 다르므로 한 줄짜리 일괄 갱신보다 spec별 수동 갱신을 권장.
+
+---
+
+## 5. 웹 UI 갱신 절차
+
+1. 해당 spec 상세 진입
+2. 하단 탭 → **작업 현황** 클릭
+3. 본문 영역 클릭 → 마크다운 textarea 열림
+4. 새 D-N 엔트리 추가 (CLI와 동일 포맷)
+5. **저장** 버튼 (또는 Esc 취소)
+
+웹 UI에서도 통째 교체이므로 기존 내용을 지운 채로 짧은 새 글만 쓰지 않도록 주의.
+
+---
+
+## 6. 다른 필드와의 분담
+
+| 필드 | 라이프사이클 | 작성자 |
+|---|---|---|
+| `tasks[]` | spec 작성 시 정의, 개발 중 토글 | 작성자(설계) + 개발자(체크박스/모달) |
+| `tasks[].description` | spec 작성 시 정의 | 작성자 |
+| `ui` / `logic` / `dbTableRefs` | spec 작성 시 정의 | 작성자 |
+| **`workStatus`** | **개발 진행 중 누적** | **개발자(자기 자신)** |
+| SQA 항목 | 개발 완료 시점 검증 | QA |
+| `status` | SQA 통과 후 변경 | 작성자/리더 |
+
+→ workStatus는 **개발자가 자기 자신을 위한 메모**로 시작해, sprint 회고/인수인계용 자산이 된다.
+
+---
+
+## 7. 흔한 함정
+
+- `--work-status` 통째 교체 — 기존 본문 보존 안 하면 데이터 손실.
+- workStatus에 SQA 결과를 복붙 → 추적 분산. SQA 결과는 SQA 항목에.
+- workStatus에 영구 규칙(domain rule) 적기 → 다음 사람이 못 찾음. `logic.businessRules`로.
+- spec 작성하면서 미리 workStatus를 채우려고 하지 말 것. 개발 시작 후부터 적는다.
+- 사용자 본인 외 다른 사람이 spec.workStatus를 함부로 덮어쓰지 말 것. 일지의 작성자는 1명이 원칙.

package/dist/commands/invitations.d.ts

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"invitations.d.ts","sourceRoot":"","sources":["../../src/commands/invitations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyCjE"}

package/dist/commands/invitations.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerInvitationsCommand = registerInvitationsCommand;
-const client_1 = require("../client");
-const output_1 = require("../output");
-function registerInvitationsCommand(program) {
-    const invitations = program
-        .command('invitations')
-        .description('초대 수락/조회');
-    // ch invitations info
-    invitations
-        .command('info')
-        .description('초대 토큰 정보 조회')
-        .requiredOption('--token <token>', '초대 토큰')
-        .action(async (options) => {
-        const globalOpts = program.opts();
-        try {
-            const client = (0, client_1.createUnauthClient)();
-            const { data } = await client.get(`/invitations/${options.token}`);
-            (0, output_1.formatOutput)(data, globalOpts);
-        }
-        catch (error) {
-            // Error already handled
-        }
-    });
-    // ch invitations accept
-    invitations
-        .command('accept')
-        .description('초대 수락')
-        .requiredOption('--token <token>', '초대 토큰')
-        .action(async (options) => {
-        const globalOpts = program.opts();
-        try {
-            if (globalOpts.dryRun) {
-                (0, output_1.printInfo)(`[DRY-RUN] 초대 수락 요청 (토큰: ${options.token.substring(0, 8)}...)`);
-                return;
-            }
-            const client = (0, client_1.createUnauthClient)();
-            const { data } = await client.post(`/invitations/${options.token}/accept`);
-            (0, output_1.formatOutput)(data, globalOpts);
-            (0, output_1.printSuccess)('초대가 수락되었습니다.');
-        }
-        catch (error) {
-            // Error already handled
-        }
-    });
-}
-//# sourceMappingURL=invitations.js.map

package/dist/commands/invitations.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invitations.js","sourceRoot":"","sources":["../../src/commands/invitations.ts"],"names":[],"mappings":";;AAIA,gEAyCC;AA5CD,sCAA+C;AAC/C,sCAAkE;AAElE,SAAgB,0BAA0B,CAAC,OAAgB;IACzD,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3B,sBAAsB;IACtB,WAAW;SACR,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,aAAa,CAAC;SAC1B,cAAc,CAAC,iBAAiB,EAAE,OAAO,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,2BAAkB,GAAE,CAAC;YACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACnE,IAAA,qBAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,wBAAwB;IACxB,WAAW;SACR,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,OAAO,CAAC;SACpB,cAAc,CAAC,iBAAiB,EAAE,OAAO,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,IAAA,kBAAS,EAAC,2BAA2B,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,IAAA,2BAAkB,GAAE,CAAC;YACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;YAC3E,IAAA,qBAAY,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC/B,IAAA,qBAAY,EAAC,cAAc,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}