@simplysm/sd-claude 13.0.85 → 13.0.87

package/claude/skills/sd-spec/sections/architecture.md

@@ -0,0 +1,104 @@
+# 아키텍처 관련 추가 섹션
+
+요구사항에 아키텍처/패키지 구조 변경이 포함된 경우, 기본 섹션에 아래 양식을 추가한다.
+
+## 패키지 의존성 다이어그램
+
+패키지 간 의존성을 Mermaid로 표현한다.
+
+**양식:**
+````markdown
+## 패키지 의존성
+
+```mermaid
+graph TD
+    A[{패키지A}] --> B[{패키지B}]
+    A --> C[{패키지C}]
+    B --> D[{공통 패키지}]
+    C --> D
+```
+
+**의존성 설명:**
+| 패키지 | 의존 대상 | 관계 설명 |
+|-------|----------|----------|
+| {패키지} | {의존 패키지} | {이유/용도} |
+````
+
+**예시:**
+````markdown
+## 패키지 의존성
+
+```mermaid
+graph TD
+    solid-demo[solid-demo<br/>client] --> solid[solid<br/>UI]
+    solid-demo --> service-client[service-client]
+    solid-demo-server[solid-demo-server<br/>server] --> service-server[service-server]
+    service-client --> service-common[service-common]
+    service-server --> service-common
+    service-server --> orm-node[orm-node]
+    orm-node --> orm-common[orm-common]
+    solid --> core-browser[core-browser]
+    core-browser --> core-common[core-common]
+    orm-common --> core-common
+    service-common --> core-common
+```
+
+**의존성 설명:**
+| 패키지 | 의존 대상 | 관계 설명 |
+|-------|----------|----------|
+| solid-demo | solid | SolidJS UI 컴포넌트 사용 |
+| solid-demo | service-client | API 클라이언트 사용 |
+| service-server | orm-node | DB 접근 |
+| orm-node | orm-common | ORM 공통 타입/인터페이스 |
+````
+
+## 모듈 구조
+
+신규 또는 변경되는 모듈의 내부 구조를 기술한다.
+
+**양식:**
+````markdown
+## 모듈 구조
+
+### {패키지명}
+
+```
+{패키지명}/src/
+  index.ts              — 공개 API (export)
+  {모듈}/
+    {파일}.ts           — {역할}
+```
+
+**공개 API:**
+| export | 타입 | 설명 |
+|--------|------|------|
+| {이름} | {class/function/type/...} | {설명} |
+````
+
+**예시:**
+````markdown
+## 모듈 구조
+
+### orm-common
+
+```
+orm-common/src/
+  index.ts              — 공개 API
+  decorators/
+    Column.ts           — @Column 데코레이터
+    Table.ts            — @Table 데코레이터
+  types/
+    ColumnType.ts       — 컬럼 타입 정의
+    QueryDef.ts         — 쿼리 정의 타입
+  utils/
+    QueryBuilder.ts     — 쿼리 빌더 유틸리티
+```
+
+**공개 API:**
+| export | 타입 | 설명 |
+|--------|------|------|
+| Column | decorator | 컬럼 매핑 데코레이터 |
+| Table | decorator | 테이블 매핑 데코레이터 |
+| IQueryBuilder | interface | 쿼리 빌더 인터페이스 |
+| ColumnType | type | 지원 컬럼 타입 열거 |
+````

package/claude/skills/sd-spec/sections/db.md

@@ -0,0 +1,99 @@
+# DB 관련 추가 섹션
+
+요구사항에 DB/테이블/스키마가 포함된 경우, 기본 섹션에 아래 양식을 추가한다.
+
+## 테이블 스키마
+
+테이블의 컬럼과 제약조건을 정의한다.
+
+**양식:**
+```markdown
+## 테이블 스키마
+
+### {테이블명}
+
+| 컬럼 | 타입 | NULL | 기본값 | 설명 |
+|------|------|------|-------|------|
+| {컬럼명} | {타입} | {Y/N} | {기본값} | {설명} |
+
+**인덱스:**
+- {인덱스명}: {컬럼 목록} ({UNIQUE/일반})
+
+**외래키:**
+- {컬럼} → {참조테이블}.{참조컬럼}
+```
+
+**예시:**
+```markdown
+## 테이블 스키마
+
+### users
+
+| 컬럼 | 타입 | NULL | 기본값 | 설명 |
+|------|------|------|-------|------|
+| id | INT | N | AUTO_INCREMENT | PK |
+| name | VARCHAR(100) | N | | 사용자 이름 |
+| email | VARCHAR(255) | N | | 이메일 주소 |
+| role | ENUM('admin','user','viewer') | N | 'user' | 역할 |
+| created_at | DATETIME | N | CURRENT_TIMESTAMP | 생성일시 |
+| deleted_at | DATETIME | Y | NULL | 삭제일시 (soft delete) |
+
+**인덱스:**
+- idx_users_email: email (UNIQUE)
+- idx_users_role: role (일반)
+
+**외래키:**
+- 없음
+```
+
+## ERD (Mermaid)
+
+테이블 간 관계를 Mermaid ERD로 표현한다.
+
+**양식:**
+````markdown
+## ERD
+
+```mermaid
+erDiagram
+    {테이블A} ||--o{ {테이블B} : "{관계 설명}"
+    {테이블A} {
+        type column_name "설명"
+    }
+```
+````
+
+**예시:**
+````markdown
+## ERD
+
+```mermaid
+erDiagram
+    users ||--o{ orders : "주문"
+    orders ||--|{ order_items : "주문 항목"
+    products ||--o{ order_items : "상품"
+
+    users {
+        int id PK
+        varchar name "사용자 이름"
+        varchar email "이메일"
+    }
+    orders {
+        int id PK
+        int user_id FK
+        datetime ordered_at "주문일시"
+        varchar status "주문 상태"
+    }
+    order_items {
+        int id PK
+        int order_id FK
+        int product_id FK
+        int quantity "수량"
+    }
+    products {
+        int id PK
+        varchar name "상품명"
+        decimal price "가격"
+    }
+```
+````

package/claude/skills/sd-spec/sections/process.md

@@ -0,0 +1,98 @@
+# 프로세스 관련 추가 섹션
+
+요구사항에 프로세스/흐름이 포함된 경우, 기본 섹션에 아래 양식을 추가한다.
+
+## 프로세스 플로우차트
+
+업무 프로세스나 기능 흐름을 Mermaid 플로우차트로 표현한다.
+
+**양식:**
+````markdown
+## 프로세스 흐름
+
+### {프로세스명}
+
+```mermaid
+flowchart TD
+    A[{시작}] --> B{조건}
+    B -->|{Yes}| C[{처리}]
+    B -->|{No}| D[{처리}]
+    C --> E[{종료}]
+    D --> E
+```
+
+**단계 설명:**
+| 단계 | 설명 | 담당 |
+|------|------|------|
+| {단계명} | {상세 설명} | {시스템/사용자} |
+````
+
+**예시:**
+````markdown
+## 프로세스 흐름
+
+### 주문 처리
+
+```mermaid
+flowchart TD
+    A[주문 접수] --> B{재고 확인}
+    B -->|재고 있음| C[결제 처리]
+    B -->|재고 없음| D[품절 안내]
+    C --> E{결제 성공?}
+    E -->|성공| F[배송 준비]
+    E -->|실패| G[결제 실패 안내]
+    F --> H[배송 시작]
+    H --> I[배송 완료]
+```
+
+**단계 설명:**
+| 단계 | 설명 | 담당 |
+|------|------|------|
+| 주문 접수 | 사용자가 장바구니에서 주문 확정 | 사용자 |
+| 재고 확인 | 주문 상품의 재고 수량 확인 | 시스템 |
+| 결제 처리 | PG사 연동 결제 수행 | 시스템 |
+| 배송 준비 | 포장 및 송장 생성 | 시스템 |
+````
+
+## 시퀀스 다이어그램
+
+시스템 간 또는 컴포넌트 간 상호작용을 Mermaid 시퀀스 다이어그램으로 표현한다.
+
+**양식:**
+````markdown
+## 시퀀스 다이어그램
+
+### {상호작용명}
+
+```mermaid
+sequenceDiagram
+    participant {Actor1}
+    participant {Actor2}
+    {Actor1}->>+{Actor2}: {요청}
+    {Actor2}-->>-{Actor1}: {응답}
+```
+````
+
+**예시:**
+````markdown
+## 시퀀스 다이어그램
+
+### 사용자 로그인
+
+```mermaid
+sequenceDiagram
+    participant Browser
+    participant Server
+    participant DB
+
+    Browser->>+Server: POST /api/auth/login (email, password)
+    Server->>+DB: SELECT user WHERE email = ?
+    DB-->>-Server: user record
+    Server->>Server: bcrypt.compare(password, hash)
+    alt 인증 성공
+        Server-->>Browser: 200 { token }
+    else 인증 실패
+        Server-->>-Browser: 401 { error }
+    end
+```
+````

package/claude/skills/sd-spec/sections/ui.md

@@ -0,0 +1,146 @@
+# UI 관련 추가 섹션
+
+요구사항에 UI/화면이 포함된 경우, 기본 섹션에 아래 양식을 추가한다.
+
+## 화면 레이아웃
+
+화면의 전체 구조를 기술한다. 필요시 ASCII 레이아웃을 포함한다.
+
+**양식:**
+```markdown
+## 화면 레이아웃
+
+### {화면명}
+
+**구성:**
+- 상단: {설명}
+- 좌측: {설명}
+- 메인: {설명}
+- 하단: {설명}
+
+**와이어프레임:**
+(ASCII 또는 텍스트 기반 레이아웃)
+```
+
+**예시:**
+```markdown
+## 화면 레이아웃
+
+### 관리자 대시보드
+
+**구성:**
+- 상단: 네비게이션 바 (로고, 메뉴, 사용자 정보)
+- 좌측: 사이드 메뉴 (대시보드, 사용자 관리, 설정)
+- 메인: 통계 카드 영역 + 최근 활동 테이블
+- 하단: 없음
+
+**와이어프레임:**
+┌─────────────────────────────────┐
+│ Logo   [대시보드] [사용자] [설정] │
+├────────┬────────────────────────┤
+│ 메뉴   │ [통계1] [통계2] [통계3] │
+│        │                        │
+│ 대시보드│ 최근 활동              │
+│ 사용자  │ ┌──┬──────┬─────┬──┐  │
+│ 설정   │ │# │ 제목  │ 상태 │..│  │
+│        │ └──┴──────┴─────┴──┘  │
+└────────┴────────────────────────┘
+```
+
+## 시트/테이블 컬럼 정의
+
+데이터를 표시하는 시트나 테이블의 컬럼을 정의한다.
+
+**양식:**
+```markdown
+## 시트 컬럼 정의
+
+### {시트/테이블명}
+
+| 컬럼명 | 타입 | 필수 | 정렬 | 설명 |
+|-------|------|------|------|------|
+| {컬럼} | {text/number/date/select/...} | {Y/N} | {Y/N} | {설명} |
+```
+
+**예시:**
+```markdown
+## 시트 컬럼 정의
+
+### 사용자 목록
+
+| 컬럼명 | 타입 | 필수 | 정렬 | 설명 |
+|-------|------|------|------|------|
+| 이름 | text | Y | Y | 사용자 표시 이름 |
+| 이메일 | text | Y | Y | 로그인 이메일 |
+| 역할 | select | Y | Y | admin / user / viewer |
+| 가입일 | date | Y | Y | 계정 생성일 |
+| 상태 | select | Y | N | active / inactive / suspended |
+| 최근 접속 | date | N | Y | 마지막 로그인 시간 |
+```
+
+## 필터 폼 정의
+
+시트/테이블의 필터 폼을 별도로 정의한다.
+
+**양식:**
+```markdown
+## 필터 폼
+
+### {시트/테이블명} 필터
+
+| 필터명 | 입력 타입 | 설명 |
+|-------|----------|------|
+| {필터} | {text/select/date-range/...} | {설명} |
+```
+
+**예시:**
+```markdown
+## 필터 폼
+
+### 사용자 목록 필터
+
+| 필터명 | 입력 타입 | 설명 |
+|-------|----------|------|
+| 이름/이메일 | text | 이름 또는 이메일로 검색 |
+| 역할 | select (다중) | admin / user / viewer |
+| 상태 | select (다중) | active / inactive / suspended |
+| 가입일 | date-range | 시작일 ~ 종료일 |
+```
+
+## 데이터 편집 폼 정의
+
+데이터 생성/수정을 위한 편집 폼을 정의한다.
+
+**양식:**
+```markdown
+## 편집 폼
+
+### {폼명}
+
+| 필드명 | 입력 타입 | 필수 | 기본값 | 설명 |
+|-------|----------|------|-------|------|
+| {필드} | {text/number/select/date/textarea/...} | {Y/N} | {기본값} | {설명} |
+
+**검증 규칙:**
+- {필드}: {규칙}
+```
+
+**예시:**
+```markdown
+## 편집 폼
+
+### 사용자 등록/수정
+
+| 필드명 | 입력 타입 | 필수 | 기본값 | 설명 |
+|-------|----------|------|-------|------|
+| 이름 | text | Y | | 사용자 표시 이름 |
+| 이메일 | text | Y | | 로그인용 이메일 주소 |
+| 비밀번호 | password | Y (등록 시) | | 8자 이상, 영문+숫자 |
+| 역할 | select | Y | user | admin / user / viewer |
+| 메모 | textarea | N | | 관리자 메모 |
+
+**검증 규칙:**
+- 이메일: 이메일 형식, 중복 불가
+- 비밀번호: 최소 8자, 영문+숫자 포함
+- 이름: 최대 100자
+```

package/claude/skills/sd-test/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: sd-test
+description: 테스트 대상에 대해 작업 유형별 TDD 테스트를 독립 수행. 사용자가 특정 모듈/기능의 테스트 작성이나 실행을 요청할 때 사용
+argument-hint: "<테스트 대상 파일 경로> [추가 컨텍스트]"
+---
+
+# sd-test: 독립 TDD 테스트
+
+sd-plan의 테스트 전략 결정과 sd-plan-dev의 TDD 사이클 실행을 통합하여, plan 없이도 테스트를 독립 수행한다.
+
+## 1. 인자 파싱
+
+`$ARGUMENTS`를 분석하여 테스트 대상을 결정한다.
+
+### 1-1. 파일 경로 + 선택적 추가 컨텍스트
+
+`$ARGUMENTS`에서 파일 경로와 추가 컨텍스트를 분리한다:
+- 첫 번째 토큰이 존재하는 파일 경로이면 테스트 대상으로 사용
+- 나머지 텍스트가 있으면 추가 컨텍스트(특정 동작 검증 포인트)로 사용
+- 파일이 존재하지 않으면 AskUserQuestion으로 올바른 경로를 요청한다
+- 예: `src/utils.ts 특정함수 동작확인` → 대상: `src/utils.ts`, 컨텍스트: `특정함수 동작확인`
+- 예: `.claude/skills/sd-spec/SKILL.md` → 대상: 해당 파일, 컨텍스트: 없음
+
+### 1-2. 인자 없음
+
+`$ARGUMENTS`가 비어있으면:
+- 현재 대화 맥락에서 테스트 대상을 파악한다
+- 대화에도 대상이 없으면 AskUserQuestion으로 테스트 대상 파일 경로를 요청한다
+
+## 2. 코드베이스 분석
+
+테스트 대상 파일과 관련된 코드베이스를 분석한다. 다음을 병렬로 수행한다:
+- 대상 파일을 Read한다
+- 프로젝트 테스트 환경(vitest) 존재 여부를 확인한다 (`vitest.config.*`, `package.json`의 devDependencies 등)
+
+테스트 작성에 필요한 경우에만 대상 파일의 직접 의존성(import/require)을 추가로 확인한다.
+
+## 3. 작업 유형 분류
+
+대상 파일의 성격에 따라 테스트 전략을 결정한다.
+
+| 작업 유형 | 테스트 전략 |
+|----------|-----------|
+| 코드 작업 (로직) | 프로젝트 테스트 환경(vitest) 확인 → 있으면 vitest 테스트 작성 및 실행 |
+| 코드 작업 (로직, 테스트 환경 없음) | subagent 기반 `test.md` 작성 및 실행 |
+| 코드 작업 (비로직, 텍스트/상수/설정 변경 등) | 테스트 생략 → 완료 안내 |
+| 비코드 작업 (LLM용 문서, SKILL.md 등) | subagent 기반 `test.md` 작성 및 실행 |
+| 비코드 작업 (일반 문서, README 등) | 테스트 생략 → 완료 안내 |
+
+테스트 생략인 경우 "테스트가 필요하지 않은 작업 유형입니다."를 출력하고 종료한다.
+
+## 4. 테스트 시나리오 작성 원칙
+
+테스트는 **상태(정적)가 아닌 동작**을 검증한다:
+- 상태 (X): "파일에 특정 텍스트가 적혀있는지 확인" → 정적 검사에 불과
+- 동작 (O): "실행했을 때 기대한 동작이 나타나는지 확인" → 실제 동작 검증
+
+예:
+- LLM용 문서: "SKILL.md에 '테스트 재실행' 문구가 있는지"(X) → "LLM이 SKILL.md를 따라 실행했을 때 실제로 테스트를 재실행하는지"(O)
+- 코드: "함수가 존재하는지"(X) → "함수에 특정 입력을 넣으면 기대 출력이 나오는지"(O)
+
+## 5. RED Phase: 테스트 시나리오 작성 및 실행
+
+4단계의 원칙에 따라 테스트 시나리오를 작성하고 실행한다.
+
+### vitest 테스트인 경우
+
+1. 대상 파일과 추가 컨텍스트를 분석하여 테스트 시나리오를 작성한다
+2. vitest 테스트 파일을 작성한다
+   - 프로젝트의 기존 테스트 파일 패턴을 탐색하여 (`*.test.ts`, `*.spec.ts`, `__tests__/` 등) 동일한 패턴으로 생성한다
+   - 기존 패턴이 없으면 `{대상파일명}.test.{확장자}`로 대상 파일과 동일 디렉토리에 생성한다
+3. Bash로 `vitest run {테스트 파일}` 실행하여 현재 상태를 확인한다
+
+### subagent 테스트인 경우 (LLM용 문서, 테스트 환경 없는 코드 등)
+
+1. 대상 파일과 추가 컨텍스트를 분석하여 테스트 시나리오를 작성한다
+2. `test.md` 파일을 작성한다
+   - 저장 위치: `.tasks/{yyMMddHHmmss}_{topic}/test.md` (Bash `date +%y%m%d%H%M%S`, topic은 대상 파일명 기반 kebab-case)
+   - 형식:
+     ```markdown
+     ## 테스트 1: {테스트 제목}
+     **입력:** {subagent에게 실행시킬 지시}
+     **기대 결과:** {검증 기준}
+     ```
+3. Agent tool로 subagent를 생성하여 테스트를 실행한다
+   - subagent에게 전달할 내용: 대상 파일 경로, test.md 경로, "test.md의 각 테스트를 실행하고 PASS/FAIL을 판정하라"는 지시
+
+**이미 모든 테스트가 통과하면 (vitest/subagent 공통):**
+- "모든 테스트가 이미 통과합니다. 수정이 필요하지 않습니다."를 출력하고 종료한다
+
+## 6. GREEN Phase: 대상 수정 및 재테스트
+
+테스트 실패 항목에 대해 대상 파일을 수정한다.
+- 수정 후 테스트를 재실행한다
+  - vitest: Bash로 `vitest run {테스트 파일}` 재실행
+  - subagent: Agent tool로 subagent 재실행
+- 여전히 실패하면 다시 수정 → 재테스트를 반복한다
+- 최대 3회 반복한다. 3회 시도 후에도 실패하면 실패 원인을 분석하여 사용자에게 보고하고 중단한다
+
+## 7. Refactor Phase
+
+GREEN Phase에서 대상 파일을 수정한 경우에만 수행한다.
+
+`/simplify 다음 파일만 리뷰: {수정한 파일 목록}` 하여 품질을 개선한다.
+- 완료 후 테스트를 재실행하여 통과를 확인한다
+- 리팩터링으로 테스트가 깨지면 수정 후 재확인한다
+
+## 8. 완료 안내
+
+TDD 사이클이 완료되면 다음을 출력한다:
+- 테스트 결과 요약 (통과/수정됨)
+- 수정된 파일 목록
+
+## 9. 커밋
+
+수정된 파일이 있으면 `/sd-commit`을 실행하여 자동 커밋한다.