@choblue/claude-code-toolkit 1.1.4 → 1.1.6

package/.claude/.project-map-cache

@@ -1 +1 @@
-03a6f698d5246e33e211ef5f209fc9471c01cf50
+d077ab9cf015379b7523bdb1d5f301e8492bd08a

package/.claude/CLAUDE.md

@@ -89,6 +89,7 @@ Main Agent의 Context Window는 제한적이다. 반드시 서브에이전트에
   - `SKILL.md` - 공통 TDD 원칙
   - `frontend.md` - React 테스트 규칙
   - `backend.md` - NestJS 테스트 규칙
+- `.claude/skills/DDD/SKILL.md` - DDD 전술적 패턴 (Entity, VO, Aggregate, Repository, Domain Event)
 - `.claude/skills/Git/SKILL.md` - Git 커밋/PR/브랜치 규칙
 
 ### Scripts

package/.claude/PROJECT_MAP.md

@@ -7,9 +7,9 @@
 
 - **이름**: @choblue/claude-code-toolkit
 - **브랜치**: main
-- **최근 커밋**: 03a6f69 DOCS: skill-detector hook 문서 반영 및 CHANGELOG 추가
-- **생성 시간**: 2026-02-25 15:12:39
-- **총 파일 수**: 41
+- **최근 커밋**: 1a377b9 FEAT: DDD 전술적 패턴 스킬 추가
+- **생성 시간**: 2026-02-26 14:09:28
+- **총 파일 수**: 44
 
 ## 디렉토리 구조
 
@@ -21,6 +21,7 @@
 ./.claude/scripts
 ./.claude/skills
 ./.claude/skills/Coding
+./.claude/skills/DDD
 ./.claude/skills/Git
 ./.claude/skills/NextJS
 ./.claude/skills/React

package/.claude/hooks/skill-keywords.conf

@@ -16,4 +16,5 @@ TypeScript|TypeScript|typescript 타입스크립트 타입 type interface generi
 TypeORM|TypeORM|typeorm 타입오알엠 entity repository querybuilder migration 마이그레이션 relation 트랜잭션 transaction
 Coding|Coding|리팩토링 refactor 클린코드 clean code 네이밍 naming 에러처리 error handling 코드품질
 TDD|TDD|tdd 테스트 test jest vitest 단위테스트 unit test e2e 통합테스트 integration test mock stub spy
-Git|Git|git 커밋 commit 브랜치 branch pr pull request merge rebase
+Git|Git|git 커밋 commit 브랜치 branch pr pull request merge rebase
+DDD|DDD|ddd domain entity value object aggregate repository domain service domain event bounded context 도메인 엔티티 값객체 애그리거트 리포지토리 도메인서비스 도메인이벤트

package/.claude/skills/Coding/SKILL.md

@@ -26,10 +26,108 @@ FE/BE별 상세 규칙은 각각의 파일을 참고한다.
 - **높은 응집도**: 관련 있는 로직을 같은 모듈에 모은다
   - 하나의 모듈 안에서 데이터와 동작이 밀접하게 관련된다
 
+### Early Return (Guard Clause)
+- 예외/실패 조건을 함수 상단에서 먼저 처리하고 빠져나온다
+- 중첩 if를 줄여 가독성을 높인다
+
+```typescript
+// Bad - 깊은 중첩
+function processOrder(order: Order): void {
+  if (order) {
+    if (order.isValid()) {
+      if (order.items.length > 0) {
+        // 실제 로직
+      }
+    }
+  }
+}
+
+// Good - 얼리 리턴
+function processOrder(order: Order): void {
+  if (!order) return;
+  if (!order.isValid()) return;
+  if (order.items.length === 0) return;
+
+  // 실제 로직
+}
+```
+
 ### DRY (Don't Repeat Yourself)
 - 동일한 로직이 3번 이상 반복되면 추출한다
 - 단, 2번까지는 중복을 허용한다 (섣부른 추상화 방지)
 
+### 선언적 & 함수형 스타일
+
+**선언적 > 명령적** - "어떻게(how)" 대신 "무엇(what)"을 표현한다.
+
+```typescript
+// Bad - 명령적: 루프로 직접 조작
+const activeNames: string[] = [];
+for (const user of users) {
+  if (user.isActive) {
+    activeNames.push(user.name);
+  }
+}
+
+// Good - 선언적: 의도를 바로 드러냄
+// 필터/변환 조건은 변수로 추출하여 합성하라
+const isActive = (u: User) => u.isActive;
+const toName = (u: User) => u.name;
+const activeNames = users.filter(isActive).map(toName);
+```
+
+**순수 함수 우선** - 같은 입력이면 항상 같은 출력, 부수효과 없음.
+
+```typescript
+// Bad - 외부 상태를 변경
+let totalPrice = 0;
+function addItemPrice(price: number): void {
+  totalPrice += price; // 외부 변수 변경
+}
+
+// Good - 새 값을 반환하는 순수 함수
+function calculateTotal(prices: number[]): number {
+  return prices.reduce((sum, price) => sum + price, 0);
+}
+```
+
+**불변성** - 기존 데이터를 변경하지 않고 새 데이터를 생성한다.
+
+```typescript
+// Bad - 원본 변경
+user.role = 'admin';
+items.push(newItem);
+
+// Good - 새 객체/배열 생성
+const promotedUser = { ...user, role: 'admin' };
+const updatedItems = [...items, newItem];
+```
+
+**부수효과 격리** - 순수 로직과 부수효과(I/O)를 분리한다.
+
+```typescript
+// Bad - 비즈니스 로직에 부수효과가 섞임
+async function processOrder(order: Order): Promise<void> {
+  const total = order.items.reduce((s, i) => s + i.price, 0);
+  const discount = total > 100 ? total * 0.1 : 0;
+  await db.save({ ...order, total: total - discount }); // 부수효과
+  await sendEmail(order.userId, total - discount);       // 부수효과
+}
+
+// Good - 순수 계산과 부수효과를 분리
+function calcOrderTotal(items: OrderItem[]): number {
+  const total = items.reduce((s, i) => s + i.price, 0);
+  const discount = total > 100 ? total * 0.1 : 0;
+  return total - discount;
+}
+
+async function processOrder(order: Order): Promise<void> {
+  const finalTotal = calcOrderTotal(order.items); // 순수
+  await db.save({ ...order, total: finalTotal }); // I/O 경계
+  await sendEmail(order.userId, finalTotal);       // I/O 경계
+}
+```
+
 ---
 
 ## 2. 네이밍 컨벤션