@wooojin/forgen 0.1.0

package/commands/architecture-decision.md

@@ -0,0 +1,314 @@
+---
+name: architecture-decision
+description: This skill should be used when the user asks to "adr,architecture decision,아키텍처 결정,설계 결정,기술 결정". Architecture Decision Record (ADR) creation with alternatives evaluation and consequence analysis
+triggers:
+  - "adr"
+  - "architecture decision"
+  - "아키텍처 결정"
+  - "설계 결정"
+  - "기술 결정"
+---
+<!-- forgen-managed -->
+
+<Purpose>
+아키텍처 결정 기록(ADR)을 체계적으로 작성합니다.
+의사결정의 컨텍스트, 대안 평가, 결정, 결과를 구조화하여 기록하고
+미래의 개발자가 "왜 이렇게 결정했는가"를 이해할 수 있도록 합니다.
+</Purpose>
+
+<Steps>
+1. **컨텍스트 수집**: 결정이 필요한 배경을 정리합니다
+   - 해결하려는 문제/요구사항 정의
+   - 현재 시스템 상태 및 제약 조건
+   - 비즈니스 요구사항과 기술 요구사항 구분
+   - 이해관계자 식별 (누가 영향을 받는가)
+   - 결정의 긴급도와 중요도
+   - 관련 기존 ADR 참조
+   - 비기능 요구사항 (성능, 보안, 확장성, 비용)
+
+2. **대안 탐색**: 가능한 선택지를 열거합니다
+   - 최소 3개 이상의 대안 도출
+   - 각 대안에 대한 간략한 설명
+   - "아무것도 하지 않기" 옵션 포함 (현상 유지)
+   - 업계 사례 및 벤치마크 조사
+   - 기존 기술 스택과의 호환성 확인
+   - 팀 역량 및 학습 곡선 고려
+   - 라이선스/비용 확인
+
+3. **대안 평가**: 정량적/정성적 기준으로 비교합니다
+   - 평가 기준 정의:
+     * 기술 적합성 (요구사항 충족도)
+     * 복잡도 (구현 난이도, 운영 부담)
+     * 성능 (응답 시간, 처리량, 리소스)
+     * 확장성 (수평/수직 확장 가능성)
+     * 보안 (취약점, 인증/인가)
+     * 비용 (초기 비용, 운영 비용, 기회 비용)
+     * 생태계 (커뮤니티, 문서, 도구)
+     * 팀 역량 (경험, 학습 곡선)
+   - 가중치 부여 (프로젝트별 우선순위에 따라)
+   - 각 대안의 장단점 분석
+   - PoC(Proof of Concept) 필요 여부 결정
+
+4. **결정**: 최종 선택과 근거를 명시합니다
+   - 선택된 대안과 핵심 이유
+   - 결정을 뒤집을 수 있는 조건 (reversibility)
+   - 수용한 트레이드오프 명시
+   - 거부된 대안과 거부 이유
+   - 결정에 대한 팀 합의 수준
+
+5. **결과 분석**: 결정의 예상 영향을 기록합니다
+   - 긍정적 결과 (해결되는 문제)
+   - 부정적 결과 (새로 발생하는 제약/부담)
+   - 리스크 (무엇이 잘못될 수 있는가)
+   - 리스크 완화 전략
+   - 후속 결정이 필요한 사항
+   - 모니터링 포인트 (결정의 효과를 어떻게 측정할 것인가)
+
+6. **기록 및 공유**: ADR을 작성하고 공유합니다
+   - ADR 번호 및 제목 부여 (ADR-NNN: [제목])
+   - 상태 설정 (Proposed → Accepted → Deprecated → Superseded)
+   - ADR 저장소에 등록 (docs/adr/ 또는 .adr/)
+   - 이해관계자에게 공유 및 피드백 수집
+   - 관련 코드에 ADR 참조 주석 추가
+</Steps>
+
+## 에이전트 위임
+
+`architect` 에이전트(Opus 모델)에 위임하여 아키텍처 분석을 수행합니다:
+
+```
+Agent(
+  subagent_type="architect",
+  model="opus",
+  prompt="ARCHITECTURE DECISION TASK
+
+아키텍처 결정 기록(ADR)을 작성하세요.
+
+Decision: [결정 주제]
+Context: [배경 및 제약 조건]
+
+ADR Checklist:
+1. 컨텍스트 정리 (문제, 제약, 요구사항)
+2. 대안 탐색 (최소 3개 + 현상 유지)
+3. 대안 평가 (기준별 비교표)
+4. 결정 및 근거 (선택 이유, 트레이드오프)
+5. 결과 분석 (긍정/부정, 리스크)
+6. ADR 문서 작성
+
+Output: ADR 문서:
+- 번호 및 제목
+- 상태 (Proposed/Accepted)
+- 컨텍스트
+- 대안 비교표
+- 결정 및 근거
+- 결과 및 리스크"
+)
+```
+
+## External Consultation (Optional)
+
+architect 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 분석을 먼저 완료** -- 독립적으로 대안 평가
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 분석 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 되돌리기 어려운 결정 (데이터베이스 선택, 프레임워크 변경)
+- 조직 전체에 영향을 미치는 결정
+- 비용이 큰 기술 투자 결정
+- 팀 내 의견이 분분한 결정
+
+### 자문을 생략하는 경우
+- 단순 라이브러리 선택 (유사한 기능, 낮은 영향)
+- 내부 구현 세부 사항
+- 잘 알려진 패턴 적용
+- 쉽게 되돌릴 수 있는 결정
+
+## ADR 체크리스트
+
+### 완전성 (5개)
+- [ ] 문제/요구사항이 명확히 정의됨
+- [ ] 최소 3개 대안이 탐색됨
+- [ ] 평가 기준이 명시됨
+- [ ] 선택 근거가 구체적으로 설명됨
+- [ ] 트레이드오프가 명시적으로 기록됨
+
+### 품질 (4개)
+- [ ] 비기능 요구사항 (성능, 보안, 비용)이 고려됨
+- [ ] 리스크와 완화 전략이 포함됨
+- [ ] 결정을 뒤집을 수 있는 조건이 명시됨
+- [ ] 후속 결정 사항이 식별됨
+
+### 프로세스 (3개)
+- [ ] 이해관계자와 공유됨
+- [ ] 피드백이 수집되고 반영됨
+- [ ] 관련 코드에 ADR 참조가 추가됨
+
+## ADR 상태 흐름
+
+```
+[Proposed] → [Accepted] → [Deprecated] (더 이상 관련 없음)
+                       → [Superseded by ADR-NNN] (새 결정으로 대체)
+```
+
+## 결정 되돌림 가능성 분류
+
+| 분류 | 설명 | 예시 | 투자 수준 |
+|------|------|------|-----------|
+| **Type 1** (비가역) | 되돌리기 매우 어렵거나 불가능 | DB 엔진, 프로그래밍 언어 | 심층 분석 필요 |
+| **Type 2** (가역) | 비교적 쉽게 되돌릴 수 있음 | 라이브러리, 내부 패턴 | 신속한 결정 가능 |
+
+## 평가 매트릭스 템플릿
+
+| 기준 (가중치) | 대안 A | 대안 B | 대안 C | 현상 유지 |
+|---------------|--------|--------|--------|-----------|
+| 기술 적합성 (30%) | 9 | 7 | 8 | 3 |
+| 복잡도 (20%) | 6 | 8 | 5 | 10 |
+| 성능 (15%) | 8 | 7 | 9 | 5 |
+| 확장성 (15%) | 9 | 6 | 8 | 4 |
+| 비용 (10%) | 5 | 8 | 6 | 10 |
+| 팀 역량 (10%) | 7 | 9 | 5 | 10 |
+| **가중 합계** | **7.6** | **7.3** | **7.0** | **5.8** |
+
+<Output>
+```
+ARCHITECTURE DECISION RECORD / 아키텍처 결정 기록
+===================================================
+
+ADR-NNN: [결정 제목]
+Status: [Proposed / Accepted / Deprecated / Superseded by ADR-NNN]
+Date: YYYY-MM-DD
+Deciders: [결정 참여자]
+
+CONTEXT / 컨텍스트
+--------------------
+[해결하려는 문제와 배경 설명]
+
+Requirements:
+- [기능 요구사항 1]
+- [비기능 요구사항 (성능, 보안, 비용)]
+
+Constraints:
+- [제약 조건 1]
+- [제약 조건 2]
+
+ALTERNATIVES / 대안
+---------------------
+### 대안 A: [이름]
+[설명]
+- Pros: [장점]
+- Cons: [단점]
+
+### 대안 B: [이름]
+[설명]
+- Pros: [장점]
+- Cons: [단점]
+
+### 대안 C: [이름] (현상 유지)
+[설명]
+- Pros: [장점]
+- Cons: [단점]
+
+EVALUATION / 평가
+-------------------
+| 기준 (가중치) | 대안 A | 대안 B | 대안 C |
+|---------------|--------|--------|--------|
+| [기준 1] (N%) | N/10   | N/10   | N/10   |
+| [기준 2] (N%) | N/10   | N/10   | N/10   |
+| **합계**      | **N**  | **N**  | **N**  |
+
+DECISION / 결정
+-----------------
+**대안 A를 선택합니다.**
+
+Rationale: [핵심 선택 이유]
+
+Trade-offs accepted:
+- [수용한 트레이드오프 1]
+- [수용한 트레이드오프 2]
+
+Reversibility: [Type 1 (비가역) / Type 2 (가역)]
+Reversal condition: [이 결정을 뒤집어야 하는 조건]
+
+CONSEQUENCES / 결과
+---------------------
+Positive:
+- [긍정적 결과 1]
+- [긍정적 결과 2]
+
+Negative:
+- [부정적 결과 1]
+- [부정적 결과 2]
+
+Risks:
+- [리스크 1] → 완화: [완화 전략]
+- [리스크 2] → 완화: [완화 전략]
+
+Follow-up decisions needed:
+- [후속 결정 1]
+- [후속 결정 2]
+
+MONITORING / 모니터링
+-----------------------
+- [효과 측정 지표 1]
+- [효과 측정 지표 2]
+- Review date: YYYY-MM-DD (3개월 후 재검토)
+```
+</Output>
+
+<Policy>
+- 최소 3개 대안을 비교합니다 ("현상 유지" 포함)
+- 정량적 평가 기준을 사용합니다 (직관이 아닌 데이터 기반)
+- 트레이드오프를 명시적으로 기록합니다 -- 모든 결정에는 대가가 있음
+- 결정을 뒤집을 수 있는 조건을 미리 정의합니다
+- ADR은 코드와 함께 버전 관리합니다 (docs/adr/)
+- 폐기된 ADR도 삭제하지 않습니다 -- 역사적 맥락을 보존
+</Policy>
+
+## 다른 스킬과의 연동
+
+**코드 리뷰 연동:**
+```
+/forgen:code-review ADR에 따른 구현 검증
+```
+아키텍처 결정이 구현에 올바르게 반영되었는지 검증
+
+**문서화 연동:**
+```
+/forgen:documentation ADR 기반 아키텍처 문서
+```
+ADR을 바탕으로 아키텍처 설명 문서 작성
+
+**보안 리뷰 연동:**
+```
+/forgen:security-review ADR의 보안 영향 분석
+```
+아키텍처 결정의 보안 관점 검토
+
+## Best Practices
+
+- **결정 기록** -- 구두 합의보다 문서화된 ADR
+- **미래의 나를 위해** -- 6개월 후 맥락을 잊은 자신을 독자로 상정
+- **간결하게** -- ADR은 1~2페이지가 적당
+- **적시에** -- 결정 시점에 작성, 나중에 "기억해서" 쓰지 않음
+- **갱신** -- 상황 변화 시 ADR 상태를 업데이트
+
+<Arguments>
+## 사용법
+`/forgen:architecture-decision {결정 주제}`
+
+### 예시
+- `/forgen:architecture-decision 상태 관리 라이브러리 선택`
+- `/forgen:architecture-decision 모놀리스 → 마이크로서비스 전환`
+- `/forgen:architecture-decision 인증 방식 결정 (JWT vs Session)`
+- `/forgen:architecture-decision 데이터베이스 선택 (PostgreSQL vs MongoDB)`
+
+### 인자
+- 결정이 필요한 주제, 배경, 제약 조건 등을 설명
+- 인자 없으면 현재 프로젝트에서 문서화가 필요한 아키텍처 결정을 식별
+</Arguments>
+
+$ARGUMENTS

package/commands/ci-cd.md

@@ -0,0 +1,270 @@
+---
+name: ci-cd
+description: This skill should be used when the user asks to "ci cd,ci/cd,파이프라인,github actions,배포 자동화,pipeline design". CI/CD pipeline design, implementation, and optimization
+triggers:
+  - "ci cd"
+  - "ci/cd"
+  - "파이프라인"
+  - "github actions"
+  - "배포 자동화"
+  - "pipeline design"
+---
+<!-- forgen-managed -->
+
+<Purpose>
+CI/CD 파이프라인을 설계하고 구현합니다.
+빌드, 테스트, 린트, 보안 스캔, 배포까지의 자동화 파이프라인을 구축하고
+안정적이고 빠른 배포 사이클을 확립합니다.
+</Purpose>
+
+<Steps>
+1. **요구사항 분석**: 프로젝트의 CI/CD 요구사항을 파악합니다
+   - 현재 배포 프로세스 파악 (수동/자동)
+   - 배포 대상 환경 (staging, production, preview)
+   - 브랜치 전략 확인 (gitflow, trunk-based, GitHub flow)
+   - 필요한 품질 게이트 식별
+   - 배포 빈도 목표
+   - 롤백 요구사항
+   - 시크릿 관리 방식
+   - 알림/모니터링 연동 대상
+
+2. **파이프라인 스테이지 설계**: 단계별 작업을 정의합니다
+   - **Install**: 의존성 설치 (캐시 활용)
+   - **Lint**: 코드 스타일 검사 (ESLint, Prettier)
+   - **Type Check**: 타입 검사 (TypeScript)
+   - **Unit Test**: 유닛 테스트 실행 + 커버리지
+   - **Integration Test**: 통합 테스트 (DB, 외부 서비스)
+   - **Build**: 프로덕션 빌드
+   - **Security Scan**: 의존성 취약점 검사 (npm audit, Snyk)
+   - **E2E Test**: End-to-End 테스트 (Playwright, Cypress)
+   - **Deploy**: 배포 (환경별 차등)
+   - **Smoke Test**: 배포 후 기본 동작 확인
+   - **Notify**: 결과 알림 (Slack, Discord)
+
+3. **구현**: 파이프라인 설정 파일을 작성합니다
+   - CI 플랫폼 선택 (GitHub Actions, GitLab CI, CircleCI)
+   - 워크플로우 파일 작성
+   - 병렬 실행 가능한 작업 식별 및 설정
+   - 캐싱 전략 (node_modules, 빌드 아티팩트)
+   - 매트릭스 빌드 (여러 Node 버전, OS)
+   - 환경별 배포 조건 설정
+   - 시크릿 설정 (환경 변수, 시크릿 스토어)
+   - 재사용 가능한 워크플로우 분리
+
+4. **품질 게이트 설정**: 머지/배포 차단 조건을 설정합니다
+   - 테스트 커버리지 임계값 (85%+)
+   - 린트 에러 제로
+   - 타입 에러 제로
+   - 보안 취약점 제로 (CRITICAL/HIGH)
+   - 빌드 성공 필수
+   - PR 리뷰 승인 필수
+   - 커밋 메시지 컨벤션 검사
+
+5. **모니터링 및 최적화**: 파이프라인 성능을 관리합니다
+   - 파이프라인 실행 시간 추적
+   - 실패율 모니터링
+   - Flaky 테스트 추적 및 제거
+   - 캐시 히트율 최적화
+   - 불필요한 재실행 방지 (경로 필터링)
+   - 비용 최적화 (러너 크기, 병렬화)
+</Steps>
+
+## 에이전트 위임
+
+`executor` 에이전트(Sonnet 모델)에 위임하여 파이프라인을 구현합니다:
+
+```
+Agent(
+  subagent_type="executor",
+  model="sonnet",
+  prompt="CI/CD PIPELINE TASK
+
+CI/CD 파이프라인을 설계하고 구현하세요.
+
+Project: [프로젝트 설명]
+Platform: [GitHub Actions / GitLab CI / etc.]
+Branch Strategy: [gitflow / trunk-based / GitHub flow]
+
+Pipeline Checklist:
+1. 스테이지 설계 (lint, test, build, deploy)
+2. 워크플로우 파일 작성
+3. 캐싱 및 병렬화 최적화
+4. 품질 게이트 설정
+5. 시크릿 및 환경 변수 관리
+6. 배포 전략 (환경별)
+
+Output: CI/CD 구성 파일 및 문서:
+- 워크플로우 파일(들)
+- 환경별 배포 설정
+- 품질 게이트 목록
+- 파이프라인 다이어그램"
+)
+```
+
+## External Consultation (Optional)
+
+executor 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 파이프라인 설계를 먼저 완료** -- 독립적으로 구현
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 설계 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 멀티 환경 배포 전략 (dev/staging/prod)
+- Blue-Green 또는 Canary 배포 설정
+- 모노레포 CI 최적화
+- 보안이 중요한 배포 파이프라인
+
+### 자문을 생략하는 경우
+- 단순 린트/테스트 파이프라인
+- 단일 환경 배포
+- 잘 알려진 CI 템플릿 적용
+- 기존 파이프라인의 경미한 수정
+
+## 파이프라인 체크리스트
+
+### CI (Continuous Integration) (6개)
+- [ ] 의존성 설치에 캐시 적용
+- [ ] 린트가 모든 PR에서 실행됨
+- [ ] 타입 체크가 모든 PR에서 실행됨
+- [ ] 테스트가 커버리지와 함께 실행됨
+- [ ] 보안 스캔이 포함됨
+- [ ] 빌드가 성공해야 머지 가능
+
+### CD (Continuous Deployment) (5개)
+- [ ] staging 환경에 자동 배포
+- [ ] production 배포에 수동 승인 또는 자동 게이트
+- [ ] 배포 후 스모크 테스트 실행
+- [ ] 롤백 절차가 문서화/자동화됨
+- [ ] 배포 알림이 설정됨
+
+### 보안 (4개)
+- [ ] 시크릿이 CI 플랫폼의 시크릿 스토어에 저장됨
+- [ ] 워크플로우 파일에 하드코딩된 시크릿 없음
+- [ ] 의존성 취약점 스캔 포함
+- [ ] 최소 권한 원칙으로 배포 토큰 설정
+
+### 성능 (3개)
+- [ ] 병렬 실행으로 총 실행 시간 최소화
+- [ ] 경로 필터로 불필요한 실행 방지
+- [ ] 캐시 히트율이 80% 이상
+
+## 배포 전략 비교
+
+| 전략 | 다운타임 | 롤백 속도 | 복잡도 | 적합한 경우 |
+|------|----------|-----------|--------|-------------|
+| **Rolling** | 없음 | 느림 | 낮음 | 일반 웹 서비스 |
+| **Blue-Green** | 없음 | 즉시 | 중간 | 빠른 롤백 필요 |
+| **Canary** | 없음 | 빠름 | 높음 | 대규모 트래픽 |
+| **Recreate** | 있음 | 느림 | 낮음 | 비프로덕션 환경 |
+
+<Output>
+```
+CI/CD PIPELINE DOCUMENT / CI/CD 파이프라인 문서
+================================================
+
+Project: [프로젝트명]
+Platform: [GitHub Actions / GitLab CI]
+Branch Strategy: [gitflow / trunk-based]
+
+PIPELINE DIAGRAM / 파이프라인 다이어그램
+-----------------------------------------
+PR → [Install] → [Lint + Type Check + Unit Test] → [Build] → [Security Scan]
+                         (parallel)
+main → [Install] → [Full Test] → [Build] → [Deploy Staging] → [Smoke Test]
+                                                    ↓ (manual approve)
+                                            [Deploy Production] → [Smoke Test]
+
+STAGES / 스테이지
+------------------
+| Stage         | Trigger      | Duration | Parallel |
+|---------------|-------------|----------|----------|
+| Install       | PR, push    | ~30s     | -        |
+| Lint          | PR, push    | ~15s     | Yes      |
+| Type Check    | PR, push    | ~20s     | Yes      |
+| Unit Test     | PR, push    | ~45s     | Yes      |
+| Build         | PR, push    | ~60s     | -        |
+| Security Scan | PR, push    | ~30s     | Yes      |
+| Deploy Staging| main push   | ~120s    | -        |
+| Smoke Test    | after deploy| ~30s     | -        |
+| Deploy Prod   | manual      | ~120s    | -        |
+
+QUALITY GATES / 품질 게이트
+-----------------------------
+- Test Coverage: >= 85%
+- Lint Errors: 0
+- Type Errors: 0
+- Security Vulnerabilities (CRITICAL/HIGH): 0
+- Build: Success
+- PR Review: >= 1 approval
+
+WORKFLOW FILES / 워크플로우 파일
+---------------------------------
+.github/workflows/
+  ci.yml          -- PR 검증 (lint, test, build)
+  cd-staging.yml  -- staging 자동 배포
+  cd-prod.yml     -- production 수동 배포
+  security.yml    -- 주간 보안 스캔
+
+ESTIMATED TOTAL RUNTIME / 예상 총 실행 시간
+---------------------------------------------
+PR Pipeline: ~2m30s
+Deploy Pipeline: ~5m
+```
+</Output>
+
+<Policy>
+- 파이프라인은 10분 이내에 완료되어야 합니다 (PR 기준 5분 목표)
+- 시크릿은 절대 워크플로우 파일에 하드코딩하지 않습니다
+- 프로덕션 배포에는 반드시 승인 프로세스를 포함합니다
+- 롤백 절차를 반드시 문서화하고 테스트합니다
+- Flaky 테스트는 파이프라인 신뢰성을 해치므로 즉시 수정합니다
+- 비용 효율성을 고려하여 불필요한 실행을 방지합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**테스트 전략 연동:**
+```
+/forgen:testing-strategy CI에서 실행할 테스트 구성
+```
+테스트 전략에 맞는 CI 테스트 단계 구성
+
+**보안 리뷰 연동:**
+```
+/forgen:security-review .github/workflows/
+```
+워크플로우 파일의 보안 점검
+
+**Docker 연동:**
+```
+/forgen:docker CI에서 컨테이너 빌드
+```
+CI 파이프라인에 Docker 이미지 빌드 통합
+
+## Best Practices
+
+- **빠르게 실패** -- 가장 빠른 검사를 먼저 실행 (lint > type > test > build)
+- **병렬화** -- 독립적인 작업은 동시에 실행
+- **캐시 활용** -- 의존성과 빌드 아티팩트를 캐싱
+- **경로 필터링** -- 관련 파일 변경 시에만 실행
+- **알림 최적화** -- 실패 시에만 알림 (성공 알림은 노이즈)
+
+<Arguments>
+## 사용법
+`/forgen:ci-cd {파이프라인 대상}`
+
+### 예시
+- `/forgen:ci-cd GitHub Actions 파이프라인 설계`
+- `/forgen:ci-cd staging 자동 배포 설정`
+- `/forgen:ci-cd 기존 파이프라인 실행 시간 최적화`
+- `/forgen:ci-cd Vercel 배포 + Preview 환경 구성`
+
+### 인자
+- CI 플랫폼, 배포 대상, 최적화 목표 등을 설명
+- 인자 없으면 프로젝트에 적합한 CI/CD 파이프라인을 설계
+</Arguments>
+
+$ARGUMENTS