@wooojin/forgen 0.1.0

package/skills/database/SKILL.md

@@ -0,0 +1,257 @@
+---
+name: database
+description: This skill should be used when the user asks to "database,db 설계,schema,migration,마이그레이션,스키마". Database schema design, migration planning, and optimization
+---
+
+<!-- forgen-managed -->
+
+<Purpose>
+데이터베이스 스키마 설계와 마이그레이션을 체계적으로 수행합니다.
+요구사항 분석부터 정규화, 인덱싱, 마이그레이션 스크립트 작성,
+롤백 계획까지 데이터 레이어의 전체 라이프사이클을 다룹니다.
+</Purpose>
+
+<Steps>
+1. **요구사항 분석**: 데이터 요구사항을 수집하고 정리합니다
+   - 비즈니스 엔티티와 관계 식별
+   - 읽기/쓰기 비율 추정 (read-heavy vs write-heavy)
+   - 예상 데이터 볼륨 추정 (행 수, 증가율)
+   - 트랜잭션 요구사항 (ACID, eventual consistency)
+   - 보존 정책 (데이터 수명, 아카이빙 규칙)
+   - 규제 요구사항 (GDPR, 개인정보보호법)
+
+2. **스키마 설계**: 정규화된 스키마를 설계합니다
+   - ERD(Entity-Relationship Diagram) 작성
+   - 정규화 수준 결정 (3NF 기본, 필요 시 역정규화)
+   - 데이터 타입 선택 (정확한 크기, nullable 여부)
+   - 기본 키 전략 (UUID vs auto-increment vs ULID)
+   - 외래 키 제약 조건 및 cascade 정책
+   - 소프트 삭제(soft delete) vs 하드 삭제 결정
+   - 감사(audit) 필드 포함 (created_at, updated_at, created_by)
+   - enum 값의 저장 전략 (DB enum vs string vs lookup table)
+
+3. **인덱싱 전략**: 쿼리 성능을 위한 인덱스를 설계합니다
+   - 주요 쿼리 패턴 분석 (WHERE, JOIN, ORDER BY)
+   - 단일 컬럼 인덱스 vs 복합 인덱스 결정
+   - 커버링 인덱스 활용 가능성 검토
+   - 부분 인덱스(partial index) 적용 가능성
+   - 인덱스 카디널리티와 선택도 분석
+   - 인덱스의 쓰기 성능 영향 평가
+   - EXPLAIN ANALYZE로 쿼리 플랜 검증 계획
+
+4. **마이그레이션 스크립트 작성**: 안전한 마이그레이션을 구현합니다
+   - 마이그레이션 도구 선택 (Prisma, Knex, TypeORM, raw SQL)
+   - UP 마이그레이션 작성 (스키마 변경 적용)
+   - DOWN 마이그레이션 작성 (변경 롤백)
+   - 데이터 마이그레이션 포함 (기존 데이터 변환)
+   - 대용량 테이블 변경 시 무중단 전략 (온라인 DDL)
+   - 마이그레이션 순서 의존성 확인
+
+5. **롤백 계획**: 장애 시 복구 절차를 수립합니다
+   - 롤백 스크립트 테스트 (UP -> DOWN -> UP 사이클)
+   - 데이터 손실 없는 롤백 가능 여부 확인
+   - 백업/복원 절차 문서화
+   - 마이그레이션 실패 시 수동 복구 절차
+   - Point-in-Time Recovery 설정 확인
+
+6. **성능 검증**: 스키마 변경의 성능 영향을 검증합니다
+   - 마이그레이션 실행 시간 추정
+   - 테이블 잠금(lock) 영향 범위 확인
+   - 인덱스 생성의 동시성 영향 (CONCURRENTLY 옵션)
+   - 스테이징 환경에서 실데이터 볼륨 테스트
+</Steps>
+
+## 에이전트 위임
+
+`architect` 에이전트(Opus 모델)에 위임하여 데이터베이스 아키텍처를 설계합니다:
+
+```
+Agent(
+  subagent_type="architect",
+  model="opus",
+  prompt="DATABASE DESIGN TASK
+
+데이터베이스 스키마를 설계하고 마이그레이션 계획을 수립하세요.
+
+Domain: [도메인/서비스 설명]
+Database: [PostgreSQL / MySQL / MongoDB / etc.]
+
+Design Checklist:
+1. ERD 및 엔티티 관계 설계
+2. 정규화 및 데이터 타입 결정
+3. 인덱싱 전략 수립
+4. 마이그레이션 스크립트 (UP/DOWN)
+5. 롤백 계획 및 백업 절차
+6. 성능 영향 분석
+
+Output: 데이터베이스 설계 문서:
+- ERD (텍스트 기반)
+- 테이블/컬렉션 정의
+- 인덱스 목록
+- 마이그레이션 스크립트
+- 롤백 절차"
+)
+```
+
+## External Consultation (Optional)
+
+architect 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 스키마 설계를 먼저 완료** -- 독립적으로 설계 수행
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 설계 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 대규모 스키마 마이그레이션 (10+ 테이블 변경)
+- 성능이 중요한 인덱싱 전략
+- 프로덕션 환경의 무중단 마이그레이션
+- 데이터 일관성이 중요한 트랜잭션 설계
+
+### 자문을 생략하는 경우
+- 단순 테이블 추가/수정
+- 잘 알려진 스키마 패턴 적용
+- 개발 환경의 마이그레이션
+- 소규모 인덱스 추가
+
+## 데이터베이스 설계 체크리스트
+
+### 스키마 설계 (6개)
+- [ ] 모든 테이블에 적절한 기본 키 존재
+- [ ] 외래 키 제약 조건이 설정됨
+- [ ] 데이터 타입이 정확한 크기로 선택됨
+- [ ] nullable 필드가 명시적으로 결정됨
+- [ ] 감사 필드 포함 (created_at, updated_at)
+- [ ] 소프트 삭제 전략이 결정됨
+
+### 인덱싱 (4개)
+- [ ] 주요 쿼리 패턴에 인덱스 적용됨
+- [ ] 복합 인덱스의 컬럼 순서가 최적화됨
+- [ ] 과도한 인덱스로 인한 쓰기 성능 저하 없음
+- [ ] 유니크 제약 조건이 비즈니스 규칙과 일치
+
+### 마이그레이션 (4개)
+- [ ] UP/DOWN 마이그레이션 모두 작성됨
+- [ ] 데이터 마이그레이션이 포함됨 (필요 시)
+- [ ] 롤백 테스트 완료
+- [ ] 마이그레이션 실행 시간이 허용 범위 내
+
+### 보안 (4개)
+- [ ] 민감 데이터가 암호화됨
+- [ ] 접근 권한이 최소 권한 원칙으로 설정됨
+- [ ] PII 데이터의 보존/삭제 정책이 정의됨
+- [ ] 감사 로그가 중요 변경에 대해 기록됨
+
+<Output>
+```
+DATABASE DESIGN DOCUMENT / 데이터베이스 설계 문서
+==================================================
+
+Service: [서비스명]
+Database: [PostgreSQL / MySQL / MongoDB]
+Migration Tool: [Prisma / Knex / TypeORM]
+
+ERD / 엔티티 관계
+-------------------
+[User] 1---N [Order] N---M [Product]
+  |                         |
+  1---N [Address]           1---N [Review]
+
+TABLES / 테이블 정의
+---------------------
+Table: users
+  id          UUID        PK, DEFAULT gen_random_uuid()
+  email       VARCHAR(255) NOT NULL, UNIQUE
+  name        VARCHAR(100) NOT NULL
+  password    VARCHAR(255) NOT NULL
+  role        VARCHAR(20)  NOT NULL, DEFAULT 'user'
+  created_at  TIMESTAMPTZ  NOT NULL, DEFAULT NOW()
+  updated_at  TIMESTAMPTZ  NOT NULL, DEFAULT NOW()
+  deleted_at  TIMESTAMPTZ  NULL
+
+INDEXES / 인덱스
+-----------------
+| Table  | Name                | Columns        | Type   | Reason              |
+|--------|---------------------|----------------|--------|---------------------|
+| users  | idx_users_email     | email          | UNIQUE | 로그인 조회          |
+| orders | idx_orders_user_date| user_id, date  | BTREE  | 사용자별 주문 조회   |
+
+MIGRATION / 마이그레이션
+-------------------------
+File: 20260402_001_create_users.sql
+
+-- UP
+CREATE TABLE users ( ... );
+CREATE INDEX idx_users_email ON users(email);
+
+-- DOWN
+DROP TABLE IF EXISTS users;
+
+ROLLBACK PLAN / 롤백 계획
+---------------------------
+1. 마이그레이션 실패 시: DOWN 스크립트 실행
+2. 데이터 손실 위험 시: pg_dump 백업에서 복원
+3. 긴급 시: Point-in-Time Recovery 사용
+
+PERFORMANCE IMPACT / 성능 영향
+-------------------------------
+- 마이그레이션 예상 시간: [N분]
+- 테이블 잠금: [있음/없음]
+- 인덱스 생성: [CONCURRENTLY 사용 여부]
+```
+</Output>
+
+<Policy>
+- 마이그레이션은 반드시 UP/DOWN 양방향으로 작성합니다
+- 프로덕션 마이그레이션 전 스테이징에서 실행 테스트 필수
+- 데이터 손실 가능성이 있는 변경은 백업 확인 후 진행
+- 인덱스 변경은 EXPLAIN ANALYZE로 효과를 검증합니다
+- 대용량 테이블의 ALTER는 무중단 전략을 사용합니다
+- 롤백 불가능한 마이그레이션은 명시적으로 경고합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**API 설계 연동:**
+```
+/forgen:api-design 데이터 모델 기반 REST API
+```
+데이터베이스 스키마와 일관된 API 설계
+
+**보안 리뷰 연동:**
+```
+/forgen:security-review 마이그레이션 스크립트
+```
+마이그레이션의 보안 영향 점검
+
+**성능 최적화 연동:**
+```
+/forgen:performance 쿼리 성능 분석
+```
+인덱스 효과 및 쿼리 최적화
+
+## Best Practices
+
+- **점진적 마이그레이션** -- 대규모 변경을 작은 단계로 분할
+- **데이터 먼저 백업** -- 프로덕션 변경 전 반드시 백업
+- **테스트 환경 검증** -- 실 데이터 볼륨으로 성능 확인
+- **문서화** -- 스키마 변경 이유와 영향을 기록
+- **무중단 우선** -- 서비스 중단 없는 마이그레이션 전략
+
+<Arguments>
+## 사용법
+`/forgen:database {설계/마이그레이션 대상}`
+
+### 예시
+- `/forgen:database 사용자 관리 시스템 스키마 설계`
+- `/forgen:database orders 테이블에 discount 컬럼 추가 마이그레이션`
+- `/forgen:database 기존 스키마의 인덱싱 최적화`
+- `/forgen:database PostgreSQL에서 MongoDB로 마이그레이션 계획`
+
+### 인자
+- 설계할 도메인, 변경할 스키마, 마이그레이션 목적 등을 설명
+- 인자 없으면 프로젝트의 현재 스키마를 분석
+</Arguments>
+
+$ARGUMENTS

package/skills/debug-detective/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: debug-detective
+description: This skill should be used when the user asks to "debug-detective,디버그탐정,체계적디버깅". Systematic debugging with reproduce-isolate-fix-verify loop
+---
+
+<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/skills/docker/SKILL.md

@@ -0,0 +1,268 @@
+---
+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
+---
+
+<!-- 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