claude-pro-minmax 1.3.0 → 1.4.0

package/.claude/CLAUDE.md

@@ -49,7 +49,8 @@ Pro Plan constraints. Every message = quota. Optimize for Pass@1.
 | Implementation | @builder | Haiku | None → Escalate |
 | Quality Review | @reviewer | Haiku | None → Escalate |
 
-@dplanner tools: `sequential-thinking`, `perplexity`, `context7`
+@dplanner tools: `sequential-thinking`, `perplexity`, `Read`, `Glob`, `Grep`
+Current library docs can be handled by the official Context7 Claude Code integration when installed.
 
 ## DEFAULT WORKFLOW
 - Simple (1-3 files): `/do` — batch plan+build+verify in one shot

package/.claude/agents/README.ko.md

@@ -12,7 +12,7 @@
 | 에이전트 | 모델 | 역할 | 도구 | 질문 |
 |---------|------|------|------|------|
 | `planner.md` | Sonnet 4.6 | 아키텍처 및 설계 결정 | Read, Glob, Grep (읽기 전용) | ≤3 (기본값 포함) |
-| `dplanner.md` | Sonnet 4.6 | 연구 기반 심층 계획 | sequential-thinking, perplexity, context7, Read, Glob, Grep | 무제한 |
+| `dplanner.md` | Sonnet 4.6 | 연구 기반 심층 계획 | sequential-thinking, perplexity, Read, Glob, Grep | 무제한 |
 | `builder.md` | Haiku 4.5 | 구현 (2-retry cap) | Read, Write, Edit, Bash, Glob, Grep | 없음 → 에스컬레이션 |
 | `reviewer.md` | Haiku 4.5 | 코드 검토 및 QA | Read, Glob, Grep (읽기 전용, 강제) | 없음 → 에스컬레이션 |
 
@@ -42,7 +42,7 @@
 **기능:**
 - `sequential-thinking`: 다단계 논리 검증
 - `perplexity`: 웹 연구 (블로그, 포럼, 최신 아티클)
-- `context7`: 라이브러리 문서 조회
+- 설치된 공식 Context7 Claude Code 통합을 통한 최신 라이브러리 문서 조회
 
 **출력 예산:** 최대 60줄 (코드 블록 제외). 출처 + 출처당 1줄 인사이트만.
 
@@ -154,7 +154,7 @@ flowchart TD
 | @planner와 @dplanner에 Sonnet 4.6 사용 | 아키텍처 결정은 추론 능력 필요. Pro Plan에서 Sonnet 4.6가 Opus 4.6보다 가성비 우수 |
 | @builder 2-retry cap | Quota 소진 방지. 2회 실패 → Sonnet 4.6/Opus 4.6으로 에스컬레이션 또는 @planner로 재설계 |
 | @reviewer 읽기 전용 강제 | Hook 기반 차단(`readonly-check.sh`). 검토 중 실수로 수정하는 것 방지 |
-| @dplanner에 MCP 도구 제공 | 연구가 많은 작업은 MCP 오버헤드 정당화 가능. `sequential-thinking` + `perplexity` + `context7`로 실패 없는 계획 가능 |
+| @dplanner에 연구 도구 + 공식 문서 통합 제공 | 연구가 많은 작업은 더 깊은 계획이 필요합니다. `sequential-thinking` + `perplexity`로 추론과 웹 조사를 처리하고, 최신 라이브러리 문서는 공식 Context7이 설치된 경우 사용할 수 있습니다 |
 | 에이전트별 출력 예산 | Output은 Input의 5배 비용 (API 가격). 엄격한 예산: builder 5줄, reviewer 1줄 PASS / 30줄 FAIL, dplanner 60줄, planner 1문장/작업 |
 | @builder 원자적 롤백 | `~/.claude/scripts/snapshot.sh`가 depth guard + 라벨 확인 포함 `git stash` 처리. 무관한 사용자 stash pop 방지. 실패 시 `pop` (또는 clean tree에서 `git checkout .`) → 즉시 에스컬레이션 가능한 깨끗한 상태. 실패당 2-4 메시지 절약은 추정치이며, API 비용은 0 |
 

package/.claude/agents/README.md

@@ -12,7 +12,7 @@ Contains sub-agent definitions for role-based task delegation with model optimiz
 | Agent | Model | Role | Tools | Questions |
 |-------|-------|------|-------|-----------|
 | `planner.md` | Sonnet 4.6 | Architecture & design decisions | Read, Glob, Grep (read-only) | ≤3 (with defaults) |
-| `dplanner.md` | Sonnet 4.6 | Deep planning with research | sequential-thinking, perplexity, context7, Read, Glob, Grep | Unlimited |
+| `dplanner.md` | Sonnet 4.6 | Deep planning with research | sequential-thinking, perplexity, Read, Glob, Grep | Unlimited |
 | `builder.md` | Haiku 4.5 | Implementation (2-retry cap) | Read, Write, Edit, Bash, Glob, Grep | None → Escalate |
 | `reviewer.md` | Haiku 4.5 | Code review & QA | Read, Glob, Grep (read-only, enforced) | None → Escalate |
 
@@ -42,7 +42,7 @@ Contains sub-agent definitions for role-based task delegation with model optimiz
 **Capabilities:**
 - `sequential-thinking`: Multi-step logic verification
 - `perplexity`: Web research (blogs, forums, latest articles)
-- `context7`: Library documentation lookup
+- Current library docs via the official Context7 Claude Code integration when installed
 
 **Output Budget:** Max 60 lines (code blocks excluded). Cite source + 1-line insight per source.
 
@@ -154,7 +154,7 @@ flowchart TD
 | Sonnet 4.6 for @planner and @dplanner | Architecture decisions need reasoning capability. Sonnet 4.6 balances cost/performance better than Opus 4.6 on Pro Plan |
 | @builder 2-retry cap | Prevents quota drain. Failed twice → Escalate to Sonnet 4.6/Opus 4.6 or @planner for re-design |
 | @reviewer read-only enforcement | Hook-based blocking (`readonly-check.sh`). Prevents accidental modifications during review |
-| @dplanner with MCP tools | Research-heavy tasks justify MCP overhead. `sequential-thinking` + `perplexity` + `context7` enable fail-proof planning |
+| @dplanner with research tools + official docs integration | Research-heavy tasks justify deeper planning. `sequential-thinking` + `perplexity` cover reasoning and web research, while current library docs can use official Context7 when installed |
 | Output Budget per agent | Output costs 5x Input (API pricing). Strict budgets: builder 5 lines, reviewer 1 line PASS / 30 lines FAIL, dplanner 60 lines, planner 1 sentence/task |
 | @builder atomic rollback | `~/.claude/scripts/snapshot.sh` handles `git stash` with depth guard + label check before `/do` execution. Prevents popping unrelated user stashes. Failure triggers `pop` (or `git checkout .` on clean tree) → clean state for immediate escalation. Estimated savings: 2-4 messages per failure, zero API cost |
 

package/.claude/agents/dplanner.md

@@ -1,9 +1,9 @@
 ---
 name: dplanner
-description: Deep Planner - Architecture specialist with extended thinking and research capabilities. Use for high-complexity architectural design.
+description: Deep Planner - Architecture specialist with extended thinking and research capabilities. Use for high-complexity architectural design and deep research.
 model: sonnet
 permissionMode: plan
-tools: sequential-thinking, perplexity, context7, Read, Glob, Grep
+tools: sequential-thinking, perplexity, Read, Glob, Grep
 disallowedTools: Write, Edit, Bash
 ---
 
@@ -15,7 +15,7 @@ You prioritize **Correctness** and **Completeness** over speed.
 ## Core Capabilities
 1.  **Sequential Thinking**: Use `sequential-thinking` to break down complex logic into verified steps.
 2.  **Web Research**: Use `perplexity` for comprehensive web research (blogs, forums, latest articles).
-3.  **Documentation Lookup**: Use `context7` to fetch full documentation for libraries.
+3.  **Documentation Lookup**: When current library docs are needed, use the official Context7 Claude Code integration if it is installed.
 
 ## When to Use
 - Designing large-scale refactoring.
@@ -25,7 +25,7 @@ You prioritize **Correctness** and **Completeness** over speed.
 ## Workflow
 1.  **Analyze**: Break down the user request.
 2.  **Think**: Use `sequential-thinking` to formulate a hypothesis or plan.
-3.  **Research**: Use `perplexity` for web research, `context7` for library docs.
+3.  **Research**: Use `perplexity` for web research, and use official Context7 when current library docs are required.
 4.  **Verify**: Cross-check your plan against constraints.
 5.  **Output**: Deliver a comprehensive, fail-proof plan.
 
@@ -38,7 +38,7 @@ You prioritize **Correctness** and **Completeness** over speed.
 - Validated Logic: ...
 
 ### 2. Research Findings
-- Source: [Context7/Docs]
+- Source: [Official docs via Context7 or web]
 - Key Insight: ...
 
 ### 3. Architecture Design
@@ -52,6 +52,7 @@ You prioritize **Correctness** and **Completeness** over speed.
 ## Rules
 - **DO NOT** guess. Verify everything.
 - **DO NOT** write code. That is for @builder.
+- Keep official Context7 command details out of this prompt; use installed integration behavior or official docs instead.
 - Use `sequential-thinking` for any logic deeper than 2 levels.
 - Maximum 60 lines output (code blocks excluded from count)
 - Research Findings: cite source + 1-line insight per source (no long quotes)

package/.claude/commands/README.ko.md

@@ -15,7 +15,7 @@
 | `do-sonnet.md` | Sonnet으로 실행 | context: fork, model: sonnet |
 | `do-opus.md` | Opus로 실행 | context: fork, model: opus |
 | `plan.md` | 복잡한 작업 | @planner → @builder 체인 |
-| `dplan.md` | 심층 계획 | @dplanner (Sequential Thinking + Perplexity + Context7) |
+| `dplan.md` | 심층 계획 | @dplanner (Sequential Thinking + Perplexity + 공식 Context7 설치 시) |
 | `review.md` | 코드 검토 | 읽기 전용, 카테고리 |
 | `learn.md` | 패턴 캡처 | 자동 추출 또는 명시적 지정 |
 | `session-save.md` | 상태 저장 | 비밀 정보 삭제 |
@@ -23,7 +23,7 @@
 | `load-context.md` | 컨텍스트 로드 | Read tool, 비용 경제 |
 | `compact-phase.md` | 전략적 축소 | 단계 인식 가지치기 |
 | `watch.md` | tmux 모니터링 | 메시지 비용 없음 |
-| `llms-txt.md` | LLM 최적화 문서 | URL에서 /llms.txt 조회 |
+| `llms-txt.md` | LLM 최적화 문서 | URL에서 raw /llms.txt 조회 |
 | `analyze-failures.md` | 도구 오류 분석 | 하이브리드 학습 (로그 + 분석) |
 
 ## 명령어 카테고리
@@ -64,7 +64,7 @@
 | 명령어 | 사용 시점 | 리소스 사용량 |
 |---------|-------------|--------------|
 | `/watch` | 장기 실행 프로세스 모니터링 | 로컬 tmux (API 사용 안 함) |
-| `/llms-txt` | LLM 최적화 문서 조회 | 최소 (WebFetch) |
+| `/llms-txt` | raw LLM 최적화 문서 조회 | 최소 (WebFetch) |
 
 ## 워크플로우 예시
 
@@ -102,7 +102,7 @@
 # 3. 연구 결과를 바탕으로 구현
 # (복잡도에 따라 /plan 또는 /do 사용)
 ```
-**Quota:** 높음 (Sonnet 4.6 + Sequential Thinking + Perplexity + Context7)
+**Quota:** 높음 (Sonnet 4.6 + Sequential Thinking + Perplexity + 공식 Context7 설치 시)
 
 ### 디버깅 및 학습
 ```bash
@@ -144,7 +144,7 @@
 | **사용 사례** | 간단한 작업 | 복잡한 로직 | 중요한 결정 | 다중 파일 기능 | 미지의 영역 |
 | **영향받는 파일** | 1-3 | 1-3 | 제한없음 | 5+ | 제한없음 |
 | **질문** | 불가 | 불가 | 불가 | ≤3 (기본값 포함) | 무제한 |
-| **연구 도구** | 불가 | 불가 | 불가 | 불가 | 가능 (Perplexity, Context7) |
+| **연구 도구** | 불가 | 불가 | 불가 | 불가 | 가능 (Perplexity + 공식 Context7 설치 시) |
 
 **결정 트리:**
 ```

package/.claude/commands/README.md

@@ -15,7 +15,7 @@ Contains slash command definitions for common workflows.
 | `do-sonnet.md` | Execute with Sonnet | context: fork, model: sonnet |
 | `do-opus.md` | Execute with Opus | context: fork, model: opus |
 | `plan.md` | Complex tasks | @planner → @builder chain |
-| `dplan.md` | Deep Planning | @dplanner (Sequential Thinking + Perplexity + Context7) |
+| `dplan.md` | Deep Planning | @dplanner (Sequential Thinking + Perplexity + official Context7 when installed) |
 | `review.md` | Code review | Read-only, categories |
 | `learn.md` | Capture patterns | Auto-extract or explicit |
 | `session-save.md` | Save state | Secret scrubbing |
@@ -23,7 +23,7 @@ Contains slash command definitions for common workflows.
 | `load-context.md` | Load context | Read tool, cost economy |
 | `compact-phase.md` | Strategic compact | Phase-aware pruning |
 | `watch.md` | tmux monitoring | Zero message cost |
-| `llms-txt.md` | LLM Documentation | Fetch /llms.txt from URLs |
+| `llms-txt.md` | LLM Documentation | Fetch raw /llms.txt from URLs |
 | `analyze-failures.md` | Analyze tool errors | Hybrid learning (log + analyze) |
 
 ## Command Categories
@@ -64,7 +64,7 @@ Contains slash command definitions for common workflows.
 | Command | When to Use | Resource Usage |
 |---------|-------------|----------------|
 | `/watch` | Monitor long-running processes | Local tmux (zero API usage) |
-| `/llms-txt` | Fetch LLM-optimized documentation | Minimal (WebFetch) |
+| `/llms-txt` | Fetch raw LLM-optimized documentation | Minimal (WebFetch) |
 
 ## Workflow Examples
 
@@ -102,7 +102,7 @@ Contains slash command definitions for common workflows.
 # 3. Implement based on research findings
 # (Use /plan or /do based on complexity)
 ```
-**Quota:** High (Sonnet 4.6 + Sequential Thinking + Perplexity + Context7)
+**Quota:** High (Sonnet 4.6 + Sequential Thinking + Perplexity + official Context7 when installed)
 
 ### Debugging & Learning
 ```bash
@@ -144,7 +144,7 @@ Contains slash command definitions for common workflows.
 | **Use Case** | Simple tasks | Complex logic | Critical decisions | Multi-file features | Unknown unknowns |
 | **Files Affected** | 1-3 | 1-3 | Any | 5+ | Any |
 | **Questions** | No | No | No | ≤3 (with defaults) | Unlimited |
-| **Research Tools** | No | No | No | No | Yes (Perplexity, Context7) |
+| **Research Tools** | No | No | No | No | Yes (Perplexity + official Context7 when installed) |
 
 **Decision Tree:**
 ```

package/.claude/commands/dplan.md

@@ -1,6 +1,6 @@
 ---
 name: dplan
-description: Deep planning with @dplanner. Use for extremely complex tasks requiring Sequential Thinking, Perplexity research, and Context7 documentation.
+description: Deep planning with @dplanner. Use for extremely complex tasks requiring Sequential Thinking, Perplexity research, and current official library docs lookup when Context7 is installed.
 argument-hint: [complex feature description]
 context: fork
 agent: dplanner
@@ -12,7 +12,7 @@ agent: dplanner
 
 ## Purpose
 Invokes the **Deep Planner** for high-complexity architectural design and research.
-Unlike `/plan`, this command utilizes `sequential-thinking`, `perplexity`, and `context7` for maximum depth.
+Unlike `/plan`, this command utilizes `sequential-thinking`, `perplexity`, and official Context7 for current library docs when it is installed.
 
 ## Arguments
 $ARGUMENTS
@@ -23,7 +23,7 @@ $ARGUMENTS
    - Analyzes request.
    - Uses Sequential Thinking for logic verification.
    - Uses Perplexity for web research.
-   - Uses Context7 for library documentation.
+   - Uses official Context7 when current library documentation is needed.
    - Produces a comprehensive "Deep Plan".
 3. Returns plan to main conversation.
 

package/.claude/commands/llms-txt.md

@@ -1,6 +1,6 @@
 ---
 name: llms-txt
-description: Fetch llms.txt documentation for a library. Use when Context7 doesn't cover a library.
+description: Fetch raw llms.txt documentation for a library or direct URL. Use when you explicitly want raw /llms.txt content or when official Context7 is unavailable.
 argument-hint: nextjs | prisma | supabase | [custom-url]
 allowed-tools: Bash(curl:*)
 ---
@@ -38,9 +38,9 @@ curl -s https://nextjs.org/llms.txt | head -200
 ```
 
 ## When to Use
-- Context7 MCP가 해당 라이브러리를 찾지 못할 때
-- 빠른 원샷 문법 확인이 필요할 때
-- 최신 API 문서가 필요할 때
+- You explicitly want the raw `/llms.txt` file
+- You want a direct URL-based docs fetch
+- You need a quick one-shot raw-doc pull instead of official Context7
 
 ## Examples
 ```

package/.claude/skills/README.ko.md

@@ -28,7 +28,7 @@ skills/
 
 | 스킬 | 용도 | 주요 이점 |
 | :--- | :--- | :--- |
-| `cli-wrappers` | 무거운 MCP 서버를 가벼운 CLI 패턴으로 대체 | 출력을 상당히 줄임 |
+| `cli-patterns` | 무거운 MCP 서버를 가벼운 CLI 패턴으로 대체 | 출력을 상당히 줄임 |
 | `learned` | `/learn` 명령어를 통해 학습된 패턴 저장 | 재작업 및 반복 질문 방지 |
 
 ## 커스텀 스킬 추가 방법
@@ -57,4 +57,4 @@ Claude는 아래 조건이 충족될 때만 `read_file` 도구를 사용하여
 ## 권장 사항
 1. **50줄 규칙**: `SKILL.md`가 50줄을 넘어가면 세부 내용을 `references/`로 옮기세요.
 2. **명시적 트리거**: **"Claude는 반드시 ...을 로드해야 합니다"**와 같은 강조 문구를 사용하여 모델이 패턴을 따르게 하세요.
-3. **상대 경로**: 도구 실행 실패를 방지하기 위해 항상 프로젝트 루트부터의 전체 경로(`.claude/skills/...`)를 제공하세요.
+3. **상대 경로**: 도구 실행 실패를 방지하기 위해 항상 프로젝트 루트부터의 전체 경로(`.claude/skills/...`)를 제공하세요.

package/.claude/skills/README.md

@@ -28,7 +28,7 @@ Instead of loading extensive documentation every time, Claude starts with only t
 
 | Skill | Purpose | Key Benefit |
 | :--- | :--- | :--- |
-| `cli-wrappers` | Replaces heavy MCP servers with slim CLI patterns. | Significantly reduces output tokens. |
+| `cli-patterns` | Replaces heavy MCP servers with slim CLI patterns. | Significantly reduces output tokens. |
 | `learned` | Stores project-specific patterns via `/learn`. | Prevents rework & repeat questions. |
 
 ## Adding a Custom Skill
@@ -57,4 +57,4 @@ Contains the heavy stuff: Full API docs, long code examples, error message table
 ## Best Practices
 1. **The 50-Line Rule**: If `SKILL.md` exceeds 50 lines, move details to `references/`.
 2. **Explicit Triggers**: Use bold text like **"Claude MUST load..."** to ensure the model follows the pattern.
-3. **Relative Paths**: Always provide the full path from the project root (e.g., `.claude/skills/...`) to avoid tool failures.
+3. **Relative Paths**: Always provide the full path from the project root (e.g., `.claude/skills/...`) to avoid tool failures.

package/.claude/skills/{cli-wrappers → cli-patterns}/SKILL.md

@@ -1,12 +1,13 @@
 ---
-name: cli-wrappers
-description: Use CLI tools instead of MCP to reduce cost. Provides JSON output patterns for gh, mgrep, psql, etc.
+name: cli-patterns
+description: Use token-efficient CLI patterns instead of verbose MCP output when direct shell tools are enough. Provides JSON or compact-output conventions for gh, mgrep, psql, and similar tools.
 ---
 
-# CLI Wrappers Skill
+# CLI Patterns Skill
 
 ## Purpose
-Replace MCPs with CLI. ALWAYS use JSON output + jq.
+Prefer compact, stable CLI output over verbose MCP output when direct shell tools are enough.
+Use JSON + jq when a tool supports it, and otherwise use the smallest practical text or CSV output mode.
 
 ## GitHub (gh)
 ```bash

package/.claude.json

@@ -7,13 +7,6 @@
                 "@modelcontextprotocol/server-sequential-thinking"
             ]
         },
-        "context7": {
-            "command": "npx",
-            "args": [
-                "-y",
-                "@upstash/context7-mcp"
-            ]
-        },
         "_perplexity_disabled_by_default": {
             "command": "npx",
             "args": [
@@ -25,4 +18,4 @@
             }
         }
     }
-}
+}

package/README.ko.md

@@ -16,14 +16,14 @@ CPMM은 모델 라우팅, 출력 제어, 로컬 안전장치로 리셋 전까지
 
 > **설치 완료했다면 여기서 시작하세요: [사용자 가이드](docs/USER-MANUAL.ko.md)**
 >
-> **New in v1.3.0:** Bash-heavy 출력 축약을 위한 RTK 선택 통합.
+> **New in v1.4.0:** `cpmm setup`에서 `ctx7` 전역 설치 후 공식 Context7 Claude Code 설정까지 opt-in으로 실행할 수 있고, `/llms-txt`는 explicit raw-doc fallback으로 유지됩니다.
 
 ---
 
 > [!TIP]
 > **🚀 3초 요약: 왜 이걸 써야 하나요?**
 > 1.  **배치 실행:** `/do`로 구현-검증을 한 흐름에서 처리하고, 필요할 때만 `/do-sonnet`/`/do-opus`로 승격합니다.
-> 2.  **출력 비용 제어:** 응답 예산, CLI 필터링, 그리고 optional RTK로 Bash-heavy 출력량을 줄입니다.
+> 2.  **출력 비용 제어:** 응답 예산, CLI 필터링, 그리고 optional RTK로 Bash 출력이 Claude 입력 컨텍스트를 불필요하게 키우지 않도록 합니다.
 > 3.  **로컬 안전장치:** 로컬 Hook + 원자적 롤백으로 실패 시 빠르게 복구합니다.
 
 ---
@@ -52,22 +52,38 @@ cpmm setup
 cpmm doctor
 ```
 
-> **v1.3.0 참고:** `cpmm setup`은 지원 환경에서 RTK 설치를 시도합니다. RTK 활성화는 여전히 opt-in입니다.
+### 4. 선택: 최신 라이브러리 문서 설정
+
+이제 interactive `cpmm setup`에서 권장 Context7 경로 전체를 opt-in으로 실행할 수 있습니다.
+
+공식 수동 설정 경로:
+```bash
+npm install -g ctx7
+ctx7 setup --cli --claude
+```
+
+- CPMM은 Context7를 기본 MCP 경로로 취급하지 않습니다.
+- 공식 설정 후에는 Context7의 공식 문서 통합이 최신 라이브러리 문서 조회를 처리합니다.
+- `/llms-txt`는 raw `/llms.txt` 내용이나 URL 기반 raw-doc 조회가 필요할 때만 사용하세요.
+
+> **v1.4.0 참고:** `cpmm setup`은 지원 환경에서 RTK 설치를 계속 시도합니다. RTK 활성화는 여전히 opt-in이며, Context7 opt-in은 `ctx7` 전역 설치와 공식 Claude Code 설정을 함께 진행합니다.
 
 의존성 정책:
 - `required`: `jq`, `mgrep`, `tmux`
+- `optional` (interactive opt-in): `ctx7` + 공식 Context7 Claude 통합
 - `optional` (자동 설치 시도): `rtk`
 - `optional` (확인만): `claude` (사전 설치 가정)
 - 도구별 자동 설치 경로:
   - `mgrep`: `npm`
+  - `ctx7`: `npm` + `ctx7 setup --cli --claude` (`cpmm setup`에서 interactive opt-in)
   - `rtk`: `brew` 또는 upstream `curl` installer
   - `jq`, `tmux`: `brew` (macOS) 또는 Linux 패키지 매니저 `apt-get`, `dnf`, `pacman`, `apk`
 - macOS에서 Homebrew가 없으면 설치 명령을 안내합니다
 
-### 4. 커스텀 & 업데이트 정책
+### 5. 커스텀 & 업데이트 정책
 
-- `cpmm setup`은 누락된 의존성을 설치한 뒤, CPMM 설정(설정 파일 복사, 언어 선택, Perplexity 설정)까지 진행합니다.
-- `cpmm doctor`는 수정 없이 의존성 상태와 RTK hook 상태를 확인합니다.
+- `cpmm setup`은 누락된 의존성을 설치한 뒤, CPMM 설정(설정 파일 복사, 언어 선택, Perplexity 설정, optional `ctx7` 설치 + 공식 Context7 설정, managed config 정리)까지 진행합니다.
+- `cpmm doctor`는 수정 없이 의존성 상태, Context7 상태, RTK hook 상태를 확인합니다.
 - 재실행 시 CPMM 관리 파일은 최신 버전으로 교체되고, 사용자 데이터는 보존됩니다.
 
 ```text
@@ -76,7 +92,7 @@ cpmm doctor
   ├── commands/          🔄 업데이트 시 교체됨
   ├── contexts/          🔄 업데이트 시 교체됨
   ├── scripts/           🔄 업데이트 시 교체됨
-  ├── skills/cli-wrappers/ 🔄 업데이트 시 교체됨
+  ├── skills/cli-patterns/ 🔄 업데이트 시 교체됨
   ├── rules/*.md         🔄 업데이트 시 교체됨
   ├── settings.json      🔄 업데이트 시 교체됨
   ├── settings.local.json  ✋ 사용자 소유 — 보존됨
@@ -98,16 +114,66 @@ cpmm doctor
 > 1. 글로벌 커스텀은 일반적으로 `settings.local.json`에 둡니다. `settings.json`은 CPMM 관리 대상이라 업데이트 시 덮어쓰기되므로, RTK 같은 third-party hook을 여기에 넣었다면 업데이트 후 다시 확인해야 합니다.
 > 2. 커스텀 명령어/규칙은 프로젝트 `.claude/`에 — 글로벌 `commands/`는 CPMM이 관리합니다.
 
+관리 설정 경계:
+- `~/.claude.json`은 CPMM 관리 대상이며 업데이트 시 정리될 수 있습니다.
+- regular file `~/.mcp.json`은 사용자 소유라 CPMM이 자동 수정하지 않습니다.
+- symlink `~/.mcp.json`은 CPMM 관리 호환 경로로 취급합니다.
+
 프로젝트 초기화 팁:
 - `claude` 실행 전에 `project-templates/`를 참고해 프로젝트를 초기화하세요. (설치기는 `project-templates`를 `~/.claude`로 복사하지 않습니다.)
 
-### 5. 고급 (선택)
+### 6. Bash 명령 출력 필터링 (RTK)
+
+RTK는 CPMM이 지원하는 **선택적 Bash 명령 출력 필터링 계층**입니다. `cpmm setup`은 RTK 바이너리 설치를 시도하지만, RTK hook은 기본 활성화하지 않습니다.
+
+RTK를 이번 릴리스에 선택 통합으로 넣은 이유는, Bash-heavy 워크플로우에서 긴 명령 출력이 Claude 입력 컨텍스트로 다시 들어가기 전에 이를 줄여 주기 때문입니다. CPMM은 권장 hook 순서를 문서화하고 `cpmm doctor`로 점검하며, 그 순서에서는 CPMM의 critical-action check가 RTK rewrite hook보다 먼저 실행되어야 합니다. 다만 hook 동작을 예측 가능하고 디버깅 가능하게 유지하기 위해 default-on이 아니라 opt-in으로 제공합니다.
+
+권장 opt-in 절차:
+
+```bash
+rtk init -g --hook-only
+# RTK를 켠 뒤에는 cpmm setup이 관리된 hook 순서와 timeout을 복원
+cpmm setup
+cpmm doctor
+```
+
+권장 `PreToolUse` 순서 (`~/.claude/settings.json`):
+- 먼저 CPMM safety hook: `~/.claude/scripts/hooks/critical-action-check.sh` with `timeout: 5`
+- 그 다음 RTK rewrite hook: `~/.claude/hooks/rtk-rewrite.sh` with `timeout: 10`
+
+업데이트 참고:
+- `cpmm setup`은 업데이트 시 `~/.claude/settings.json`을 다시 씁니다.
+- `cpmm setup` 전에 RTK가 이미 켜져 있었다면, CPMM이 설정 재작성 뒤에 관리된 RTK hook 순서와 `timeout: 10`을 자동 복원합니다.
+- 관리된 RTK 상태를 확인하려면 setup 뒤에 `cpmm doctor`를 실행하세요.
+
+권장 검증:
+- `/hooks`에서 CPMM hook과 RTK hook이 모두 로드되는지 확인
+- 위험 명령이 여전히 CPMM에서 먼저 차단되는지 확인
+- `cpmm doctor` 실행
+- 실제 Bash-heavy 세션 후 `rtk gain --quota --tier pro` 확인
+
+공개된 [RTK 통합 사용자 사례](https://github.com/move-hoon/claude-pro-minmax/issues/3)에서는 `rtk gain --quota --tier pro` 기준으로 Bash-heavy 워크플로우에서 `1,664`개 명령 동안 입력 토큰 `8.5M` 절감(`49.4%`)이 보고되었습니다. 절감률은 작업 부하와 세션 형태에 따라 달라질 수 있습니다.
+
+롤백:
+
+```bash
+rtk init -g --uninstall
+```
+
+### 7. 고급 (선택)
 <details>
 <summary>Perplexity, 언어, 수동 설치 보기</summary>
 
-**Perplexity/언어 설정 (필수 아님):**
-- Perplexity는 `/dplan`의 웹 리서치에 사용됩니다. 설정하지 않아도 `/dplan`은 Sequential Thinking + Context7으로 동작하며, 나머지 모든 기능은 Perplexity와 무관합니다.
+**Perplexity/언어/Context7 설정 (필수 아님):**
+- Perplexity는 `/dplan`의 웹 리서치에 사용됩니다. 설정하지 않아도 `/dplan`은 Sequential Thinking으로 동작하고, 최신 라이브러리 문서는 공식 Context7이 설치된 경우 사용할 수 있습니다. 나머지 모든 기능은 Perplexity와 무관합니다.
 - 최초 인터랙티브 설치 시 `cpmm setup`이 출력 언어와 Perplexity API 키를 묻습니다.
+- `cpmm setup`은 `ctx7` 전역 설치 후 공식 Context7 Claude Code 설정까지 optional 단계로 제안할 수 있습니다.
+- 수동 검증:
+  ```bash
+  command -v ctx7
+  ctx7 --version
+  cpmm doctor
+  ```
 - 영어(기본): 파일이 필요 없습니다. `~/.claude/rules/language.md`가 있으면 삭제하세요.
 - 비영어: `~/.claude/rules/language.md`를 만들어 원하는 언어를 지정하세요.
 - Perplexity를 수동으로 설정하려면 `~/.claude.json`의 `mcpServers`에 아래를 추가하세요:
@@ -154,37 +220,6 @@ node bin/cpmm.js setup
 
 </details>
 
-### 6. Bash 출력 최적화 (RTK)
-
-RTK는 CPMM이 지원하는 **선택적 출력 최적화 계층**입니다. `cpmm setup`은 RTK 바이너리 설치를 시도하지만, RTK hook은 기본 활성화하지 않습니다.
-
-권장 opt-in 절차:
-
-```bash
-rtk init -g --hook-only
-cpmm doctor
-```
-
-권장 `PreToolUse` 순서 (`~/.claude/settings.json`):
-- 먼저 CPMM safety hook: `~/.claude/scripts/hooks/critical-action-check.sh` with `timeout: 5`
-- 그 다음 RTK rewrite hook: `~/.claude/hooks/rtk-rewrite.sh` with `timeout: 10`
-
-업데이트 참고:
-- `cpmm setup`은 업데이트 시 `~/.claude/settings.json`을 다시 씁니다.
-- RTK를 opt-in으로 사용 중이면 CPMM 업데이트 후 hook 순서와 timeout을 다시 확인하고, `cpmm doctor`를 다시 실행하세요.
-
-권장 검증:
-- `/hooks`에서 CPMM hook과 RTK hook이 모두 로드되는지 확인
-- 위험 명령이 여전히 CPMM에서 먼저 차단되는지 확인
-- `cpmm doctor` 실행
-- 실제 Bash-heavy 세션 후 `rtk gain --quota --tier pro` 확인
-
-롤백:
-
-```bash
-rtk init -g --uninstall
-```
-
 ---
 
 ## 🚀 빠른 시작 (Quick Start)
@@ -266,7 +301,7 @@ flowchart LR
 | 명령어 | 설명 | 추천 상황 |
 | :--- | :--- | :--- |
 | **🧠 심층 실행** | | |
-| `/dplan [작업]` | **Sonnet 4.6** + Perplexity, Sequential Thinking, Context7 | 라이브러리 비교, 최신 기술 조사 (심층 연구) |
+| `/dplan [작업]` | **Sonnet 4.6** + Perplexity, Sequential Thinking, 공식 Context7 설치 시 | 라이브러리 비교, 최신 기술 조사 (심층 연구) |
 | `/do-sonnet` | **Sonnet 4.6**로 직접 실행 | Haiku 4.5가 계속 실패할 때 수동 격상 |
 | `/do-opus` | **Opus 4.6**으로 직접 실행 | 매우 복잡한 문제 해결 (비용 주의) |
 | **💾 세션/컨텍스트** | | |
@@ -278,7 +313,7 @@ flowchart LR
 | `/learn` | 패턴 학습 및 저장 | 자주 반복되는 오류나 선호 스타일 등록 |
 | `/analyze-failures` | 오류 로그 분석 | 반복되는 에러 원인 파악 |
 | `/watch` | 프로세스 모니터링 (tmux) | 장시간 빌드/테스트 관찰 |
-| `/llms-txt` | 문서 가져오기 | 라이브러리 공식 문서를 LLM 포맷으로 로드 |
+| `/llms-txt` | raw 문서 가져오기 | raw `/llms.txt` 내용 또는 직접 docs URL 로드 |
 
 </details>
 
@@ -317,7 +352,7 @@ flowchart LR
 | **🕹️ Commands** | /plan, /do, /review 등 14개 명령어 사용법 | [📂 **Commands 가이드**](.claude/commands/README.ko.md) |
 | **🪝 Hooks** | Pre-check, Auto-format 등 11개 자동화 스크립트 로직 | [📂 **Hooks 가이드**](scripts/hooks/README.ko.md) |
 | **📏 Rules** | 보안, 코드 스타일, 위험 명령어 차단 정책 | [📂 **Rules 가이드**](.claude/rules/README.ko.md) |
-| **🧠 Skills** | CLI Wrapper 등 도구 기술 명세 | [📂 **Skills 가이드**](.claude/skills/README.ko.md) |
+| **🧠 Skills** | CLI Patterns 같은 도구 스킬 사양 | [📂 **Skills 가이드**](.claude/skills/README.ko.md) |
 | **🔧 Contexts** | Backend/Frontend 프로젝트별 컨텍스트 템플릿 | [📂 **Contexts 가이드**](.claude/contexts/README.ko.md) |
 | **💾 Sessions** | 세션 요약 저장 및 관리 구조 | [📂 **Sessions 가이드**](.claude/sessions/README.ko.md) |
 | **🛠️ Scripts** | Verify, Build, Test 범용 스크립트 모음 | [📂 **Scripts 가이드**](scripts/README.ko.md) |
@@ -334,7 +369,7 @@ flowchart LR
 
 ```text
 claude-pro-minmax
-├── .claude.json                # 글로벌 MCP 설정 (User Scope)
+├── .claude.json                # 관리되는 글로벌 MCP 설정
 ├── .claudeignore               # Claude 컨텍스트 제외 규칙
 ├── .gitignore                  # Git ignore 규칙
 ├── CONTRIBUTING.md             # 기여 가이드
@@ -370,13 +405,13 @@ claude-pro-minmax
 │   │   ├── load-context.md     # 사전 정의된 컨텍스트 템플릿 로드
 │   │   ├── learn.md            # 새로운 패턴을 메모리에 저장
 │   │   ├── analyze-failures.md # 도구 실패 로그 분석
-│   │   └── llms-txt.md         # LLM 최적화 문서 조회
+│   │   └── llms-txt.md         # raw /llms.txt 문서 조회
 │   ├── rules/                  # 행동 규칙
 │   │   ├── critical-actions.md # 위험 명령어 차단 (rm -rf, git push -f, etc.)
 │   │   ├── code-style.md       # 코딩 컨벤션 및 표준
 │   │   └── security.md         # 보안 모범 사례
 │   ├── skills/                 # 도구 능력
-│   │   ├── cli-wrappers/       # 경량 CLI 래퍼 (MCP 오버헤드 대체)
+│   │   ├── cli-patterns/       # 경량 일반 CLI 패턴
 │   │   │   ├── SKILL.md        # 스킬 정의 및 사용법
 │   │   │   └── references/     # CLI 참조 문서
 │   │   │       ├── github-cli.md
@@ -461,7 +496,7 @@ claude-pro-minmax
 
 A: Anthropic의 정확한 quota 알고리즘은 공개되지 않았습니다. 세 가지 축으로 최적화합니다:
 - **저비용 모델 우선 경로**: 기본 구현은 Haiku 중심으로 시작하고 필요 시에만 Sonnet/Opus로 승격합니다.
-- **출력 비용 인식**: Output 토큰은 Input 대비 단가가 높아 응답 예산/필터링으로 payload를 줄입니다.
+- **출력 비용 인식**: 출력이 많은 턴일수록 비용 부담이 커지는 경향이 있으므로, 응답 예산과 필터링으로 payload를 줄입니다.
 - **작업 흐름 단순화**: `/do`와 `/plan`을 상황에 맞게 분리해 불필요한 고비용 턴을 줄입니다.
 
 근거 실측값은 [docs/CORE_STRATEGY_EXPERIMENT_ARCHIVE.ko.md](docs/CORE_STRATEGY_EXPERIMENT_ARCHIVE.ko.md)를 참고하세요.