@wooojin/forgen 0.1.0

package/commands/debug-detective.md

@@ -0,0 +1,99 @@
+---
+name: debug-detective
+description: This skill should be used when the user asks to "debug-detective,디버그탐정,체계적디버깅". Systematic debugging with reproduce-isolate-fix-verify loop
+triggers:
+  - "debug-detective"
+  - "디버그탐정"
+  - "체계적디버깅"
+---
+
+<Purpose>
+재현→격리→수정→검증의 4단계 루프를 통해 버그를 체계적으로 추적합니다.
+에러 분류, git bisect, 최소 재현 사례 구성으로 근본 원인을 신속히 파악합니다.
+</Purpose>
+
+<Steps>
+1. **재현 (Reproduce)**
+   - 버그 재현 조건을 최대한 구체적으로 문서화
+     ```
+     환경: Node 20.x, macOS 14.3
+     입력값: { userId: null, action: "delete" }
+     예상 동작: 422 Validation Error
+     실제 동작: 500 Internal Server Error
+     재현율: 100% / 간헐적 (~30%)
+     ```
+   - 간헐적 버그: 로그 레벨 높이고 반복 실행으로 패턴 포착
+   - 환경 차이 확인: 로컬 vs CI vs 프로덕션
+
+2. **격리 (Isolate)**
+   - **에러 분류**:
+     - **런타임 에러**: TypeError, ReferenceError → 스택 트레이스 추적
+     - **타입 에러**: TS 컴파일 에러 → 타입 정의 불일치 확인
+     - **논리 에러**: 잘못된 계산/조건 → 중간값 로깅
+     - **비동기 에러**: Promise rejection, race condition → async/await 추적
+   - **Bisect 전략**:
+     ```bash
+     # git bisect로 버그 도입 커밋 이진 탐색
+     git bisect start
+     git bisect bad                    # 현재 커밋은 버그 있음
+     git bisect good <마지막_정상_sha>  # 정상 커밋 지정
+     # Git이 자동으로 중간 커밋 체크아웃
+     # 테스트 후 good/bad 판정 반복
+     git bisect run npm test           # 자동화 가능
+     git bisect reset                  # 완료 후 원상복구
+     ```
+   - **최소 재현 사례 구성**: 관련 없는 코드를 제거해 가장 단순한 형태로 축소
+
+3. **로그 분석 패턴**
+   ```typescript
+   // 구조화 로그로 맥락 추가
+   logger.error('결제 처리 실패', {
+     userId, orderId, amount,
+     stack: err.stack,
+     timestamp: new Date().toISOString(),
+   });
+
+   // 조건부 디버그 로그 (프로덕션 영향 최소화)
+   if (process.env.DEBUG_PAYMENT) {
+     console.log('[DEBUG]', JSON.stringify({ state, payload }, null, 2));
+   }
+   ```
+   - 타임스탬프 정렬 → 이벤트 순서 파악
+   - 상관관계 ID(correlation ID)로 분산 로그 추적
+
+4. **수정 (Fix)**
+   - 근본 원인(root cause)을 먼저 명시
+   - 증상만 치료하는 패치 금지 → 원인 제거
+   - 수정 범위를 최소화 (side effect 방지)
+   - 수정 전후 코드 diff를 커밋 메시지에 설명
+
+5. **검증 (Verify)**
+   - 버그 재현 시나리오를 회귀 테스트로 추가
+   - 원래 문제가 해결됐는지 확인
+   - 관련 기능에 새 버그가 생기지 않았는지 확인
+   - 스테이징 → 프로덕션 순서로 검증
+</Steps>
+
+<Policy>
+- 추측 기반 수정 금지 — 반드시 재현 먼저
+- 로그 추가 시 민감 정보(비밀번호, 토큰) 절대 출력 금지
+- 수정 후 해당 버그의 회귀 테스트 1개 이상 추가
+- 간헐적 버그는 최소 10회 연속 통과 후 수정 완료 판정
+</Policy>
+
+<Arguments>
+## 사용법
+`/forgen:debug-detective {버그 설명}`
+
+### 예시
+- `/forgen:debug-detective 로그인 후 가끔 401 에러가 발생함 (재현율 20%)`
+- `/forgen:debug-detective 최근 배포 후 결제 API 응답 시간이 3배 증가`
+- `/forgen:debug-detective TypeScript 컴파일은 되는데 런타임에서 undefined 에러`
+
+### 인자
+- 버그 증상과 재현 조건
+- 발생 환경 (로컬/스테이징/프로덕션)
+- 관련 에러 메시지나 스택 트레이스
+</Arguments>
+
+$ARGUMENTS

package/commands/docker.md

@@ -0,0 +1,274 @@
+---
+name: docker
+description: This skill should be used when the user asks to "docker,container,컨테이너,dockerfile,도커,docker-compose". Containerization with Docker, Dockerfile optimization, and compose configuration
+triggers:
+  - "docker"
+  - "container"
+  - "컨테이너"
+  - "dockerfile"
+  - "도커"
+  - "docker-compose"
+---
+<!-- forgen-managed -->
+
+<Purpose>
+Docker를 활용한 컨테이너화를 체계적으로 수행합니다.
+의존성 분석, Dockerfile 작성, 레이어 최적화,
+Docker Compose 구성, 헬스 체크까지 컨테이너 라이프사이클 전체를 다룹니다.
+</Purpose>
+
+<Steps>
+1. **의존성 분석**: 애플리케이션의 런타임 요구사항을 파악합니다
+   - 런타임 환경 (Node.js, Python, Go 등)
+   - 시스템 의존성 (네이티브 바이너리, 라이브러리)
+   - 환경 변수 목록 및 기본값
+   - 포트 매핑 (애플리케이션 포트, 디버그 포트)
+   - 볼륨 마운트 필요 사항 (데이터 영속성, 설정 파일)
+   - 외부 서비스 의존성 (DB, Redis, 메시지 큐)
+
+2. **Dockerfile 작성**: 최적화된 Dockerfile을 구성합니다
+   - 베이스 이미지 선택 (alpine vs slim vs distroless)
+   - 멀티스테이지 빌드 적용 (빌드 스테이지 / 런타임 스테이지)
+   - 레이어 캐싱 최적화 (변경 빈도 낮은 것부터 순서)
+     * 시스템 의존성 설치
+     * package.json / lockfile 복사 + npm install
+     * 소스 코드 복사 + 빌드
+   - .dockerignore 설정 (node_modules, .git, 테스트 파일)
+   - 비루트 사용자 설정 (보안)
+   - 시그널 핸들링 (SIGTERM graceful shutdown)
+   - HEALTHCHECK 명령 설정
+
+3. **이미지 최적화**: 이미지 크기와 보안을 개선합니다
+   - 레이어 수 최소화 (RUN 명령 결합)
+   - 불필요한 파일 제거 (빌드 도구, 캐시, 문서)
+   - 프로덕션 의존성만 설치 (--omit=dev)
+   - 이미지 크기 측정 및 목표 설정
+   - 보안 스캔 (Trivy, Docker Scout)
+   - 이미지 태깅 전략 (semver, git SHA, latest)
+
+4. **Docker Compose 구성**: 멀티 컨테이너 환경을 정의합니다
+   - 서비스 정의 (app, db, cache, proxy)
+   - 네트워크 구성 (서비스 간 통신)
+   - 볼륨 정의 (데이터 영속성)
+   - 환경 변수 관리 (.env 파일, 인라인)
+   - 의존성 순서 (depends_on + healthcheck)
+   - 개발/프로덕션 오버라이드 분리
+   - 리소스 제한 설정 (CPU, 메모리)
+
+5. **헬스 체크 및 모니터링**: 컨테이너 상태를 관리합니다
+   - HEALTHCHECK 엔드포인트 구현 (/health, /ready)
+   - Liveness probe vs Readiness probe 구분
+   - 로그 수집 구성 (stdout/stderr → 로그 시스템)
+   - 메트릭 노출 (Prometheus 엔드포인트)
+   - Graceful shutdown 구현 (SIGTERM 처리)
+   - 재시작 정책 설정 (restart: unless-stopped)
+</Steps>
+
+## 에이전트 위임
+
+`executor` 에이전트(Sonnet 모델)에 위임하여 Docker 구성을 구현합니다:
+
+```
+Agent(
+  subagent_type="executor",
+  model="sonnet",
+  prompt="DOCKER TASK
+
+Docker 컨테이너화를 구현하세요.
+
+Application: [애플리케이션 설명]
+Runtime: [Node.js / Python / Go / etc.]
+Services: [필요한 외부 서비스 목록]
+
+Docker Checklist:
+1. Dockerfile 작성 (멀티스테이지, 최적화)
+2. .dockerignore 설정
+3. Docker Compose 구성 (개발/프로덕션)
+4. 헬스 체크 설정
+5. 보안 설정 (비루트 사용자, 이미지 스캔)
+6. 볼륨 및 네트워크 구성
+
+Output: Docker 구성 파일 및 문서:
+- Dockerfile
+- .dockerignore
+- docker-compose.yml (dev/prod)
+- 이미지 크기 리포트
+- 실행 명령 가이드"
+)
+```
+
+## External Consultation (Optional)
+
+executor 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 Docker 구성을 먼저 완료** -- 독립적으로 구현
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 구성 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 복잡한 멀티스테이지 빌드
+- 프로덕션 수준의 보안 강화
+- 오케스트레이션 (Kubernetes 연동)
+- 네이티브 의존성이 있는 이미지 최적화
+
+### 자문을 생략하는 경우
+- 단순 Node.js/Python 컨테이너화
+- 개발 환경용 Docker Compose
+- 잘 알려진 이미지 패턴
+- 기존 Dockerfile의 경미한 수정
+
+## Docker 체크리스트
+
+### Dockerfile (6개)
+- [ ] 멀티스테이지 빌드 적용
+- [ ] 베이스 이미지에 고정 태그 사용 (latest 금지)
+- [ ] 비루트 사용자로 실행
+- [ ] .dockerignore가 적절히 설정됨
+- [ ] 레이어 캐싱이 최적화됨
+- [ ] HEALTHCHECK가 설정됨
+
+### 보안 (4개)
+- [ ] 이미지 취약점 스캔 완료
+- [ ] 최소 권한 원칙 적용 (비루트, 읽기 전용 파일시스템)
+- [ ] 시크릿이 이미지에 포함되지 않음
+- [ ] 불필요한 도구/패키지가 제거됨
+
+### 운영 (4개)
+- [ ] Graceful shutdown이 구현됨 (SIGTERM)
+- [ ] 로그가 stdout/stderr로 출력됨
+- [ ] 리소스 제한이 설정됨
+- [ ] 재시작 정책이 설정됨
+
+### Compose (4개)
+- [ ] 서비스 간 의존성이 healthcheck 기반으로 설정됨
+- [ ] 개발/프로덕션 오버라이드가 분리됨
+- [ ] 볼륨이 데이터 영속성에 적절히 사용됨
+- [ ] 네트워크가 서비스별로 격리됨
+
+## 이미지 크기 기준
+
+| 런타임 | 목표 크기 | 베이스 이미지 |
+|--------|-----------|--------------|
+| Node.js | < 150MB | node:20-alpine |
+| Python | < 200MB | python:3.12-slim |
+| Go | < 30MB | gcr.io/distroless/static |
+| Rust | < 30MB | debian:bookworm-slim (빌드) + scratch (런타임) |
+
+<Output>
+```
+DOCKER CONFIGURATION / Docker 구성 문서
+=========================================
+
+Application: [애플리케이션명]
+Runtime: [Node.js 20]
+Image Size: [최종 이미지 크기]
+
+DOCKERFILE / Dockerfile
+-------------------------
+# Build stage
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev
+COPY . .
+RUN npm run build
+
+# Runtime stage
+FROM node:20-alpine AS runtime
+RUN addgroup -g 1001 -S appgroup && \
+    adduser -S appuser -u 1001 -G appgroup
+WORKDIR /app
+COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
+COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
+USER appuser
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=3s \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+CMD ["node", "dist/index.js"]
+
+DOCKER COMPOSE / docker-compose.yml
+--------------------------------------
+services:
+  app:
+    build: .
+    ports: ["3000:3000"]
+    depends_on:
+      db: { condition: service_healthy }
+    environment:
+      DATABASE_URL: postgres://user:pass@db:5432/app
+  db:
+    image: postgres:16-alpine
+    volumes: ["pgdata:/var/lib/postgresql/data"]
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready"]
+
+IMAGE ANALYSIS / 이미지 분석
+------------------------------
+Total Size: 142MB
+Layers: 8
+Base Image: node:20-alpine (45MB)
+Dependencies: 85MB
+Application: 12MB
+
+SECURITY SCAN / 보안 스캔
+---------------------------
+Vulnerabilities: 0 CRITICAL, 0 HIGH, 2 MEDIUM
+Recommendation: [조치 사항]
+```
+</Output>
+
+<Policy>
+- 베이스 이미지에 항상 고정 태그를 사용합니다 (latest 금지)
+- 프로덕션 이미지에서 반드시 비루트 사용자로 실행합니다
+- 시크릿은 절대 이미지에 포함하지 않습니다 (빌드 시에도)
+- 이미지 크기를 정기적으로 모니터링합니다
+- 보안 스캔을 CI/CD에 통합하여 취약한 이미지 배포를 차단합니다
+- Graceful shutdown을 반드시 구현하여 데이터 손실을 방지합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**CI/CD 연동:**
+```
+/forgen:ci-cd Docker 이미지 빌드 및 푸시 파이프라인
+```
+CI에서 Docker 이미지 자동 빌드/배포
+
+**보안 리뷰 연동:**
+```
+/forgen:security-review Dockerfile 및 이미지
+```
+Docker 구성의 보안 취약점 점검
+
+**성능 연동:**
+```
+/forgen:performance 컨테이너 리소스 사용량 분석
+```
+컨테이너의 리소스 최적화
+
+## Best Practices
+
+- **작은 이미지** -- 불필요한 것을 빼서 크기를 줄임
+- **멀티스테이지** -- 빌드 도구를 런타임에 포함하지 않음
+- **캐시 활용** -- 레이어 순서를 변경 빈도 기준으로 정렬
+- **보안 우선** -- 비루트, 최소 권한, 시크릿 분리
+- **헬스 체크** -- 컨테이너 상태를 자동으로 모니터링
+
+<Arguments>
+## 사용법
+`/forgen:docker {컨테이너화 대상}`
+
+### 예시
+- `/forgen:docker Node.js API 서버 컨테이너화`
+- `/forgen:docker 기존 Dockerfile 최적화`
+- `/forgen:docker 개발 환경 Docker Compose 구성`
+- `/forgen:docker 프로덕션 배포용 이미지 보안 강화`
+
+### 인자
+- 컨테이너화할 애플리케이션, 최적화 목표 등을 설명
+- 인자 없으면 프로젝트를 분석하여 적절한 Docker 구성을 제안
+</Arguments>
+
+$ARGUMENTS

package/commands/documentation.md

@@ -0,0 +1,276 @@
+---
+name: documentation
+description: This skill should be used when the user asks to "documentation,문서화,docs,기술 문서,readme,API docs". Technical documentation writing with audience analysis and structured content
+triggers:
+  - "documentation"
+  - "문서화"
+  - "docs"
+  - "기술 문서"
+  - "readme"
+  - "API docs"
+---
+<!-- forgen-managed -->
+
+<Purpose>
+기술 문서를 체계적으로 작성합니다.
+대상 독자 분석, 정보 구조 설계, 초안 작성, 리뷰, 배포까지
+기술 문서의 전체 라이프사이클을 다룹니다.
+</Purpose>
+
+<Steps>
+1. **대상 독자 분석**: 문서를 읽을 사람을 파악합니다
+   - 독자의 기술 수준 (초급/중급/고급)
+   - 독자의 역할 (개발자, DevOps, PM, 최종 사용자)
+   - 독자가 달성하려는 목표 (설치, 통합, 트러블슈팅)
+   - 사전 지식 가정 (프로그래밍 언어, 프레임워크, 도메인)
+   - 문서 접근 맥락 (처음 사용 vs 참조 vs 문제 해결)
+
+2. **정보 구조 설계**: 문서의 뼈대를 구성합니다
+   - 문서 유형 결정:
+     * Tutorial (학습 지향) -- "이렇게 해보세요"
+     * How-to Guide (목표 지향) -- "이렇게 하면 됩니다"
+     * Reference (정보 지향) -- "이것은 이렇습니다"
+     * Explanation (이해 지향) -- "이것이 왜 이렇게 동작합니다"
+   - 목차(TOC) 초안 작성
+   - 섹션별 깊이와 범위 결정
+   - 네비게이션 구조 (선형 vs 비선형)
+   - 연관 문서 링크 맵
+
+3. **초안 작성**: 내용을 채워넣습니다
+   - 명확한 제목과 부제 (스캔 가능)
+   - 각 섹션 첫 문장에 핵심 내용 (역피라미드 구조)
+   - 코드 예시 (복사-붙여넣기 가능, 실행 가능)
+   - 단계별 절차 (번호 매기기, 검증 단계 포함)
+   - 시각적 보조 자료 (다이어그램, 스크린샷, 표)
+   - 주의 사항 표시 (Note, Warning, Caution, Tip)
+   - 용어 일관성 유지 (용어집 참조)
+   - 다국어 고려 (영어 + 한국어 병행 여부)
+
+4. **리뷰 및 검증**: 문서 품질을 확인합니다
+   - 기술적 정확성 -- 코드 예시 실행 확인
+   - 완전성 -- 누락된 단계나 정보 확인
+   - 명확성 -- 모호한 표현, 전문 용어 과다 사용 점검
+   - 일관성 -- 용어, 포맷, 스타일 통일
+   - 접근성 -- 스크린 리더 호환, 대체 텍스트
+   - 검색 가능성 -- 핵심 키워드가 적절히 포함
+
+5. **배포 및 유지보수**: 문서를 공개하고 관리합니다
+   - 배포 채널 결정 (GitHub Pages, Docusaurus, Notion)
+   - 버전 관리 (문서 버전 = 소프트웨어 버전)
+   - 피드백 수집 체계 (이슈, 코멘트, 분석)
+   - 정기 리뷰 일정 설정
+   - 폐기(deprecation) 절차
+</Steps>
+
+## 에이전트 위임
+
+`writer` 에이전트(Haiku 모델)에 위임하여 문서를 작성합니다:
+
+```
+Agent(
+  subagent_type="writer",
+  model="haiku",
+  prompt="DOCUMENTATION TASK
+
+기술 문서를 작성하세요.
+
+Subject: [문서화 대상]
+Audience: [대상 독자]
+Type: [Tutorial / How-to / Reference / Explanation]
+
+Writing Checklist:
+1. 대상 독자 수준에 맞는 어조 사용
+2. 실행 가능한 코드 예시 포함
+3. 단계별 절차에 검증 단계 포함
+4. 시각적 보조 자료 활용 (표, 다이어그램)
+5. 용어 일관성 유지
+
+Output: 완성된 기술 문서:
+- 목차
+- 섹션별 내용
+- 코드 예시
+- 주의 사항
+- 관련 문서 링크"
+)
+```
+
+## External Consultation (Optional)
+
+writer 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 문서 초안을 먼저 완료** -- 독립적으로 작성
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 기술 정확성 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 공개 API 문서 (외부 개발자 대상)
+- 아키텍처 설명 문서
+- 복잡한 통합 가이드
+- 다국어 문서
+
+### 자문을 생략하는 경우
+- 내부 README 업데이트
+- 간단한 설치 가이드
+- 인라인 코드 문서 (JSDoc, TSDoc)
+- 변경 이력 (CHANGELOG)
+
+## 문서 유형 가이드
+
+| 유형 | 목적 | 구조 | 예시 |
+|------|------|------|------|
+| **Tutorial** | 학습 | 단계별 진행 | "첫 번째 앱 만들기" |
+| **How-to** | 문제 해결 | 목표 → 단계 → 결과 | "인증 추가하기" |
+| **Reference** | 정보 조회 | 알파벳/카테고리 정렬 | "API 레퍼런스" |
+| **Explanation** | 이해 | 배경 → 원인 → 결과 | "인증 구조 이해하기" |
+
+## 문서 품질 체크리스트
+
+### 내용 (5개)
+- [ ] 기술적으로 정확함 (코드 예시 실행 확인)
+- [ ] 대상 독자 수준에 적합
+- [ ] 모든 필수 단계가 포함됨
+- [ ] 사전 조건(prerequisites)이 명시됨
+- [ ] 코드 예시가 복사-실행 가능
+
+### 구조 (4개)
+- [ ] 목차가 논리적으로 구성됨
+- [ ] 제목이 내용을 정확히 설명
+- [ ] 스캔이 가능한 형식 (짧은 단락, 목록, 표)
+- [ ] 관련 문서에 대한 링크 포함
+
+### 스타일 (4개)
+- [ ] 일관된 용어 사용
+- [ ] 능동태 사용 (수동태 최소화)
+- [ ] 불필요한 전문 용어 없음 (있으면 설명 포함)
+- [ ] Note/Warning/Tip이 적절히 사용됨
+
+### 접근성 (3개)
+- [ ] 이미지에 대체 텍스트 제공
+- [ ] 코드 블록에 언어 태그 명시
+- [ ] 색상으로만 정보를 전달하지 않음
+
+## 작성 원칙
+
+| 원칙 | 나쁜 예 | 좋은 예 |
+|------|---------|---------|
+| **구체적** | "설정을 변경합니다" | "`config.json`의 `port` 값을 `3000`으로 변경합니다" |
+| **능동태** | "파일이 생성됩니다" | "이 명령이 파일을 생성합니다" |
+| **검증 포함** | "실행합니다" | "실행합니다. `Started on port 3000` 메시지가 보이면 성공입니다" |
+| **이유 설명** | "캐시를 비웁니다" | "이전 빌드 아티팩트가 간섭할 수 있으므로 캐시를 비웁니다" |
+
+<Output>
+```
+DOCUMENTATION PLAN / 문서화 계획
+==================================
+
+Subject: [문서화 대상]
+Type: [Tutorial / How-to / Reference / Explanation]
+Audience: [대상 독자] ([기술 수준])
+
+TABLE OF CONTENTS / 목차
+--------------------------
+1. 개요
+   - 이 문서의 목적
+   - 사전 조건
+2. [핵심 섹션 1]
+   - [하위 항목]
+3. [핵심 섹션 2]
+4. 트러블슈팅
+5. 다음 단계
+6. 관련 문서
+
+CONTENT / 내용
+---------------
+## 1. 개요
+
+[간결한 설명 -- 이 문서를 읽으면 무엇을 할 수 있는지]
+
+### 사전 조건
+- [필요한 도구/지식 1]
+- [필요한 도구/지식 2]
+
+## 2. [핵심 섹션]
+
+### 단계 1: [동작]
+
+[왜 이 단계가 필요한지 한 줄 설명]
+
+```bash
+npm install @example/sdk
+```
+
+> **Tip:** [유용한 추가 정보]
+
+### 검증
+[성공 시 보이는 결과 설명]
+
+## 트러블슈팅
+
+| 문제 | 원인 | 해결 |
+|------|------|------|
+| [에러 메시지] | [원인] | [해결 방법] |
+
+REVIEW STATUS / 리뷰 상태
+----------------------------
+- [ ] 기술 정확성 검증
+- [ ] 코드 예시 실행 확인
+- [ ] 용어 일관성 확인
+- [ ] 접근성 검토
+```
+</Output>
+
+<Policy>
+- 코드 예시는 반드시 실행 가능해야 합니다 (복사-붙여넣기로 동작)
+- 모든 단계에 검증 방법을 포함합니다 ("이렇게 보이면 성공")
+- 독자를 가정하지 않습니다 -- 사전 조건을 명시합니다
+- 용어는 프로젝트 전체에서 일관되게 사용합니다
+- 문서는 소프트웨어와 함께 버전 관리합니다
+- 최소 1명의 기술 리뷰어를 거친 후 배포합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**API 설계 연동:**
+```
+/forgen:api-design OpenAPI 스키마 기반 문서
+```
+API 설계 결과를 문서화
+
+**아키텍처 결정 연동:**
+```
+/forgen:architecture-decision ADR 문서화
+```
+아키텍처 결정 기록 문서화
+
+**코드 리뷰 연동:**
+```
+/forgen:code-review 문서 코드 예시
+```
+문서 내 코드 예시의 정확성 검증
+
+## Best Practices
+
+- **독자 중심** -- 자신이 아닌 독자의 관점에서 작성
+- **실행 가능** -- 모든 코드 예시는 실제로 동작해야 함
+- **스캔 가능** -- 긴 텍스트보다 목록, 표, 코드 블록 활용
+- **최신 유지** -- 코드 변경 시 문서도 함께 업데이트
+- **피드백 수용** -- 독자 피드백을 적극적으로 반영
+
+<Arguments>
+## 사용법
+`/forgen:documentation {문서화 대상}`
+
+### 예시
+- `/forgen:documentation 프로젝트 README 작성`
+- `/forgen:documentation API 레퍼런스 문서`
+- `/forgen:documentation 설치 가이드 (초보자용)`
+- `/forgen:documentation 아키텍처 설명 문서`
+
+### 인자
+- 문서화할 대상, 독자, 문서 유형 등을 설명
+- 인자 없으면 프로젝트를 분석하여 필요한 문서를 제안
+</Arguments>
+
+$ARGUMENTS

package/commands/ecomode.md

@@ -0,0 +1,51 @@
+---
+name: ecomode
+description: This skill should be used when the user asks to "eco,ecomode,절약,비용절약". Token-saving eco mode with Haiku priority and minimal responses
+triggers:
+  - "eco"
+  - "ecomode"
+  - "절약"
+  - "비용절약"
+---
+
+<Purpose>
+Compound Harness Ecomode — 토큰 절약 모드.
+비용을 최소화하면서 작업을 수행합니다. Haiku 모델을 우선 사용하고, 간결한 응답을 지향합니다.
+</Purpose>
+
+<Execution_Policy>
+1. 모든 탐색은 최소한으로 (Glob/Grep 우선, Agent 최소화)
+2. 응답은 간결하게 (불필요한 설명 생략)
+3. 코드 블록 위주로 답변, 부연 설명 최소화
+4. 한 번에 정확히 수정 (반복 수정 회피)
+5. 에이전트 스폰 시 전부 Haiku 모델 사용
+</Execution_Policy>
+
+<Model_Routing>
+- 모든 작업: Haiku (강제)
+- 에이전트 스폰: Haiku (강제)
+- 복잡한 아키텍처 판단이 필요한 경우에만 Sonnet 허용
+</Model_Routing>
+
+<Constraints>
+- Agent 도구 사용 최소화 (직접 Glob/Grep/Read로 해결)
+- 불필요한 파일 탐색 금지 (목적이 명확한 탐색만)
+- 코드 설명은 요청 시에만 제공
+- 반복 수정 시 즉시 중단하고 전체 구조 파악 후 단일 수정
+- 에이전트 스폰 시 model: "haiku" 파라미터 필수
+</Constraints>
+
+<Arguments>
+## 사용법
+`/forgen:ecomode {작업 내용}`
+
+### 예시
+- `/forgen:ecomode 버그 수정: login API 500 에러`
+- `/forgen:ecomode 타입 정의 추가: UserProfile 인터페이스`
+- `eco 이 함수 리팩토링해줘`
+
+### 인자
+- 간단한 작업 설명을 전달하면 최소 비용으로 처리
+</Arguments>
+
+$ARGUMENTS