claude-pro-minmax 1.0.0

package/.claude/contexts/frontend-context.md

@@ -0,0 +1,24 @@
+# Frontend Context
+
+## Tech Stack
+- Framework: [Next.js/React]
+- State: [Zustand/TanStack Query]
+- Styling: [Tailwind]
+
+## Components
+| Component | Purpose |
+|-----------|---------|
+| AuthProvider | Auth state |
+| ProtectedRoute | Route guard |
+
+## Routes
+| Path | Component | Auth |
+|------|-----------|------|
+| / | Landing | No |
+| /dashboard | Dashboard | Yes |
+
+## API
+```typescript
+const API = process.env.NEXT_PUBLIC_API_URL
+headers: { Authorization: `Bearer ${token}` }
+```

package/.claude/rules/README.ko.md

@@ -0,0 +1,98 @@
+> **[English Version](README.md)**
+
+# Rules Directory
+
+## 목적
+Claude가 항상 따르는 규칙들을 포함합니다. 이 규칙들은 모든 세션에서 자동으로 로드됩니다.
+
+## 내용
+
+| 파일 | 목적 | 우선순위 |
+|------|---------|----------|
+| `critical-actions.md` | 위험한 명령어에 대한 HITL(Human-in-the-Loop) 확인 | 최상 |
+| `security.md` | 보안 모범 사례 | 상 |
+| `code-style.md` | 코드 컨벤션 | 중 |
+
+> **언어 설정:** `install.sh` 실행 시 출력 언어를 선택하거나, `~/.claude/rules/language.md`를 수동으로 생성하세요. 영어 사용자는 파일이 필요 없습니다 (기본값).
+
+## 중요 작업 (Critical Actions)
+
+가장 중요한 규칙 파일입니다. 다음을 정의합니다:
+
+1. **직접적인 위험 명령어:**
+   - `git push --force`
+   - `DROP TABLE`, `DELETE FROM` (WHERE 절 없음)
+   - 주요 디렉토리에 대한 `rm -rf`
+
+2. **간접적인 스크립트 감지:**
+   - `npm run clean`, `reset`, `nuke`
+   - `yarn db:reset`, `db:drop`
+
+3. **Git 충돌 처리:**
+   - 즉시 감지
+   - 사용자에게 이양 (자동 해결 금지)
+
+## 설계 결정
+
+| 결정 | 근거 |
+|------|------|
+| 규칙 파일에 frontmatter 없음 | `critical-actions.md`와 `security.md` 같은 규칙은 의도적으로 전역 적용. `paths` 제한 불필요 |
+| `critical-actions.md`를 순수 마크다운으로 | 훅 기반 차단(`~/.claude/scripts/hooks/critical-action-check.sh`)이 실제 강제를 담당. 규칙 파일은 Claude 이해를 위한 문서 |
+| `security.md`를 `critical-actions.md`에서 분리 | Critical actions = 위험 명령어 차단. Security = 코딩 모범 사례. 목적이 다름 |
+
+## 사용법
+
+규칙은 자동으로 로드됩니다. 별도의 명령어가 필요하지 않습니다.
+
+## 범위 지정 규칙 (고급)
+
+`paths` frontmatter를 사용하여 특정 파일에만 규칙을 제한할 수 있습니다. 모노레포나 여러 언어가 섞인 프로젝트에서 유용합니다.
+
+```markdown
+---
+paths:
+  - "src/api/**/*.ts"
+  - "lib/**/*.ts"
+---
+# API 규칙
+...
+```
+
+## 고급 구성
+
+- **서브디렉토리**: 규칙을 폴더별로 그룹화할 수 있습니다 (예: `rules/frontend/`, `rules/backend/`).
+- **심볼릭 링크 (Symlinks)**: 여러 프로젝트 간 일관성을 위해 공유 규칙 세트를 링크할 수 있습니다.
+
+## 커스텀 규칙 추가
+
+새로운 `.md` 파일을 생성하세요:
+
+```markdown
+---
+# 선택 사항: 특정 파일에만 적용
+paths:
+  - "**/*.ts"
+---
+
+# [Rule Name] Rules
+
+## 목적
+이 규칙이 강제하는 것.
+
+## 항상 할 것 (ALWAYS Do)
+- ...
+
+## 절대 하지 말 것 (NEVER Do)
+- ...
+```
+
+## 우선순위
+
+```
+~/.claude/rules/*.md          (사용자 레벨, 먼저 로드됨)
+./project/.claude/rules/*.md  (프로젝트 레벨, 사용자 규칙을 오버라이드)
+```
+
+프로젝트 규칙이 **더 높은 우선순위**를 가집니다. 프로젝트 규칙 파일이 사용자 규칙 파일과 동일한 이름(예: `code-style.md`)을 가진 경우, 프로젝트 버전이 사용자 버전을 완전히 대체합니다.
+
+프로젝트 규칙이 전역 규칙과 동일한 파일명을 가질 경우 전역 규칙을 오버라이드할 수 있습니다.

package/.claude/rules/README.md

@@ -0,0 +1,98 @@
+> **[한국어 버전](README.ko.md)**
+
+# Rules Directory
+
+## Purpose
+Contains always-loaded rules that Claude follows. These are loaded automatically on every session.
+
+## Contents
+
+| File | Purpose | Priority |
+|------|---------|----------|
+| `critical-actions.md` | HITL confirmation for dangerous commands | HIGHEST |
+| `security.md` | Security best practices | HIGH |
+| `code-style.md` | Code conventions | MEDIUM |
+
+> **Language setting:** Run `install.sh` to select your output language, or manually create `~/.claude/rules/language.md`. English users need no file (default).
+
+## Critical Actions
+
+The most important rule file. Defines:
+
+1. **Direct Dangerous Commands:**
+   - `git push --force`
+   - `DROP TABLE`, `DELETE FROM` (no WHERE)
+   - `rm -rf` on important directories
+
+2. **Indirect Script Detection:**
+   - `npm run clean`, `reset`, `nuke`
+   - `yarn db:reset`, `db:drop`
+
+3. **Git Conflict Handling:**
+   - Immediate detection
+   - Handoff to user (no auto-resolution)
+
+## Design Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| No frontmatter in rule files | Rules like `critical-actions.md` and `security.md` are intentionally global. No `paths` restriction needed |
+| `critical-actions.md` as plain markdown | Hook-based blocking (`~/.claude/scripts/hooks/critical-action-check.sh`) handles enforcement. Rule file is documentation for Claude's understanding |
+| Separate `security.md` from `critical-actions.md` | Critical actions = blocking dangerous commands. Security = coding best practices. Different purposes |
+
+## Usage
+
+Rules are loaded automatically. No explicit command needed.
+
+## Scope-Specific Rules (Advanced)
+
+You can restrict rules to specific files using the `paths` frontmatter. This is useful for monorepos or mixed-language projects.
+
+```markdown
+---
+paths:
+  - "src/api/**/*.ts"
+  - "lib/**/*.ts"
+---
+# API Rules
+...
+```
+
+## Advanced Organization
+
+- **Subdirectories**: Group rules into folders (e.g., `rules/frontend/`, `rules/backend/`).
+- **Symlinks**: Link to shared rule sets for consistency across projects.
+
+## Adding Custom Rules
+
+Create a new `.md` file:
+
+```markdown
+---
+# Optional: Apply only to specific files
+paths:
+  - "**/*.ts"
+---
+
+# [Rule Name] Rules
+
+## Purpose
+What this rule enforces.
+
+## ALWAYS Do
+- ...
+
+## NEVER Do
+- ...
+```
+
+## Precedence
+
+```
+~/.claude/rules/*.md          (User-level, loaded first)
+./project/.claude/rules/*.md  (Project-level, overrides user-level)
+```
+
+Project rules have **higher priority**. If a project rule file has the same name as a user rule file (e.g., `code-style.md`), the project version completely replaces the user version.
+
+Project rules can override global rules if they have the same filename.

package/.claude/rules/code-style.md

@@ -0,0 +1,21 @@
+# Code Style Rules
+
+## Files (Language-Agnostic)
+- Max 300 lines
+- One component/class per file
+- Consistent naming per language conventions
+
+## General Principles
+- Strict typing (TypeScript strict, Kotlin null-safety, Rust ownership)
+- No dynamic typing escapes (`any`, `Object`, `interface{}`)
+- Explicit return types where language supports
+
+## Functions/Methods
+- Max 50 lines
+- Single responsibility
+- Early returns / guard clauses
+- Meaningful names (verb + noun)
+
+## Formatting
+- Use `~/.claude/scripts/runtime/adapters/*.sh` → `adapter_format()`
+- Prettier (JS/TS), ktlint (Kotlin), gofmt (Go), rustfmt (Rust), black (Python)

package/.claude/rules/critical-actions.md

@@ -0,0 +1,34 @@
+# Critical Actions Rule
+
+## Direct Commands (Always Confirm)
+- git push --force, git reset --hard
+- DROP TABLE, DELETE FROM (no WHERE), TRUNCATE
+- rm -rf on important directories
+- Production deployments
+
+## Indirect Scripts (Warning)
+- npm/yarn run: clean, reset, nuke, purge
+- db:reset, db:drop, migrate:reset
+- deploy:prod, deploy:production
+
+## Git Conflicts
+On CONFLICT or <<<<<<< HEAD:
+1. STOP immediately
+2. List conflicting files
+3. Hand off to user
+4. NEVER attempt auto-resolution
+
+## Confirmation Flow
+```
+⚠️ CRITICAL ACTION DETECTED
+
+Action: [command]
+Risk: [description]
+
+Type 'CONFIRM' to proceed.
+```
+
+## Responses
+- CONFIRM: Proceed
+- SHOW: Display script
+- CANCEL: Abort

package/.claude/rules/security.md

@@ -0,0 +1,13 @@
+# Security Rules
+
+## NEVER
+- Hardcode secrets
+- Commit .env files
+- Use eval()
+- Trust unvalidated input
+
+## ALWAYS
+- Use environment variables
+- Validate all inputs
+- Use parameterized queries
+- Hash passwords (bcrypt, cost≥10)

package/.claude/sessions/2025-01-27-auth-jwt-refresh.md

@@ -0,0 +1,32 @@
+---
+session_id: example-session
+date: 2025-01-29 14:30
+name: auth-jwt-implementation
+project: pro-plan-v3-final
+---
+
+# Session: auth-jwt-implementation
+
+## Completed Tasks
+- [x] Created JWT utility class in `src/auth/jwt.ts`
+- [x] Implemented login endpoint with token generation
+- [x] Added refresh token rotation logic
+- [x] Wrote unit tests for token validation
+
+## Current State
+JWT authentication is fully implemented. Ready for integration testing.
+
+## Next Actions
+- [ ] Add rate limiting to login endpoint
+- [ ] Implement token blacklist for logout
+- [ ] Add integration tests with database
+
+## Context
+- Files: `src/auth/jwt.ts`, `src/auth/login.ts`, `tests/auth.test.ts`
+- Decisions: Using HS256 for simplicity, will migrate to RS256 for production
+
+## Loaded Contexts
+- backend: active
+
+## Learned Patterns
+- Always validate token expiry before processing

package/.claude/sessions/README.ko.md

@@ -0,0 +1,195 @@
+> **[English Version](README.md)**
+
+# Sessions Directory
+
+## 목적
+`/session-save`에 의해 생성된 세션 상태 파일을 저장합니다. 세션 간에 연속성을 가능하게 합니다.
+
+> **경로 안내:** 예시에는 설치 경로(`~/.claude/...`)가 포함됩니다. 이 저장소 기준 소스 경로는 `./.claude/...`, `./scripts/...`입니다.
+
+## 세션 생명주기
+
+```mermaid
+flowchart TB
+    %% 스타일 정의 %%
+    classDef command fill:#e8f5e9,stroke:#43a047,stroke-width:2px;
+    classDef file fill:#fff3e0,stroke:#fb8c00,stroke-width:2px;
+    classDef process fill:#e3f2fd,stroke:#1e88e5,stroke-width:2px;
+    classDef hook fill:#ffebee,stroke:#e53935,stroke-width:2px;
+    classDef builtin fill:#f3e5f5,stroke:#8e24aa,stroke-width:2px;
+    classDef note fill:#fffde7,stroke:#fdd835,stroke-width:1px,stroke-dasharray: 3 3;
+
+    %% 메인 세션 플로우 %%
+    Start((🚀 세션 시작)):::process
+    Start --> Work[🔨 작업 진행]:::process
+    
+    Work --> Decision{세션 저장?}:::process
+    Decision -->|Yes| SaveCmd[/"💾 /session-save auth-feature"/]:::command
+    Decision -->|No| Continue[작업 계속]:::process
+    Continue --> Work
+    
+    %% 저장 프로세스 %%
+    SaveCmd --> Collect["📋 상태 수집<br/>• 완료된 작업<br/>• 현재 상태<br/>• 다음 액션<br/>• 주요 파일"]:::process
+    Collect --> Scrub{{"🔐 scrub-secrets.js<br/>15+ 시크릿 패턴 제거"}}:::hook
+    Scrub --> Write["✍️ 파일 작성<br/>.claude/sessions/<br/>2025-01-28-auth-feature.md"]:::file
+    Write --> Notify["✅ 세션 저장 완료!<br/>스크러빙: N개 시크릿"]:::note
+    
+    %% 로드 프로세스 %%
+    Notify -.->|"나중에..."| LoadStart((📂 새 세션)):::process
+    LoadStart --> LoadCmd[/"📂 /session-load auth-feature"/]:::command
+    LoadCmd --> Read["📖 세션 파일 읽기"]:::process
+    Read --> Restore["🔄 컨텍스트 복원<br/>• 완료된 작업 설정<br/>• 다음 액션 로드<br/>• 주요 파일 참조"]:::process
+    Restore --> Ready["✅ 작업 재개 준비 완료!"]:::note
+    
+    %% 내장 CLI 대안 %%
+    subgraph BuiltInCLI["🔧 대안: 내장 CLI"]
+        direction TB
+        BuiltinNote["정확한 대화 재생용<br/>(사람이 읽을 수 있는 요약 아님)"]:::note
+        CLI1["claude -c / --continue<br/>→ 가장 최근 세션 재개"]:::builtin
+        CLI2["claude -r abc123 / --resume abc123<br/>→ 특정 세션 재개"]:::builtin
+        JSONL["~/.claude/projects/*.jsonl<br/>(원본 대화 기록)"]:::file
+        CLI1 --> JSONL
+        CLI2 --> JSONL
+    end
+```
+
+### 커스텀 vs 내장 세션
+
+| 기능 | `/session-save` + `/session-load` | `claude --continue` |
+|------|-----------------------------------|---------------------|
+| **형식** | 사람이 읽을 수 있는 `.md` | 원본 `.jsonl` |
+| **위치** | `.claude/sessions/` (프로젝트) | `~/.claude/projects/` (전역) |
+| **내용** | 요약 (작업, 결정, 다음 단계) | 전체 대화 기록 |
+| **시크릿 스크러빙** | ✅ 자동 | ❌ 스크러빙 없음 |
+| **적합한 용도** | 컨텍스트 공유, 문서화 | 정확한 대화 재생 |
+
+### 언제 무엇을 사용할까?
+
+| 상황 | 추천 | 이유 |
+|------|------|------|
+| 짧은 휴식 후 재개 (같은 날) | `claude -c` | 빠르고 정확한 대화 이어가기 |
+| 긴 휴식 후 재개 (다음 날) | `/session-load` | 핵심 컨텍스트만 로드, 비용 절약 |
+| 팀원과 컨텍스트 공유 | `/session-save` | 사람이 읽을 수 있는 `.md` 공유 가능 |
+| 시크릿 포함한 작업 후 | `/session-save` | 자동 스크러빙으로 안전 |
+| 정확한 대화 기록 필요 | `claude --resume` | 전체 대화 그대로 복원 |
+
+### 추천 워크플로우
+
+```
+📅 1일차 오전: 새 작업 시작
+📅 1일차 오후: 점심 후 → claude -c (내장 CLI로 빠른 재개)
+📅 1일차 저녁: /session-save feature-v1 (작업 요약 저장)
+
+📅 2일차: /session-load feature-v1 (깔끔한 컨텍스트로 시작)
+📅 2일차 오후: claude -c (같은 날 빠른 재개)
+📅 2일차 저녁: /session-save feature-v2 (진행 상황 저장)
+```
+
+> **💡 Tip**: 둘은 **경쟁이 아니라 보완 관계**입니다. 상황에 맞게 골라 쓰세요!
+
+## 파일 명명
+
+```
+YYYY-MM-DD-[name].md
+```
+
+예시:
+- `2025-01-27-auth-jwt.md`
+- `2025-01-27-payment-integration.md`
+
+## 보안
+
+**모든 세션 파일은 기록되기 전에 자동으로 스크러빙(민감 정보 제거)됩니다.**
+
+스크러빙되는 패턴:
+- API 키 (OpenAI, Anthropic, Stripe, GitHub, AWS)
+- 자격 증명이 포함된 데이터베이스 URL
+- JWT 토큰
+- 비밀번호 필드
+- 개인 키 (Private keys)
+
+## 사용법
+
+```bash
+# 현재 세션 저장
+/session-save auth-feature
+
+# 가장 최근 세션 로드
+/session-load
+
+# 특정 세션 로드
+/session-load auth-feature
+
+# 사용 가능한 세션 목록
+/session-load --list
+```
+
+## 세션 파일 형식
+
+```markdown
+# Session: [name]
+Date: [timestamp]
+Duration: [messages]
+Security: [items scrubbed]
+
+## Context
+- Project: [name]
+- Branch: [branch]
+- Focus: [description]
+
+## Completed
+- [x] [task]
+
+## In Progress
+- [ ] [task] - [status]
+
+## Decisions Made
+- [decision]: [reasoning]
+
+## Next Steps
+1. [action]
+
+## Key Files
+- [file]: [why relevant]
+
+## Loaded Contexts
+- [type]: [status]
+
+## Learned Patterns
+- [pattern]
+```
+
+## 유지 관리
+
+```bash
+# 세션 목록 조회
+ls -la .claude/sessions/
+
+# 오래된 세션 삭제 (>30일)
+find .claude/sessions/ -mtime +30 -delete
+
+# 수동 스크러빙 (필요한 경우)
+node scripts/scrub-secrets.js < session.md > clean.md
+# 설치 경로: node ~/.claude/scripts/scrub-secrets.js < session.md > clean.md
+```
+
+## Claude 내장 세션 명령어
+
+커스텀 `/session-save`, `/session-load` 외에도 Claude Code 내장 세션 기능이 있습니다:
+
+| 명령어 | 목적 |
+|--------|------|
+| `claude -c` / `--continue` | 가장 최근 세션 재개 |
+| `claude -r "id"` / `--resume "id"` | 특정 세션 ID로 재개 |
+| `claude --resume` | 최근 세션 목록에서 선택 |
+
+> **참고:** 내장 세션은 `~/.claude/projects/.../*.jsonl`에 저장됩니다. 커스텀 `/session-save`는 `.claude/sessions/`에 사람이 읽을 수 있는 `.md` 요약을 생성합니다.
+
+## 모범 사례
+
+1. 논리적 단계가 완료된 후 저장
+2. 긴 휴식 전 (>4시간) 저장
+3. 설명적인 이름 사용
+4. 주기적으로 오래된 세션 정리
+5. **스크립트 실행 권한 확인**: `chmod +x scripts/hooks/*.sh`  
+   (설치 경로: `chmod +x ~/.claude/scripts/hooks/*.sh`)