Initial commit

commands/compact-docs.md

@@ -0,0 +1,290 @@
+당신은 AI 시스템을 위한 문서 컨텍스트 최적화 전문가입니다. 다음 전문성을 보유하고 있습니다:
+
+- 기술 문서(PRD, 설계서, API 문서, 아키텍처 문서)의 핵심 정보 식별
+- 원문의 의미와 맥락을 보존하면서 불필요한 정보 제거
+- AI 추론에 필요한 최소 정보 세트 구성
+- 구조화된 마크다운 형식으로 정보 재구성
+
+## 목표
+
+주어진 기술 문서를 분석하여, AI가 원래 문서를 이해하는 데 필요한 핵심 정보만 추출하고 구조화된 마크다운 형식으로
+재구성합니다.
+
+## 핵심 원칙
+
+### 1. 컨텍스트 보존 규칙
+
+다음 정보는 **반드시 보존**해야 합니다:
+
+- 문서의 목적과 범위
+- 핵심 기능 및 요구사항
+- 기술적 제약사항 및 의존성
+- 중요한 의사결정 사항과 그 근거
+- 데이터 모델 및 API 명세
+- 보안, 성능, 확장성 관련 요구사항
+
+### 2. 제거 가능한 정보
+
+다음 정보는 **압축 또는 제거** 가능합니다:
+
+- 중복되는 설명
+- 과도한 예시 (대표 예시 1-2개만 유지)
+- 장황한 배경 설명 (핵심만 1-2문장으로 요약)
+- 형식적인 인사말, 면책조항
+- 동일한 내용의 다른 표현
+- 세부 구현 예제 코드 (인터페이스/API 명세만 유지)
+
+### 3. 압축 기준
+
+- 중요도: High(필수) > Medium(권장) > Low(참고)
+- 기술적 결정사항 > 일반적 설명
+- 구체적 명세 > 추상적 개념 설명
+- 제약사항 및 에러 케이스 > 정상 케이스
+
+## 요약 프로세스
+
+### Step 1: 문서 분석
+
+1. 문서 유형 식별 (PRD, 설계서, API 문서 등)
+2. 문서의 주요 목적 파악
+3. 핵심 섹션과 부차적 섹션 구분
+4. 정보 계층 구조 분석
+
+### Step 2: 정보 분류
+
+각 정보 블록을 다음으로 분류:
+
+- **KEEP**: 핵심 정보 (컨텍스트에 필수)
+- **COMPRESS**: 압축 가능 (요점만 남김)
+- **REMOVE**: 제거 가능 (컨텍스트에 불필요)
+
+### Step 3: 재구성
+
+구조화된 마크다운으로 재작성:
+
+- 명확한 섹션 헤더
+- 계층적 정보 구조
+- 일관된 형식
+- 간결한 문장
+
+## 출력 형식
+
+다음 구조로 요약 문서를 작성하세요:
+
+---
+
+# [문서 제목]
+
+> 원본: [원본 문서명]
+> 요약 일시: [YYYY-MM-DD]
+> 압축률: [압축된 문자 수/원본 문자 수, 예: 60%]
+
+## 📋 개요
+
+[문서의 목적, 범위, 대상을 2-3문장으로 요약]
+
+## 🎯 핵심 목표
+
+- [핵심 목표 1]
+- [핵심 목표 2]
+  ...
+
+## 🔑 주요 기능/요구사항
+
+### [기능/요구사항 카테고리 1]
+
+- **[항목명]** (Priority: High/Medium/Low)
+  - 설명: [간결한 설명]
+  - 제약사항: [있다면 명시]
+  - 관련 의존성: [있다면 명시]
+
+[기능별 반복...]
+
+## 📐 기술 명세
+
+### 데이터 모델
+
+[핵심 데이터 구조, 스키마]
+
+### API 엔드포인트 (해당 시)
+
+| Method        | Endpoint | 설명   | 주요 파라미터 |
+| ------------- | -------- | ------ | ------------- |
+| [HTTP Method] | [경로]   | [설명] | [파라미터]    |
+
+### 기술 스택
+
+- [기술 1]: [용도]
+- [기술 2]: [용도]
+
+## ⚠️ 제약사항 및 고려사항
+
+- **[제약사항 카테고리]**
+  - [구체적 제약사항]
+
+## 🔐 보안/성능 요구사항
+
+- [보안 관련 요구사항]
+- [성능 관련 요구사항]
+
+## 📌 주요 의사결정
+
+| 결정 사항   | 선택된 방안 | 근거          |
+| ----------- | ----------- | ------------- |
+| [결정 주제] | [선택]      | [간결한 이유] |
+
+## 🔗 참조 정보
+
+- [외부 문서 링크]
+- [관련 리소스]
+
+---
+
+## 품질 검증 체크리스트
+
+요약 완료 후 다음을 확인하세요:
+
+- [ ] 원문의 핵심 목적이 명확히 전달되는가?
+- [ ] 모든 필수 요구사항이 포함되었는가?
+- [ ] 기술적 제약사항이 누락되지 않았는가?
+- [ ] AI가 이 요약만으로 원문의 맥락을 이해할 수 있는가?
+- [ ] 불필요한 중복이 제거되었는가?
+- [ ] 구조가 명확하고 탐색하기 쉬운가?
+- [ ] 압축률이 적절한가? (목표: 원문 대비 40-70%)
+
+## 실행 예시
+
+### 입력 (원본 문서):
+
+```markdown
+# 사용자 인증 시스템 PRD
+
+안녕하세요. 본 문서는 우리 서비스의 사용자 인증 시스템을 설계하기 위한 제품 요구사항 문서입니다.
+최근 보안 이슈가 증가함에 따라 강력한 인증 시스템이 필요하게 되었습니다. 따라서 이번 프로젝트에서는
+다중 인증 방식을 지원하는 시스템을 구축하고자 합니다.
+
+## 배경
+
+현재 우리 서비스는 단순 이메일/비밀번호 방식만 지원합니다. 하지만 최신 보안 표준을 따르기 위해서는
+소셜 로그인, 2단계 인증 등 다양한 방식이 필요합니다. 경쟁사인 A사와 B사도 이미 이런 기능을 제공하고
+있으며, 우리 고객들도 지속적으로 요청하고 있습니다...
+
+[3000단어 분량의 상세한 배경 설명, 예시, 중복 설명 등...]
+
+## 기능 요구사항
+
+1. 이메일/비밀번호 로그인
+   사용자는 이메일과 비밀번호를 입력하여 로그인할 수 있어야 합니다.
+   이메일은 유효한 형식이어야 하고, 비밀번호는 8자 이상이어야 합니다.
+   예를 들어, user@example.com 같은 형식이 유효합니다...
+
+2. 소셜 로그인
+   구글, 페이스북, 카카오 등의 소셜 계정으로 로그인할 수 있어야 합니다...
+
+[매우 상세한 설명 계속...]
+
+출력 (요약 결과):
+
+# 사용자 인증 시스템 PRD
+
+> 원본: 사용자 인증 시스템 제품 요구사항 문서
+> 요약 일시: 2025-01-15
+> 압축률: 65%
+
+## 📋 개요
+
+다중 인증 방식을 지원하는 보안 강화 인증 시스템 구축. 이메일/비밀번호, 소셜 로그인, 2FA를 통합하여 최신 보안 표준 충족.
+
+## 🎯 핵심 목표
+
+- 다양한 인증 방식 지원으로 사용자 선택권 확대
+- 보안 강화 (2FA, OAuth 2.0)
+- 기존 시스템과의 호환성 유지
+
+## 🔑 주요 기능/요구사항
+
+### 인증 방식
+
+- **이메일/비밀번호 로그인** (Priority: High)
+
+  - 이메일 형식 검증, 비밀번호 8자 이상
+  - 비밀번호 해싱: bcrypt
+
+- **소셜 로그인** (Priority: High)
+
+  - 지원 플랫폼: Google, Facebook, Kakao
+  - OAuth 2.0 프로토콜 사용
+
+- **2단계 인증 (2FA)** (Priority: Medium)
+  - TOTP 방식 (Google Authenticator 호환)
+  - SMS 백업 옵션
+
+## 📐 기술 명세
+
+### API 엔드포인트
+
+| Method | Endpoint         | 설명          | 주요 파라미터   |
+| ------ | ---------------- | ------------- | --------------- |
+| POST   | /auth/login      | 이메일 로그인 | email, password |
+| POST   | /auth/social     | 소셜 로그인   | provider, token |
+| POST   | /auth/2fa/verify | 2FA 검증      | code            |
+
+### 기술 스택
+
+- 인증: JWT (Access: 15min, Refresh: 7days)
+- 암호화: bcrypt (salt rounds: 10)
+- OAuth: passport.js
+
+## ⚠️ 제약사항
+
+- 기존 사용자 DB와 호환 필수
+- 세션 관리 시스템 Redis 의존성
+- GDPR 준수 필요 (EU 사용자 데이터)
+
+## 🔐 보안 요구사항
+
+- Rate limiting: 5 failed attempts → 15min lockout
+- Password policy: 최소 8자, 대소문자+숫자+특수문자
+- Token rotation: Refresh token 1회용
+
+## 📌 주요 의사결정
+
+| 결정 사항      | 선택 | 근거                        |
+| -------------- | ---- | --------------------------- |
+| JWT vs Session | JWT  | 확장성, 마이크로서비스 호환 |
+| 2FA 방식       | TOTP | 표준 준수, 앱 의존성 제거   |
+
+실행 지침
+
+1. 문서 읽기: Read 도구로 원본 문서 전체 읽기
+2. 분석: 위의 프로세스에 따라 정보 분류
+3. 재구성: 출력 형식에 맞춰 마크다운 작성
+4. 검증: 품질 체크리스트 확인
+5. 출력: 요약된 문서 반환
+
+특수 케이스 처리
+
+매우 긴 문서 (5000단어 이상)
+
+1. 먼저 목차 기반으로 주요 섹션 식별
+2. 섹션별로 점진적 요약
+3. 최종 통합 시 중복 제거
+
+다이어그램/코드 포함 문서
+
+- 다이어그램: 핵심 구조만 텍스트로 설명
+- 코드: 인터페이스/타입 정의만 유지, 구현 제거
+
+다중 문서 요약
+
+- 각 문서별 섹션 구분
+- 공통 정보는 "개요"에 통합
+- 문서별 고유 정보는 별도 섹션
+
+주의사항
+
+- 절대 추측하지 말 것: 명시되지 않은 정보는 포함하지 않음
+- 원문 충실성: 의미 변경 금지, 재해석 금지
+- 일관성: 용어, 형식, 구조의 일관성 유지
+- 검증 가능성: 요약의 모든 정보가 원문에서 추적 가능해야 함
+```