opencode-resolve 0.1.12 → 0.1.16

package/README.ko.md

@@ -1,345 +1,106 @@
-# opencode-resolve — OpenCode용 가벼운 해결사(resolver) 플러그인
+# opencode-resolve — OpenCode용 가벼운 해결사 플러그인
 
-**[English](./README.md) | [한국어](./README.ko.md)**
+**[English](./README.md) | [한국어](./README.ko.md) | [문서 사이트](https://jshsakura.github.io/opencode-resolve/)**
 
 [![npm version](https://img.shields.io/npm/v/opencode-resolve.svg)](https://www.npmjs.com/package/opencode-resolve)
 [![CI](https://github.com/jshsakura/opencode-resolve/actions/workflows/publish.yml/badge.svg)](https://github.com/jshsakura/opencode-resolve/actions/workflows/publish.yml)
+[![GitHub Pages](https://img.shields.io/badge/docs-live-blue?logo=github)](https://jshsakura.github.io/opencode-resolve/)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-> **opencode-resolve**는 **[OpenCode](https://opencode.ai)용 가벼운 해결사(resolver) 플러그인**입니다. OpenCode 세션 _내부_ 에서 동작하며, 하나의 지시를 완성되고 검증된 변경으로 만듭니다 — 이것이 여기서 말하는 _해결(resolve)_ 의 의미입니다.
->
-> 독립 실행형 애플리케이션이 아니며, 모델 프로바이더도, 매일 실행하는 별도 CLI도, `opencode.json` 설정을 대체하는 것도 아닙니다. OpenCode 플러그인이며 그 이상도 이하도 아닙니다.
+`opencode-resolve`는 [OpenCode](https://opencode.ai)에 작은 고정 역할 해결 루프를 추가하는 플러그인입니다.
 
-**고정 역할(fixed-role) 검증 해결 루프**를 제공합니다 — **resolver**(컨텍스트 효율적 플래너/판정자)와 **coder**(집중된 구현자)가 편집, 검증, 안전한 셸 명령에 대해 저마찰 권한으로 실행됩니다. Resolver는 관련 파일만 검사하고, 가장 작은 패치를 계획하고, 정확한 지시와 함께 coder를 디스패치하며, 검증된 체크포인트를 통해 반복합니다. 반복 실패 시 debugger/architect 회복 가이드를 쓰고, 연속 실패가 누적되면 완료한 척하지 않고 차단 사항을 보고해야 합니다. 내부 전문가 서브에이전트(**explorer**, **reviewer**, **deep-reviewer**)는 OpenCode 네이티브 서브에이전트로 기본 주입됩니다 — resolver가 필요하다고 판단할 때 디스패치되지만, 핵심 경로의 일부가 아니며 사용자 대면 기본 역할이 아닙니다. 역할을 정의할 뿐 모델 프로바이더를 정의하지 않습니다: 에이전트는 사용자가 지정하지 않는 한 OpenCode 기본 모델을 상속합니다.
+- `resolver`는 계획, 디스패치, 검증, 반복을 담당합니다.
+- `coder`는 작은 구현 패치와 대상 검증을 담당합니다.
+- `explorer`, `reviewer`, `deep-reviewer`, `planner`는 필요할 때 resolver가 부르는 내부 서브에이전트입니다.
 
-```
-# AI 코딩 어시스턴트에 붙여넣기만 하면 전체 설정이 자동으로 완료됩니다
-Install and configure opencode-resolve by following the instructions here:
-https://github.com/jshsakura/opencode-resolve#drop-in-setup-give-to-an-llm
-```
-
----
-
-## 이것은 무엇이고, 무엇이 아닌가
-
-| ✅ 이것은 | ❌ 이것은 아닙니다 |
-|---|---|
-| `opencode plugin opencode-resolve`로 설치하는 **OpenCode용 가벼운 해결사(resolver) 플러그인** | 독립 실행형 앱 또는 별도 CLI |
-| OpenCode에 주입되는 고정 역할(fixed-role) 검증 루프(resolver + coder) | 모델 프로바이더 또는 API 키 관리자 |
-| Context7 MCP 자동 등록 훅 | `opencode.json` 설정을 대체하는 것 |
-| OpenCode 설정과 함께 위치하는 설정 파일(`resolve.json`) | 코딩할 때마다 직접 실행해야 하는 것 |
-| 한 번 설치 후 OpenCode 내부에서 자동으로 실행 | OpenCode 자체를 대체하는 것 |
+독립 실행형 앱, 모델 프로바이더, API 키 관리자, `opencode.json` 대체물이 아닙니다.
 
-OpenCode가 설치되어 있지 않거나 실행 중이 아니면 opencode-resolve는 아무것도 하지 않습니다.
-
----
+```sh
+npm install -g opencode-resolve
+opencode plugin opencode-resolve --global --force
+```
 
 ## 목차
 
-- [기능](#기능)
-- [AI 기반 설정](#ai-기반-설정)
-- [사전 요구 사항](#사전-요구-사항)
-- [빠른 시작](#빠른-시작)
-- [드롭인 설정 (LLM에 전달)](#드롭인-설정-llm에-전달)
-- [기본 동작](#기본-동작)
-- [프로젝트 컨텍스트 소스](#프로젝트-컨텍스트-소스)
+- [무엇을 추가하나](#무엇을-추가하나)
+- [설치](#설치)
+- [추천 스킬](#추천-스킬)
 - [설정](#설정)
-- [설정 참조](#설정-참조)
-- [자동 승인](#자동-승인)
-- [병렬 서브에이전트 제한](#병렬-서브에이전트-제한)
-- [업그레이드 및 마이그레이션](#업그레이드-및-마이그레이션)
 - [모델 설정](#모델-설정)
-- [에이전트 참조](#에이전트-참조)
-- [선택적 명령어](#선택적-명령어)
-- [Context7 통합](#context7-통합)
-- [최신 상태 유지](#최신-상태-유지)
-- [로컬 개발](#로컬-개발)
-- [검증](#검증)
+- [에이전트](#에이전트)
+- [권한](#권한)
+- [Context7](#context7)
+- [프로젝트 컨텍스트](#프로젝트-컨텍스트)
+- [업그레이드](#업그레이드)
+- [개발](#개발)
 - [릴리스](#릴리스)
-- [설계 규칙](#설계-규칙)
-- [라이선스](#라이선스)
-
----
-
-## 기능
-
-- **고정 역할(fixed-role) 검증 해결 루프** — `resolver`(컨텍스트 효율적 플래너/판정자) + `coder`(집중된 구현자)
-- **기본적으로 컨텍스트 효율적** — 최소 파일 읽기, 가장 작은 패치, 대상 검증, 체크포인트 실행, 반복 수정 실패 시 명시적 차단 사항 보고
-- **커밋된 팀 컨텍스트 감지** — `HARNESS.md`, `AGENTS.md`, `.opencode/context`, `.claude/context`, `context/`, Agentic 스타일 `thoughts/`를 감지하고 패턴 문서 목록을 노출해 전체 repo를 프롬프트에 밀어 넣지 않고도 필요한 컨텍스트만 로드
-- **OpenCode 네이티브 내부 전문가 서브에이전트** — `reviewer`(검증 갭 감사), `explorer`(코드베이스 스카우트), `deep-reviewer`(위험/보안 리뷰) — 서브에이전트로 기본 주입되지만 핵심 경로가 아님; resolver가 필요할 때만 디스패치
-- **저마찰 권한** — 쓰기 에이전트의 edit/webfetch는 허용, bash는 분류기 라우팅으로 안전 명령은 허용하고 위험 명령은 거부하며 알 수 없는 명령은 계속 ask 유지
-- **Context7 MCP** — `context7: true` 시 [Context7](https://context7.com) 문서 조회를 자동 등록
-- **모델 핀닝** — 이점을 측정한 경우 역할별로 다른 모델 지정 가능; 기본적으로 모든 역할이 OpenCode 기본 모델을 상속
-- **소프트 병렬 상한** — `maxParallelSubagents`가 resolver의 coder 동시 실행 수를 제어
-- **엄격한 검증** — 알 수 없는 키, 오타, 잘못된 모드, 잘못된 타입은 로드 시 즉시 실패
-- **추가적 마이그레이션** — 업그레이드 시 기존 설정을 덮어쓰지 않음
-- **`@opencode-ai/plugin` 외의 종속성 없음** — 추가로 설치할 것이 없음
-
----
-
-## AI 기반 설정
-
-> **한 줄. 어떤 AI 코딩 어시스턴트든. 모든 것이 자동으로 구성됩니다.**
-
-Claude Code, Cursor, Codex, OpenCode, Windsurf, VS Code Copilot, 또는 Gemini CLI에 붙여넣으세요:
-
-```
-Install and configure opencode-resolve by following the instructions here:
-https://github.com/jshsakura/opencode-resolve#drop-in-setup-give-to-an-llm
-```
 
-AI가 자동으로:
+## 무엇을 추가하나
 
-1. `opencode plugin opencode-resolve --global --force`로 플러그인을 설치
-2. `opencode-resolve`를 `opencode.json` 플러그인 배열에 병합
-3. 동작하는 설정으로 `resolve.json` 생성
-4. OpenCode 재시작 안내
+- 작은 패치와 검증 증거를 중시하는 `resolver -> coder` 루프
+- 코드베이스 탐색과 리뷰 갭 점검을 위한 읽기 전용 서브에이전트
+- 선택적 명령어: `/resolve`, `/resolve-code`, `/resolve-review`
+- 선택적 Context7 MCP 자동 등록
+- 엄격한 설정 검증: 알 수 없는 키, 잘못된 모드, 잘못된 에이전트 이름, 잘못된 타입은 즉시 실패
+- 보수적 마이그레이션: 기존 값은 동의 없이 덮어쓰지 않음
 
-수동 설정 편집이 필요 없습니다. macOS, Linux, Windows에서 작동합니다.
-
-> 수동 설정은 아래 [사전 요구 사항](#사전-요구-사항)과 [빠른 시작](#빠른-시작)을 참조하세요.
-
----
-
-## 사전 요구 사항
-
-### 1. OpenCode
-
-opencode-resolve는 **OpenCode 플러그인**입니다. [OpenCode](https://opencode.ai)가 설치되어 실행 중이어야 합니다.
-
-확인:
-
-```sh
-opencode --version
-```
-
-### 2. Node.js ≥ 20
-
-플러그인과 OpenCode 자체는 Node.js 20 이상이 필요합니다.
-
-확인:
-
-```sh
-node --version   # v20.x 이상이어야 함
-```
-
-### 3. 설정된 모델 프로바이더
-
-OpenCode는 `~/.config/opencode/opencode.json`에 유효한 API 키와 함께 최소 하나의 모델 프로바이더가 설정되어야 합니다. opencode-resolve 에이전트는 핀닝하지 않는 한 기본 모델을 상속합니다.
-
-최소 프로바이더 설정 예:
+기본 활성 에이전트:
 
 ```json
-{
-  "model": "openai/gpt-4o",
-  "provider": {
-    "openai": {
-      "name": "OpenAI"
-    }
-  }
-}
+["coder", "resolver", "explorer", "reviewer", "deep-reviewer", "planner"]
 ```
 
-> 플러그인 자체에는 추가 API 키가 필요 없습니다. Context7은 플러그인이 자동으로 등록합니다. GLM/ZAI 사용자의 경우 postinstall이 로컬 ZAI MCP 서버 부트스트랩을 추가할 수 있지만, API 키를 `opencode.json`에 복사하지 않습니다. 해당 MCP 서버가 키를 요구하면 셸에서 `Z_AI_API_KEY`를 export 하세요.
+## 설치
 
----
+### 요구 사항
 
-## 빠른 시작
+- OpenCode 실행 가능: `opencode --version`
+- Node.js 20 이상: `node --version`
+- `~/.config/opencode/opencode.json`에 최소 하나의 OpenCode 모델 프로바이더 설정
 
-### npm에서 설치
+### 설치
 
 ```sh
 npm install -g opencode-resolve
-```
-
-`postinstall` 스크립트가 자동으로:
-
-1. `opencode-resolve`를 `~/.config/opencode/opencode.json`의 `plugin` 배열에 추가 (이미 없는 경우).
-2. 파일이 존재하지 않는 경우, 현재 모델 프로바이더에 맞게 적응된 `~/.config/opencode/resolve.json`을 생성:
-   - **인터랙티브 터미널** → 항상 `mix` / `gpt` / `glm`을 묻고, `bronze` / `silver` / `gold` 3티어 모델을 고르게 합니다. `mix`에서는 전용 `gpt`, `glm` primary 에이전트를 켤지도 묻습니다.
-   - **비대화형 설치** → opencode.json에서 프로바이더를 자동 감지하여 모델 적응 프리셋을 작성합니다. `resolver`, `gpt`, `glm` primary 경로를 활성화합니다.
-   - **GLM/ZAI 모델 감지** → 비밀값 없는 로컬 ZAI MCP 부트스트랩은 계속 추가합니다.
-
-   기존 `resolve.json` 파일은 **동의 없이 덮어쓰지 않습니다**. 재설치 시 인터랙티브 환경이면 기존 파일을 업데이트할지, 백업 후 fresh setup을 다시 돌릴지 묻습니다. 비대화형 자동화에서는 `OPENCODE_RESOLVE_REINSTALL=fresh` 또는 `OPENCODE_RESOLVE_REINSTALL=update`를 설정하세요.
-
-자동 등록을 건너뛰려면:
-
-```sh
-OPENCODE_RESOLVE_SKIP_POSTINSTALL=1 npm install -g opencode-resolve
-```
-
-### 플러그인 캐시 새로고침
-
-> **중요 — OpenCode가 플러그인을 자체적으로 캐시합니다.** OpenCode는 전역 설치된 npm 패키지를 직접 사용하지 않습니다. `~/.cache/opencode/packages/`에 자체 캐시를 유지합니다. 최초 설치 후 (또는 향후 업그레이드 시) 캐시를 새로고침하세요:
-
-```sh
 opencode plugin opencode-resolve --global --force
-```
-
-그래도 OpenCode가 계속 예전 패키지를 로드하면, OpenCode 플러그인 캐시 항목만 지우고 다시 설치하세요. 이 절차는 `~/.config/opencode/resolve.json`을 삭제하지 않습니다.
-
-Linux/macOS:
-
-```sh
-export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
-rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
-opencode plugin opencode-resolve@latest --global --force
-node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
-```
-
-Windows PowerShell:
-
-```powershell
-$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
-$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
-Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
-opencode plugin opencode-resolve@latest --global --force
-$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
-node -e "console.log(require(process.argv[1]).version)" $Pkg
-```
-
-캐시 새로고침 후 OpenCode를 재시작하세요.
-
-### 수동 대안
-
-`postinstall`이 플러그인을 등록하지 않았다면, `~/.config/opencode/opencode.json`에 직접 추가:
-
-```json
-{
-  "plugin": ["opencode-resolve"]
-}
-```
-
-### OpenCode 재시작
-
-```sh
 opencode
 ```
 
-사용자 대면 resolve 에이전트인 `resolver`가 사용 가능한지 확인합니다. `coder`는 resolver가 디스패치하는 서브에이전트로 활성화되므로 primary picker에는 보이지 않을 수 있습니다.
+npm `postinstall`이 `~/.config/opencode/opencode.json`에 플러그인을 등록하고, 없을 때만 `~/.config/opencode/resolve.json`을 만들고, 기존 모델 핀을 보존하며 (`--reset-config`로 명시 시 초기화), `~/.cache/opencode/packages/` 의 OpenCode 플러그인 캐시를 새로고침합니다.
 
----
+### 다시 셋업하기
 
-## 드롭인 설정 (LLM에 전달)
+설치 이후 언제든 `opencode-resolve setup` CLI로 다시 실행할 수 있습니다.
 
-아래 블록을 능력 있는 LLM(Claude Code, Cursor, Codex 등)에 _"이 머신에 opencode-resolve를 설정해줘"_ 지시와 함께 전달하세요. LLM은 **인터랙티브하게** 설치를 진행해야 합니다 — 이미 설정된 provider와 model을 발견한 다음, 어느 것을 역할에 핀닝할지 사용자에게 직접 물어봅니다. 추측 금지, 임의 모델 ID 금지.
+| 명령 | 언제 사용 |
+| --- | --- |
+| `opencode-resolve setup --fresh` | `resolve.json` 재생성, 기존 모델 핀 유지 |
+| `opencode-resolve setup --reset-config` | `resolve.json` 재생성 + 모델 핀 초기화 |
+| `opencode-resolve setup --models` | 모델 핀만 다시 감지 |
+| `opencode-resolve setup --force-cache` | OpenCode 플러그인 캐시만 새로고침 |
 
-> **LLM에게:** 아래 "사용자에게 질문" 단계는 모두 실제 질문입니다 — 사용자의 답변을 기다린 뒤에만 진행하세요. 응답 없이 기본값으로 넘어가지 마세요. 사용자의 `opencode.json`(또는 선언된 `provider.*` 레지스트리)에 없는 모델 ID는 절대 만들지 마세요.
-
-### 1단계 — 설치 및 캐시 준비
+자동 설정을 건너뛰려면:
 
 ```sh
-opencode plugin opencode-resolve --global --force
+OPENCODE_RESOLVE_SKIP_POSTINSTALL=1 npm install -g opencode-resolve
 ```
 
-플러그인을 다운로드하고, OpenCode 패키지 캐시(`~/.cache/opencode/packages/`)에 설치하며, 사용 가능하게 만듭니다.
+### 선택적 companion 플러그인
+
+- `@tarquinen/opencode-dcp@latest` — 긴 루프에서 오래된 tool output을 줄여 토큰 비용을 낮춥니다.
+- `@slkiser/opencode-quota@latest` — 컨텍스트를 오염시키지 않고 토큰/quota 사용량을 보여줍니다.
 
-### 2단계 — `~/.config/opencode/opencode.json`에 플러그인 등록
+### 수동 설정
 
-`plugin` 배열에 문자열 `"opencode-resolve"`를 추가합니다. **여기서는 인라인 튜플 형태를 쓰지 마세요** — 항목을 단순 문자열로 두어 모든 역할/모델 설정이 `resolve.json`(3단계)에서 관리되도록 합니다. 설정 이원화로 인한 디버깅 부담을 막습니다.
+`~/.config/opencode/opencode.json`에 플러그인을 추가합니다.
 
 ```json
 {
-  "$schema": "https://opencode.ai/config.json",
-  "model": "<사용자-기본-모델-id>",
   "plugin": ["opencode-resolve"]
 }
 ```
 
-> 이미 다른 플러그인이 있다면, 기존 배열에 `"opencode-resolve"`를 **추가**하세요. 기존 설정을 **덮어쓰지 마세요**.
-
-#### 2b. 권장 companion 플러그인 제안 (2개)
-
-모델 선택으로 넘어가기 전에, **독립적인** 두 companion 플러그인을 각각 한 번씩 물어봅니다 — 둘 다 권장 기본값. 별개의 OpenCode 플러그인이라 필수는 아니지만 opencode-resolve와 궁합이 좋습니다.
-
-**Companion 1 — `@tarquinen/opencode-dcp` (Dynamic Context Pruning)**
-
-> _opencode-resolve는 **`@tarquinen/opencode-dcp`** 와 궁합이 좋아요 — obsolete tool output을 가지치기해서 긴 resolver 루프의 토큰 비용을 줄입니다. 설치할까요? (권장)_
-
-**Companion 2 — `@slkiser/opencode-quota` (사용량/quota 추적)**
-
-> _그리고 **`@slkiser/opencode-quota`** — 컨텍스트 윈도우를 오염시키지 않고 실시간 토큰/quota 사용량을 보여줍니다. GLM coding-plan, OpenAI Plus/Pro, Qwen 등 지원. 내 사용량/잔여 quota 확인용으로 유용. 설치할까요? (권장)_
-
-사용자가 **예** (각 질문마다):
-
-1. `opencode plugin <package>@latest --global --force` 실행 (캐시 priming).
-2. `~/.config/opencode/opencode.json`의 `plugin` 배열에 `"<package>@latest"` 추가 — 이미 있으면 스킵.
-
-`<package>`는 `@tarquinen/opencode-dcp` 또는 `@slkiser/opencode-quota`.
-
-각 **아니오**: 그 항목 스킵 — `opencode.json`을 그것 때문에 수정하지 마세요. 어느 쪽이든 3단계로 진행.
-
-> `context7` MCP는 `resolve.json`에서 `context7: true`(기본값)이면 opencode-resolve가 런타임에 자동 등록합니다. 별도 질문 불필요.
-
-### 3단계 — 모델을 인터랙티브하게 고른 뒤 `~/.config/opencode/resolve.json` 작성
-
-여기서 LLM이 **짧은 Q&A를 주도**합니다. 목표: 사용자가 자신의 설정에서 직접 고른 모델 ID로 `resolve.json`을 마무리하는 것.
-
-#### 3a. 사용자의 설치된 provider와 model 발견
-
-`~/.config/opencode/opencode.json`을 읽고 후보 맵을 만듭니다:
-
-| 출처 | 수집할 내용 |
-|---|---|
-| `provider.*` 키 | 설정된 각 provider (예: `zai`, `openai`, `anthropic`). |
-| `provider.<key>.models.*` 키 | 사용자가 해당 provider 아래 선언한 모델 키들. |
-| 최상위 `model` | `/` 앞 prefix가 `provider.*`에 없다면, 묵시적 후보로 추가 (예: `zai-coding-plan/glm-5.1`에서 `zai-coding-plan`). |
-| `agent.*.model` | 에이전트별 override — 그 provider/model 쌍도 후보에 추가. |
-
-provider가 **하나도 설정되지 않은 경우** 진행을 멈추고, `opencode.json`에 유효한 API 키를 가진 provider를 먼저 추가하라고 사용자에게 안내하세요 — opencode-resolve는 존재하지 않는 모델을 선택할 수 없습니다.
-
-#### 3b. 사용자에게 질문: 어떤 provider?
-
-후보 리스트를 출력하고 묻습니다. 예시 멘트:
-
-> _OpenCode 설정에서 다음 provider들을 찾았어요. opencode-resolve 역할에 어느 걸 쓸까요?_
->
-> 1. `zai-coding-plan` — 모델: `glm-5.1`, `glm-4.7-flash`
-> 2. `openai` — 모델: `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini`, `o3-mini`, `gpt-5.5`
-> 3. _기타 (명시적인 `provider/model` ID 직접 입력)_
-
-후보 provider가 정확히 하나면 질문을 건너뛰고 사용합니다.
-
-#### 3c. 사용자에게 질문: 단일 / 2단계 / 3단계?
-
-기본 권장은 **C (3단계, 브론즈/실버/골드)**. opencode-resolve는 질적으로 다른 세 가지 작업(read-only 스카웃 → write/patch → reason/judge)을 가지며, 이를 3단계로 매핑하는 게 2단계보다 역할별 비용을 더 정확히 반영합니다. 사용자가 모델 두 개만 있으면 B로 fallback, 하나뿐이면 A.
-
-> _권장: **3단계** — `explorer`에 가벼운 스카웃, `coder`에 중간 구현 모델, `resolver`/`reviewer`/`deep-reviewer`/`planner`에 강한 reasoner. 선택:_
->
-> **C. 3단계 — 브론즈(스카웃) + 실버(코더) + 골드(추론) — 권장**
-> B. 2단계 — fast + strong (모델 두 개만 있을 때)
-> A. 모든 역할에 단일 모델 (모델 하나뿐이거나 최대한 단순한 게 필요한 경우만)
-
-사용자가 그냥 엔터를 누르거나 "권장"이라고 답하면 C로. 모델 부족 시에만 fallback. **same-provider 분할도 완전 유효** — 예: `openai/gpt-4o-mini` / `openai/gpt-5.3-codex` / `openai/o4-mini`, 또는 `zai/glm-4.7-flash` / `zai-coding-plan/glm-5.1` / `zai/glm-5`.
-
-#### 3d. 사용자에게 질문: 어떤 모델?
-
-3b에서 고른 provider의 모델만 보여주세요.
-
-- **단일 (A)** 의 경우 한 번만 질문:
-  > _모든 역할이 사용할 모델은 무엇인가요?_ → 선택한 provider의 모델 목록 제시.
-- **분할 (B)** 의 경우 순서대로 두 번 질문:
-  > _`coder`와 `explorer`용 **fast** 모델을 고르세요:_ → 모델 목록.
-  >
-  > _`resolver`, `reviewer`, `deep-reviewer`용 **strong** 모델을 고르세요:_ → 모델 목록.
-
-파일을 쓰기 전에 각 선택을 사용자에게 다시 확인시키세요. 예:
-
-> _`coder`와 `explorer`를 `zai-coding-plan/glm-5.1`로, `resolver`/`reviewer`/`deep-reviewer`를 `openai/gpt-5.5`로 핀닝합니다. 진행할까요?_
-
-#### 3d-bis. 사용자가 명시적으로 hard cap 원할 때만 `maxParallelSubagents` 설정
-
-기본 흐름은 `maxParallelSubagents`를 `resolve.json`에 **쓰지 않습니다**. resolver prompt에 soft 가이드라인이 들어있어요 — 진짜 독립적인 작업이면 coder fan out, rate-limit 에러 보이면 backoff, explorer 무제한, reviewer/deep-reviewer/planner는 본질적으로 singleton. oh-my-openagent (per-model semaphore, 사실상 default 무제한) 와 OpenCode core (built-in concurrency 룰 없음) 의 처리와 동일한 결, rate limit을 이미 인지한 모델을 과제약하지 않음.
-
-`maxParallelSubagents`는 사용자가 hard cap을 명시적으로 원할 때만 물어보세요. 흔한 케이스: GLM coding-plan 사용자가 "burst 절대 안 됨" 보장 원할 때. 권장 멘트:
-
-> _(optional, 관련된 경우만)_ _`coder` 모델이 GLM이네요 — coding-plan은 burst 시 throttle 걸립니다. 엄격한 직렬 coder 디스패치를 위해 `maxParallelSubagents: 1`로 핀닝할까요?_
-
-그 외엔 필드 자체를 생략.
-
-#### 3e. `~/.config/opencode/resolve.json` 작성
-
-**3단계 (C, 권장)** — `bronze`/`silver`/`gold` alias 사용:
+`~/.config/opencode/resolve.json`을 만듭니다.
 
 ```json
 {
@@ -347,679 +108,284 @@ provider가 **하나도 설정되지 않은 경우** 진행을 멈추고, `openc
   "preserveNative": true,
   "context7": true,
   "commands": false,
-  "models": {
-    "bronze":        "<provider>/<스카웃-모델>",
-    "silver":        "<provider>/<코더-모델>",
-    "gold":          "<provider>/<추론-모델>",
-    "explorer":      "bronze",
-    "coder":         "silver",
-    "resolver":      "gold",
-    "reviewer":      "gold",
-    "deep-reviewer": "gold",
-    "planner":       "gold"
-  },
+  "models": {},
   "agents": {
-    "coder":         { "enabled": true,  "mode": "subagent" },
-    "resolver":      { "enabled": true },
-    "explorer":      { "enabled": true,  "mode": "subagent" },
-    "reviewer":      { "enabled": true,  "mode": "subagent" },
-    "deep-reviewer": { "enabled": true,  "mode": "subagent" },
-    "planner":       { "enabled": true,  "mode": "subagent" },
-    "architect":     { "enabled": false },
-    "gpt-coder":     { "enabled": false },
-    "debugger":      { "enabled": false },
-    "researcher":    { "enabled": false }
-  },
-  "autoApprove": true,
-  "autoUpdate": true
+    "coder": { "enabled": true, "mode": "subagent" },
+    "resolver": { "enabled": true },
+    "explorer": { "enabled": true, "mode": "subagent" },
+    "reviewer": { "enabled": true, "mode": "subagent" },
+    "deep-reviewer": { "enabled": true, "mode": "subagent" },
+    "planner": { "enabled": true, "mode": "subagent" }
+  }
 }
 ```
 
-**2단계 (B)** — 모델이 두 개뿐이면 bronze와 silver 통합:
+캐시를 새로고침하고 OpenCode를 재시작합니다.
 
-```json
-"models": {
-  "silver":        "<provider>/<코더-모델>",
-  "gold":          "<provider>/<추론-모델>",
-  "explorer":      "silver",
-  "coder":         "silver",
-  "resolver":      "gold",
-  "reviewer":      "gold",
-  "deep-reviewer": "gold",
-  "planner":       "gold"
-}
+```sh
+opencode plugin opencode-resolve --global --force
+opencode
 ```
 
-**단일 (A)** — 모든 역할이 단일 모델:
+OpenCode가 계속 오래된 플러그인을 로드하면:
 
-```json
-"models": {
-  "gold":          "<provider>/<단일-모델>",
-  "explorer":      "gold",
-  "coder":         "gold",
-  "resolver":      "gold",
-  "reviewer":      "gold",
-  "deep-reviewer": "gold",
-  "planner":       "gold"
-}
+```sh
+export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
+rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+opencode plugin opencode-resolve@latest --global --force
 ```
 
-`<provider>/<모델>` 플레이스홀더는 모두 사용자가 고른 **정확한** ID로 교체. **`maxParallelSubagents`는 사용자가 명시적으로 hard cap 요청한 경우에만 추가** (3d-bis 참고).
-
-`<provider>/<모델>` 플레이스홀더는 모두 사용자가 3b/3d에서 고른 **정확한** ID 문자열로 교체 — 임의 생성 금지, 자동완성 금지, 버전 드리프트 금지. 고른 모델을 `provider/model` 문자열로 매핑할 수 없으면 추측하지 말고 사용자에게 다시 물어보세요.
-
-> 활성 에이전트마다 명시적인 `enabled: true`를 두어 파일이 자체 문서화됩니다. `enabled` 배열이 여전히 권위 있으며, 에이전트별 플래그는 사람이 파일을 읽을 때의 모호함만 제거합니다.
+## 추천 스킬
 
-> `resolve.json`이 이미 존재하면 **조용히 덮어쓰지 마세요**. 기존 내용을 먼저 사용자에게 보여주고, 무엇이 바뀔지 요약한 다음, 덮어쓸지 / 병합할지 / 중단할지 물어보세요.
+더 넓은 OpenCode 환경을 원하면 [awesome-opencode-skills](https://github.com/jshsakura/awesome-opencode-skills)를 같이 사용해 보세요. 개발, 인프라, 보안, 데이터, 문서화 등 특화 작업용 OpenCode Skills 컬렉션을 설치합니다.
 
-### 4단계 — OpenCode 재시작 및 검증
-
-OpenCode를 닫았다가 다시 연 후, 설치가 잘 됐는지 확인하세요:
+macOS / Linux:
 
 ```sh
-opencode run "list available agents"
+curl -sL https://raw.githubusercontent.com/jshsakura/awesome-opencode-skills/main/install.sh | bash
 ```
 
-출력에 `resolver`와 `coder`가(활성화 시 `reviewer`도) **반드시** 포함되어야 합니다. 명시적으로 점검할 실패 모드 두 가지:
-
-| 증상 | 원인 | 조치 |
-|---|---|---|
-| OpenCode 내장 `explore` / `general`만 나옴 | 플러그인이 로드되지 않음 | `opencode plugin opencode-resolve --global --force` 재실행; `opencode.json`의 `plugin` 배열에 `"opencode-resolve"`가 문자열로 들어있는지 확인. |
-| 에이전트는 보이는데 호출 시 "model not found" | `models`에 핀닝된 ID가 실제로 없음 | `resolve.json`을 다시 열어, 해당 ID를 사용자가 실제 보유한 ID로 교체 후 재시작. |
-| 분할(B)을 골랐는데 한 단계만 작동 | `models` 블록에 `fast` 또는 `strong` 누락 | 3단계의 3d부터 다시 실행. |
-
-내부 전문가 서브에이전트(`coder`, `explorer`, `reviewer`, `deep-reviewer`, `planner`)는 서브에이전트 전용이므로 기본 picker에는 나타나지 않습니다 — `resolver`가 기본 사용자 대면 resolve 에이전트입니다.
-
-### 이 템플릿을 사용하는 이유
-
-| 설정 | 이유 |
-|---|---|
-| `enabled: ["coder", "resolver", "explorer", "reviewer", "deep-reviewer", "planner"]` | 고정 핵심 경로(resolver→coder) + OpenCode 네이티브 내부 전문가 서브에이전트 기본 주입 |
-| `autoApprove: true` | 하위 호환/가독성 플래그. 실제 저마찰 동작은 기본 권한과 `permission.ask` bash 분류기가 담당 |
-| 기본적으로 `maxParallelSubagents` 미설정 | resolver는 soft fan-out 가이드를 유지; GLM profile은 토큰 효율 프롬프트를 쓰지만 사용자가 설정하지 않는 한 hard concurrency cap을 걸지 않음 |
-| `agents.coder.mode = "subagent"` | Coder는 사용자 대면 기본 역할이 아니라 고정 resolver→coder 경로에 머무름 |
-| `agents.{explorer,reviewer,deep-reviewer}.mode = "subagent"` | 내부 전문가는 서브에이전트 전용 — 사용자 대면 기본 역할이 아님 |
-| `context7: true` | 플러그인이 Context7 MCP를 자동 등록 — 수동 MCP 설정 불필요 |
-| `models` 별칭 | 기본적으로 비어있음 — 모든 역할이 OpenCode 기본 모델을 상속. 이점을 측정한 경우에만 역할별 모델 핀닝 |
-| 다른 에이전트 비활성화 | `architect`, `gpt-coder`, `debugger`, `researcher`는 기본 꺼짐. 필요 시 활성화 |
-
-### resolver를 호출하면 어떤 일이 일어나는가
-
-1. **분류** — Resolver가 작업을 quick, normal, deep, risky로 분류합니다.
-2. **검사** — 로컬 도구로 관련 파일만 읽습니다. 광범위한 탐색 없음.
-3. **사소한 작업** — Resolver가 직접 작은 편집을 적용합니다. 서브에이전트 불필요.
-4. **구현** — 정확한 파일 경로와 집중된 지시와 함께 `coder`를 디스패치합니다.
-5. **검증** — 가장 저렴한 의미 있는 검증을 먼저 실행합니다 (대상 테스트, 타입 체크, 린트).
-6. **회복** — 문제가 남아있으면, 근본 원인을 진단하도록 `debugger`를 쓰거나 집중적인 수정과 함께 `coder`를 다시 디스패치합니다. 연속 실패가 누적되면 완료를 주장하지 않고 차단 사항을 보고합니다.
-7. **보고** — 변경 사항, 검증 결과, 남은 차단 사항의 간결한 증거 요약을 반환합니다.
-8. **내부 전문가** — 필요 시: `explorer`(범위가 불명확할 때), `reviewer`(비사소한 변경에 검증 갭), `deep-reviewer`(위험/보안/고영향도만). 서브에이전트로 기본 사용 가능하지만 핵심 경로가 아님.
-
----
-
-## 기본 동작
-
-| 항목 | 기본값 |
-|---|---|
-| 활성화된 에이전트 | `coder`, `resolver`, `explorer`, `reviewer`, `deep-reviewer`, `planner` |
-| 핵심 경로 | `resolver` → `coder` (고정 역할 검증 루프) |
-| 내부 서브에이전트 | `explorer`, `reviewer`, `deep-reviewer` (서브에이전트 전용, 필요 시 디스패치) |
-| 새 작업의 기본 에이전트 | `resolver` (`mode: "all"`) |
-| 에이전트 모델 | 최상위 OpenCode `model` 상속 |
-| 네이티브 `plan` / `build` | 그대로 보존 |
-| 프로젝트 컨텍스트 소스 | `HARNESS.md`, `AGENTS.md`, `CLAUDE.md`, `CONVENTIONS.md`, `.opencode/context`, `.claude/context`, `context/`, `thoughts/` |
-| Context7 MCP 프리셋 | `context7: true` 시 자동 추가 |
-| 선택적 명령어 | 비활성화 |
-| `autoApprove` | `true` (하위 호환/가독성 플래그; bash 라우팅은 permission hook이 처리) |
-| 반복 실패 동작 | 진단, 다른 수정으로 재시도, 실패가 많으면 architect로 전략 전환, 그래도 막히면 완료 주장 대신 차단 사항 보고 |
-
----
-
-## 프로젝트 컨텍스트 소스
-
-opencode-resolve는 전체 저장소를 프롬프트에 밀어 넣지 않고도 커밋된 프로젝트 지식을 발견할 수 있습니다. Resolver는 사용 가능한 소스 목록을 보고, 현재 작업과 관련된 문서만 읽어야 합니다.
-
-감지하는 최상위 지식 파일:
-
-| 소스 | 용도 |
-|---|---|
-| `HARNESS.md` | 빌드, 검증, 인프라, 배포, 프로젝트 함정 |
-| `AGENTS.md` | 에이전트 동작, 디스패치 규칙, 리뷰 기대치, 로컬 워크플로우 |
-| `CLAUDE.md` | 다른 AI 코딩 도구에서 쓰던 기존 가이드 |
-| `CONVENTIONS.md` | 코드 스타일, 네이밍, 아키텍처, 저장소 규칙 |
-
-감지하는 컨텍스트 디렉터리:
-
-| 소스 | 동작 |
-|---|---|
-| `.opencode/context/` | OpenCode/OAC 스타일 팀 패턴 문서 |
-| `.claude/context/` | Claude 스타일 공유 컨텍스트 문서 |
-| `context/` | 일반 프로젝트 컨텍스트 문서 |
-| `thoughts/` | Agentic 스타일 영속 지식: architecture, tickets, research, plans, reviews |
-
-컨텍스트 디렉터리에서는 `.md`, `.mdx`, `.txt`, `.json`, `.jsonc`, `.yaml`, `.yml` 파일을 제한된 깊이와 개수 안에서 목록화합니다. `thoughts/archive/`는 의도적으로 제외합니다. 보관 문서는 오래됐거나 오해를 만들 수 있기 때문입니다.
-
-로컬 런타임 상태는 git에서 제외합니다:
+Windows PowerShell:
 
-```text
-.opencode/resolve-state.json
-.opencode/*.local.json
+```powershell
+irm https://raw.githubusercontent.com/jshsakura/awesome-opencode-skills/main/install.ps1 | iex
 ```
 
-반대로 `.opencode/context/`와 `thoughts/` 같은 커밋된 컨텍스트는 ignore하지 않습니다.
-
----
-
 ## 설정
 
-플러그인은 찾은 첫 번째 설정 파일을 읽습니다:
-
-| 우선순위 | 경로 |
-|---:|---|
-| 1 | `.opencode/resolve.json` (프로젝트) |
-| 2 | `opencode-resolve.json` (프로젝트) |
-| 3 | `~/.config/opencode/resolve.json` |
-| 4 | `~/.config/opencode/opencode-resolve.json` |
-
-`opencode.json`의 인라인 플러그인 옵션이 파일 설정을 재정의합니다.
-
-설정 우선순위:
-
-```text
-기본 제공 기본값 → 찾은 첫 번째 설정 파일 → 인라인 플러그인 옵션
-```
-
-최소 설정 (기본값과 동일):
+플러그인은 아래 파일 중 첫 번째로 발견한 설정을 읽습니다.
 
-```json
-{
-  "enabled": ["coder", "resolver", "explorer", "reviewer", "deep-reviewer", "planner"],
-  "autoApprove": true,
-  "context7": true,
-  "commands": false
-}
-```
+1. `.opencode/resolve.json`
+2. `opencode-resolve.json`
+3. `~/.config/opencode/resolve.json`
+4. `~/.config/opencode/opencode-resolve.json`
 
-`opencode.json` 내의 인라인 형식:
+`opencode.json`의 인라인 플러그인 옵션은 파일 설정보다 우선합니다. 사용자 지정 경로도 가능합니다.
 
 ```json
 {
   "plugin": [
     [
       "opencode-resolve",
-      {
-        "enabled": ["coder", "resolver", "explorer", "reviewer", "deep-reviewer", "planner"],
-        "autoApprove": true,
-        "context7": true,
-        "commands": false
-      }
+      { "config": ".opencode/resolve.json" }
     ]
   ]
 }
 ```
 
-엄격한 검증은 알 수 없는 에이전트 이름, 잘못된 키, 잘못된 모드, 잘못된 권한 값, 잘못된 값 타입을 거부합니다 — 오타는 즉시 실패합니다.
-
----
-
-## 설정 참조
-
-모든 허용되는 최상위 옵션:
-
-| 키 | 타입 | 기본값 | 용도 |
-|---|---|---|---|
-| `profile` | `"mix" \| "gpt" \| "glm"` | `"mix"` | 최상위 동작 프로필. `mix`가 명시적 기본값이며, `gpt`와 `glm`은 프로바이더별 프롬프트, 활성 에이전트 기본값, chat 파라미터를 적용. |
-| `tier` | `"bronze" \| "silver" \| "gold"` | _없음_ | 선택적 활성 에이전트 프리셋. `bronze`는 최소 구성, `silver`는 표준, `gold`는 전체 전문가 세트를 활성화. |
-| `enabled` | `string[]` | `["coder", "resolver", "explorer", "reviewer", "deep-reviewer", "planner"]` | 주입할 resolve 에이전트. 핵심 경로: resolver→coder. 내부 전문가(coder, explorer, reviewer, deep-reviewer, planner)는 서브에이전트 전용. 에이전트별 `agents.<name>.enabled`가 이것을 재정의. |
-| `preserveNative` | `boolean` | `true` | 네이티브 `plan`/`build`는 항상 보존됨. 가독성을 위해 허용됨. |
-| `context7` | `boolean` | `true` | true인 경우, 이미 구성되지 않았으면 Context7 MCP 서버를 등록. |
-| `commands` | `boolean` | `false` | true인 경우, `resolve`, `resolve-code`, `resolve-review` 명령어 추가. |
-| `autoApprove` | `boolean` | `true` | 하위 호환/가독성 플래그. 현재 동작은 내장 기본 권한과 `permission.ask` bash 분류기가 제어하며, 이 플래그가 권한을 재작성하지 않음. |
-| `autoUpdate` | `boolean` | `true` | npm 버전 확인과 OpenCode 플러그인 캐시 갱신 알림을 best-effort로 수행. 비활성화하려면 false. |
-| `maxParallelSubagents` | `positive integer` | _미설정_ | 동시 coder 수에 대한 선택적 프롬프트 수준 상한. 미설정 시 resolver는 soft fan-out 가이드를 사용하고 rate-limit 에러에 backoff. GLM profile도 사용자가 설정하지 않는 한 hard cap을 걸지 않음. |
-| `models` | `object` | `{}` | 별칭 맵. 키는 에이전트 이름 또는 `bronze`/`silver`/`gold`, `gpt-*`, `glm-*`, `fast`, `strong`, `mini`, `codex`, `quick`, `deep`, `glm`, `gpt` 같은 별칭. 값은 모델 id 또는 다른 별칭. |
-| `agents` | `object` | `{}` | 에이전트별 재정의 (아래 참조). |
-| `config` | `string` | _없음_ | 설정 파일의 사용자 정의 경로 (프로젝트 상대경로 또는 절대경로). |
-
-`agents.<name>` 내의 에이전트별 옵션:
-
-| 키 | 타입 | 참고 |
-|---|---|---|
-| `enabled` | `boolean` | 최상위 `enabled`와 관계없이 이 에이전트를 강제 활성화/비활성화. |
-| `model` | `string` | 모델 id 또는 별칭. 최상위 `models` 맵에 대해 해석됨. |
-| `mode` | `"subagent" \| "primary" \| "all"` | OpenCode 에이전트 모드. |
-| `description` | `string` | 다른 에이전트에게 표시되는 기본 설명을 재정의. |
-| `prompt` | `string` | 기본 시스템 프롬프트를 재정의. (`resolver`의 경우 템플릿된 병렬 규칙 프롬프트도 비활성화.) |
-| `color` | `string` | UI 색상. |
-| `maxSteps` | `positive integer` | 호출당 단계 예산. |
-| `tools` | `Record<string, boolean>` | 개별 OpenCode 도구 토글. |
-| `permission` | `object` | 권한 재정의 — 아래 참조. |
-
-권한 키 (각각 `"ask"`, `"allow"`, 또는 `"deny"`):
-
-`edit`, `bash`, `webfetch`, `doom_loop`, `external_directory`.
-
-`permission.bash`는 명령별 맵일 수도 있습니다:
-
-```json
-{
-  "permission": {
-    "bash": { "npm test": "allow", "rm -rf": "deny" }
-  }
-}
-```
-
-완전히 주석이 달린 참조 설정이 [`opencode-resolve.reference.jsonc`](./opencode-resolve.reference.jsonc)로 패키지에 포함되어 있습니다 — 필요한 키를 `resolve.json`에 복사하세요 (주석 제외).
+우선순위:
 
----
-
-## 자동 승인
-
-`autoApprove` (기본값 `true`)는 이제 하위 호환/가독성 플래그입니다. 기존 `resolve.json`이 계속 로드되도록 설정에서 허용하지만, 현재 하네스는 이 값으로 권한을 `"ask"`에서 `"allow"`로 재작성하지 않습니다.
-
-저마찰 자율 동작은 두 가지 명시적 기본값에서 옵니다:
-
-| 권한 | 현재 기본 동작 |
-|---|---|
-| 쓰기 에이전트 `edit` / `webfetch` | `allow` |
-| 쓰기 에이전트 `bash` | `ask`, 플러그인의 `permission.ask` 분류기로 라우팅 |
-| 안전한 bash 명령 | 분류기가 자동 허용 |
-| 위험한 bash 명령 | 분류기가 자동 거부 |
-| 알 수 없는 bash 명령 | OpenCode/사용자 처리를 위해 `ask` 유지 |
-| 읽기 전용 에이전트 `edit` / `bash` | `deny`; write-capable 플러그인 도구도 read-only 에이전트를 차단 |
-
-의도를 나타내기 위해 config에 그대로 둘 수 있습니다:
-
-```json
-{
-  "autoApprove": false
-}
-```
-
-> **신뢰 참고:** 저마찰 쓰기 에이전트 권한은 작업공간과 구성된 모델을 신뢰한다고 가정합니다. 신뢰할 수 없는 코드의 경우 샌드박스나 VM을 사용하세요. Bash는 무조건 허용이 아니라 분류기 라우팅을 유지합니다.
-
----
-
-## 병렬 서브에이전트 제한
-
-`maxParallelSubagents`는 선택 사항입니다. 생략하면 **resolver**는 soft fan-out 가이드를 사용합니다: 진짜 독립적인 작업에는 coder를 분산하고, rate-limit 에러가 보이면 backoff합니다. resolver 프롬프트에 명시적인 역할별 동시 실행 상한을 넣고 싶을 때만 설정하세요. GLM profile도 기본적으로 hard cap은 없습니다.
-
-| 값 | 동작 |
-|---|---|
-| `1` | 한 번에 하나의 coder만. |
-| `2` | 최대 2개의 coder 동시 실행. 독립 작업 분산에 유용. |
-| `N > 2` | 최대 N개의 coder 동시 실행. 컨텍스트 낭비를 피하기 위해 신중하게 사용. |
-
-프로젝트별 또는 사용자별 재정의:
-
-```json
-{ "maxParallelSubagents": 1 }
-{ "maxParallelSubagents": 2 }
-{ "maxParallelSubagents": 4 }
+```text
+내장 기본값 -> 처음 발견한 설정 파일 -> 인라인 플러그인 옵션
 ```
 
-> **중요 — 소프트 제한, 하드 캡이 아님.** 제한은 resolver의 시스템 프롬프트에만 반영됩니다. 초과 디스패치를 차단하는 런타임 인터셉터는 없습니다. 지시를 잘 따르는 코딩 모델은 일반적으로 이 규칙을 준수하지만, 모델이 오동작하면 제한을 초과하는 디스패치가 통과합니다. 더 엄격한 상한을 원하면 `maxSteps`와 함께 사용하세요.
-
-제한은 설정 로드 시 프롬프트에 템플릿되므로, 새 값을 적용하려면 OpenCode를 재시작하세요. 사용자 정의 `agents.resolver.prompt`를 제공하면 템플릿된 규칙이 건너뛰어지고 프롬프트가 전적으로 적용됩니다.
+전체 주석 설정 예시: [opencode-resolve.reference.jsonc](./opencode-resolve.reference.jsonc)
 
----
+### 최상위 옵션
 
-## 업그레이드 및 마이그레이션
-
-`opencode-resolve`의 새 버전으로 업그레이드하면, `postinstall` 스크립트가 기존 `~/.config/opencode/resolve.json`에 **추가적 마이그레이션**을 실행합니다:
-
-- 새 최상위 키(현재 `autoApprove`)를 기본값과 함께 추가 (없는 경우).
-- 이미 설정한 키는 **절대** 수정하지 않음.
-- `enabled` 목록, `models` 맵, 또는 `agents` 재정의를 **절대** 다시 쓰지 않음.
-- `enabled`가 설정되어 있고 `"resolver"`를 포함하지 않으면, 추가를 제안하는 한 줄 팁을 출력. 파일은 그대로 유지.
-- 인터랙티브 재설치에서는 기존 파일을 업데이트할지, 백업 후 fresh setup을 다시 돌릴지 물음. 비대화형 자동화에서는 fresh 재설치에 `OPENCODE_RESOLVE_REINSTALL=fresh`, 보존 마이그레이션에 `OPENCODE_RESOLVE_REINSTALL=update` 사용.
-
-### 적응형 최초 설치 프리셋
-
-`resolve.json`이 **존재하지 않을** 때, postinstall은 OpenCode 모델 설정을 검사하고 프로바이더에 맞는 `models` 블록을 작성합니다:
-
-| 감지된 프로바이더 | 프리셋 |
-|---|---|
-| 인터랙티브 터미널 | 항상 `mix` / `gpt` / `glm`을 묻고 3티어 모델을 고르게 하며, `mix`에서는 `gpt`와 `glm` primary 에이전트 활성화도 묻습니다 |
-| 비대화형 설치 | opencode.json에서 프로바이더를 자동 감지하여 모델 적응 프리셋 작성. `resolver`, `gpt`, `glm` primary 경로 활성화 |
-| 레거시 opt-in | `OPENCODE_RESOLVE_AUTO_PRESET=1`을 설정하면 비대화형 provider-adapted 프리셋 허용 |
-| GLM/ZAI 감지 | API 키를 복사하지 않고 ZAI MCP 부트스트랩 추가 |
-
-언제든지 프리셋을 변경하려면 `resolve.json`의 `models`를 직접 편집하거나, `OPENCODE_RESOLVE_REINSTALL=fresh`로 재설치하세요.
-
-마이그레이션을 완전히 건너뛰려면:
-
-```sh
-OPENCODE_RESOLVE_SKIP_POSTINSTALL=1 npm install -g opencode-resolve
-```
-
----
+| 키 | 타입 | 기본값 | 용도 |
+| --- | --- | --- | --- |
+| `profile` | `mix` / `glm` / `gpt` | `mix` | 프롬프트/profile preset. |
+| `tier` | `bronze` / `silver` / `gold` | 미설정 | 설정된 tier preset 활성화. |
+| `enabled` | 에이전트 이름 배열 | 기본 에이전트 | 주입할 resolve 에이전트. |
+| `models` | object | `{}` | 모델 별칭과 역할별 모델 핀. |
+| `agents` | object | `{}` | 에이전트별 override. |
+| `preserveNative` | boolean | `true` | 명시 override가 없으면 OpenCode 기본 에이전트 보존. |
+| `context7` | boolean | `true` | 없을 때 Context7 MCP 등록. |
+| `commands` | boolean | `false` | `/resolve`, `/resolve-code`, `/resolve-review` 추가. |
+| `autoApprove` | boolean | `true` | 하위 호환용 플래그. 현재 권한은 명시 설정과 분류기가 제어. |
+| `autoUpdate` | boolean | `true` | 설치/업데이트 시 추가적 설정 마이그레이션 허용. |
+| `language` | `auto` / `en` / `ko` | `auto` | 프롬프트 언어 선호. |
+| `maxParallelSubagents` | positive integer | 미설정 | 동시 coder 디스패치에 대한 선택적 프롬프트 수준 soft limit. |
+
+### 에이전트 override
+
+각 `agents.<name>` 항목은 다음 키를 받을 수 있습니다.
+
+| 키 | 값 |
+| --- | --- |
+| `enabled` | boolean |
+| `model` | 모델 id 또는 별칭 |
+| `mode` | `subagent`, `primary`, `all` |
+| `description` | string |
+| `prompt` | string |
+| `color` | string |
+| `maxSteps` | positive integer |
+| `tools` | tool boolean object |
+| `permission` | `edit`, `bash`, `webfetch`, `doom_loop`, `external_directory` |
+
+권한 값은 `ask`, `allow`, `deny`입니다. `permission.bash`는 명령 패턴별 맵도 받을 수 있습니다.
 
 ## 모델 설정
 
-`opencode-resolve`는 기본적으로 어떤 프로바이더별 모델도 핀닝하지 않습니다. 모든 resolve 에이전트는 최상위 OpenCode `model`을 상속합니다 — 토큰당 결과 효율이 가장 좋은 하나의 효율적인 모델을 사용하세요. 이점을 측정한 경우에만 역할별 모델을 핀닝하세요.
+기본적으로 `models`는 비어 있고 resolve 에이전트는 OpenCode 최상위 `model`을 상속합니다. 비용, 속도, reasoning depth를 나눌 필요가 있을 때만 역할별 모델을 핀닝하세요.
 
-각 resolve 에이전트에 대한 모델 해석 순서:
+각 에이전트의 모델 해석 순서:
 
 1. `agents.<name>.model`
-2. `models.<name>` 별칭 매핑
-3. 최상위 OpenCode `model`
-4. 모델이 구성되지 않은 경우 OpenCode 자체의 폴백
-
-### 모든 것에 기본 모델 사용 (권장)
-
-```json
-{
-  "enabled": ["coder", "resolver", "explorer", "reviewer", "deep-reviewer"],
-  "models": {}
-}
-```
+2. `models.<name>`
+3. OpenCode 최상위 `model`
+4. OpenCode 자체 fallback
 
-### 역할별 별칭 (이점을 측정한 경우)
+3-tier 예시:
 
 ```json
 {
-  "enabled": ["coder", "resolver", "explorer", "reviewer", "deep-reviewer"],
   "models": {
-    "fast": "openai/gpt-5-mini",
-    "strong": "openai/gpt-5.3-codex",
-    "coder": "fast",
-    "resolver": "strong"
-  }
-}
-```
-
-### 하나의 역할을 직접 핀닝
-
-```json
-{
-  "agents": {
-    "resolver": {
-      "model": "openai/gpt-5.3-codex"
-    }
+    "bronze": "zai-coding-plan/glm-4.5",
+    "silver": "zai-coding-plan/glm-5.1",
+    "gold": "openai/gpt-5.5",
+    "explorer": "bronze",
+    "coder": "silver",
+    "resolver": "gold",
+    "reviewer": "gold",
+    "deep-reviewer": "gold",
+    "planner": "gold"
   }
 }
 ```
 
-### 혼합 설정 (OpenCode 설정 + resolve 모델)
+지원 모델 별칭:
 
-`plan` 및 `build`와 같은 네이티브 OpenCode 에이전트는 `opencode-resolve`가 아닌 최상위 OpenCode `agent`를 통해 구성됩니다.
-
-```json
-{
-  "model": "openai/gpt-5-mini",
-  "agent": {
-    "plan": {
-      "model": "openai/gpt-5.3-codex"
-    }
-  },
-  "plugin": [
-    [
-      "opencode-resolve",
-      {
-        "enabled": ["coder", "resolver", "explorer", "reviewer", "deep-reviewer"]
-      }
-    ]
-  ]
-}
+```text
+fast, strong, mini, codex, quick, deep, glm, gpt,
+bronze, silver, gold,
+gpt-bronze, gpt-silver, gpt-gold,
+glm-bronze, glm-silver, glm-gold,
+모든 지원 에이전트 이름
 ```
 
-이 설정에서 `plan`은 `openai/gpt-5.3-codex`를 사용; 네이티브 `build`, resolve `coder`, resolve `resolver`는 모두 `openai/gpt-5-mini`를 사용합니다.
-
-### 지원되는 모델 별칭 키
-
-| 별칭 | 용도 |
-|---|---|
-| `fast` | 빠른/저렴한 모델의 프로바이더 중립적 별칭 |
-| `strong` | 강력한/비싼 모델의 프로바이더 중립적 별칭 |
-| `mini` | 미니/효율적 모델의 프로바이더 중립적 별칭 |
-| `codex` | 코덱스 스타일 코딩 모델의 프로바이더 중립적 별칭 (레거시) |
-| `bronze` / `silver` / `gold` | scout / coder / reasoner 3티어 별칭 |
-| `gpt-bronze` / `gpt-silver` / `gpt-gold` | mixed 설정의 GPT/Codex 전용 3티어 별칭 |
-| `glm-bronze` / `glm-silver` / `glm-gold` | mixed 설정의 GLM 전용 3티어 별칭 |
-| `quick` | 레거시 별칭 (`fast`와 동등) |
-| `deep` | 레거시 별칭 (`strong`과 동등) |
-| `glm` | 레거시 별칭 (하위 호환성) |
-| `gpt` | 레거시 별칭 (하위 호환성) |
-
-별칭은 `models`에 정의된 경우에만 해석됩니다. 에이전트 이름(`coder`, `resolver` 등)도 유효한 별칭 키입니다.
-
----
-
-## 에이전트 참조
-
-| 에이전트 | 기본 | 모드 | Edit | Bash | WebFetch | 용도 |
-|---|:---:|---|---|---|---|---|
-| `resolver` | 예 (핵심) | `all` | allow | ask (분류기 라우팅) | allow | 컨텍스트 효율적 오케스트레이터. 작업을 검증된 체크포인트로 분해, coder 디스패치, 각각 검증, 반복 회복 실패 시 차단 사항 보고. |
-| `codex` | 아니오 | `all` | allow | ask (분류기 라우팅) | allow | `resolver`와 같은 검증 resolve-loop 스타일의 Codex 최적화 primary. 레거시 — 새 GPT 설정에서는 `gpt` 권장. |
-| `gpt` | 아니오 | `all` | allow | ask (분류기 라우팅) | allow | `resolver`와 같은 검증 resolve-loop 스타일의 GPT 최적화 primary. 최초 설치 GPT/mix 프리셋 또는 명시 설정으로 활성화. |
-| `glm` | 아니오 | `all` | allow | ask (분류기 라우팅) | allow | `resolver`와 같은 검증 resolve-loop 스타일의 GLM 최적화 primary. 최초 설치 GLM/mix 프리셋 또는 명시 설정으로 활성화. |
-| `coder` | 예 (핵심) | `subagent` | allow | ask (분류기 라우팅) | allow | 집중된 구현자. 가장 작은 올바른 패치. 필요한 파일만 읽음. |
-| `explorer` | 예 (서브에이전트) | `subagent` | **deny** | **deny** | allow | 내부 빠른 코드베이스 스카우트. Resolver가 범위가 불명확할 때만 디스패치; 좁은 범위는 로컬 read/grep/glob 선호. |
-| `reviewer` | 예 (서브에이전트) | `subagent` | **deny** | **deny** | allow | 내부 검증 갭 감사자. 비사소한 변경에 검증 갭이 있을 때 디스패치. |
-| `deep-reviewer` | 예 (서브에이전트) | `subagent` | **deny** | **deny** | allow | 내부 위험/보안/아키텍처 변경에 대한 철저한 리뷰. 고영향도 작업에만 디스패치. |
-| `planner` | 예 (서브에이전트) | `subagent` | **deny** | **deny** | allow | 명시적 계획 전문가. 사용자가 계획/분해/전략을 요청할 때만 디스패치. |
-| `architect` | 아니오 | `subagent` | **deny** | **deny** | allow | 설계 및 작업 분해. |
-| `gpt-coder` | 아니오 | `subagent` | allow | ask (분류기 라우팅) | allow | 더 강력한 추론 구현 폴백. |
-| `debugger` | 아니오 | `subagent` | allow | ask (분류기 라우팅) | allow | 재현 및 근본 원인 분석. |
-| `researcher` | 아니오 | `subagent` | **deny** | **deny** | allow | 코드베이스 및 문서 연구. |
-
-쓰기 에이전트의 `bash: ask`는 의도된 값입니다. 플러그인의 `permission.ask` 훅이 알려진 안전 명령은 자동 허용, 위험 명령은 자동 거부, 알 수 없는 명령은 OpenCode/사용자 처리를 위해 남깁니다.
-
-지원되는 모드:
-
-| 모드 | 의미 |
-|---|---|
-| `subagent` | 서브에이전트로만 사용 가능 |
-| `primary` | 기본 에이전트로 사용 가능 |
-| `all` | 기본 및 서브에이전트 모두로 사용 가능 |
+## 에이전트
 
-지원되는 권한 값: `ask`, `allow`, `deny`.
+| 에이전트 | 기본 | 모드 | Edit | Bash | Web | 역할 |
+| --- | --- | --- | --- | --- | --- | --- |
+| `resolver` | yes | `all` | allow | ask | allow | 기본 오케스트레이터. |
+| `coder` | yes | `subagent` | allow | ask | allow | 집중 구현과 검증. |
+| `explorer` | yes | `subagent` | deny | deny | allow | 빠른 읽기 전용 코드베이스 탐색. |
+| `reviewer` | yes | `subagent` | deny | deny | allow | 읽기 전용 검증 갭 리뷰. |
+| `deep-reviewer` | yes | `subagent` | deny | deny | allow | 위험/고영향 변경 리뷰. |
+| `planner` | yes | `subagent` | deny | deny | allow | 필요할 때만 읽기 전용 계획. |
+| `gpt` | no | `all` | allow | ask | allow | GPT 최적화 primary resolver. |
+| `glm` | no | `all` | allow | ask | allow | GLM/ZAI 최적화 primary resolver. |
+| `codex` | no | `all` | allow | ask | allow | 레거시 Codex 최적화 primary resolver. |
+| `architect` | no | `subagent` | deny | deny | allow | 설계/분해 보조. |
+| `gpt-coder` | no | `subagent` | allow | ask | allow | 더 강한 구현 보조. |
+| `debugger` | no | `subagent` | allow | ask | allow | 재현/root-cause 보조. |
+| `researcher` | no | `subagent` | deny | deny | allow | 코드베이스/문서 리서치 보조. |
 
-지원되는 모델 별칭 키: `fast`, `strong`, `mini`, `codex`, `quick`, `deep`, `glm`, `gpt`, `bronze`, `silver`, `gold`, `gpt-bronze`, `gpt-silver`, `gpt-gold`, `glm-bronze`, `glm-silver`, `glm-gold`, 그리고 지원되는 모든 에이전트 이름. 별칭은 `models`에 정의된 경우에만 해석됩니다.
+## 권한
 
-`preserveNative`은 가독성을 위해 허용되지만, 네이티브 `plan`과 `build`는 항상 보존됩니다. 플러그인은 빌트인 OpenCode 에이전트를 절대 다시 쓰지 않습니다.
+resolve 에이전트의 bash는 기본적으로 `ask`입니다. 플러그인의 권한 훅은 흔한 읽기/테스트 명령은 자동 허용하고, force push, shell eval injection, remote script pipe 같은 위험 패턴은 거부합니다. 알 수 없는 명령은 계속 `ask`로 남습니다.
 
-### Resolver 오케스트레이션 규칙
+`autoApprove`는 오래된 설정과의 호환을 위해 허용되지만, 현재 동작은 명시적 에이전트 권한과 명령 분류기가 제어합니다.
 
-Resolver는 컨텍스트 효율적 접근, 체크포인트 실행, 반복 실패 회복을 사용합니다:
+신뢰할 수 없는 저장소에서는 샌드박스나 VM을 사용하세요.
 
-- 계획 전에 작업을 **quick**, **normal**, **deep**, **risky**로 **분류**.
-- **관련 파일만 검사** — 로컬 도구 사용, 광범위한 탐색 지양.
-- 사소한 작업은 직접 편집 적용 — 서브에이전트 불필요.
-- 집중된 파일/동작 지시와 함께 **coder** 디스패치.
-- **가장 저렴한 의미 있는 검증**을 먼저 실행.
-- 문제가 남아있으면 검증 로그에서 재시도; 검증 실패 시 근본 원인을 진단한 뒤 다른 수정 지시로 coder를 다시 디스패치.
-- 연속 실패가 누적되면 완료를 주장하지 않고 차단 사항을 보고; 전체 실패가 많아지면 `architect`로 전략을 전환.
-- 범위가 불명확하고 로컬 read/grep/glob이 불충분할 때만 **explorer** 사용 (내부 서브에이전트, 핵심 경로 아님).
-- 비사소한 변경에 검증 갭이 있을 때만 **reviewer** 사용 (내부 서브에이전트, 핵심 경로 아님).
-- 위험, 보안, 아키텍처, 고영향도 변경에만 **deep-reviewer** 사용 (내부 서브에이전트, 핵심 경로 아님).
-- 해결되거나 차단되면 간결한 증거 요약 반환.
-- `maxParallelSubagents` 역할별 제한을 컨텍스트 효율을 위해 준수.
+## 병렬 서브에이전트
 
----
+`maxParallelSubagents`는 선택 사항입니다. 생략하면 resolver는 soft guidance를 사용합니다. 진짜 독립적인 작업에만 coder를 분산하고, rate limit이 보이면 backoff합니다.
 
-## 선택적 명령어
+값을 설정하면 resolver 프롬프트에 삽입됩니다. 런타임 semaphore는 아닙니다. 변경 후 OpenCode를 재시작하세요. `agents.resolver.prompt`를 직접 지정하면 템플릿된 규칙은 대체됩니다.
 
-`commands: true`로 설정하면 도우미 서브태스크 명령어가 추가됩니다:
+## Context7
 
-| 명령어 | 설명 |
-|---|---|
-| `resolve` | 현재 작업에 대해 `resolver` 에이전트를 엔드투엔드로 실행 |
-| `resolve-code` | 집중된 구현을 위해 `coder` 에이전트를 실행 |
-| `resolve-review` | 읽기 전용 감사를 위해 `reviewer` 에이전트를 실행 |
-
----
-
-## Context7 통합
-
-`context7: true` (기본값)인 경우, 플러그인이 시작 시 [Context7](https://context7.com) MCP 서버를 자동으로 등록합니다:
+`context7: true`이면 `mcp.context7`이 없을 때 Context7 MCP를 등록합니다.
 
 ```json
 {
-  "type": "remote",
-  "url": "https://mcp.context7.com/mcp"
+  "mcp": {
+    "context7": {
+      "type": "remote",
+      "url": "https://mcp.context7.com/mcp"
+    }
+  }
 }
 ```
 
-이를 통해 resolve 에이전트가 OpenCode의 MCP 통합을 통해 Context7 문서 도구에 접근할 수 있습니다 — 수동 MCP 설정이 필요 없습니다.
-
-Context7 등록을 비활성화하려면 (예: 이미 구성되어 있거나 원하지 않는 경우):
+끄려면:
 
 ```json
-{
-  "context7": false
-}
+{ "context7": false }
 ```
 
-OpenCode 설정에 `mcp.context7`이 이미 있는 경우, 플러그인은 덮어쓰지 않습니다.
+## 프로젝트 컨텍스트
 
----
+플러그인은 repo 전체를 프롬프트에 밀어 넣지 않고, 커밋된 프로젝트 컨텍스트 위치만 노출합니다. 감지 대상:
 
-## 최신 상태 유지
+- `HARNESS.md`
+- `AGENTS.md`
+- `.opencode/context`
+- `.claude/context`
+- `context/`
+- `thoughts/`
+- package manager와 흔한 검증 명령
+- TypeScript 프로젝트 여부
 
-> **OpenCode는 마지막으로 다운로드한 버전을 캐시합니다.** 새 릴리스를 받으려면 명시적으로 새로고침해야 합니다.
+resolver는 관련 있는 컨텍스트 문서만 읽도록 지시받습니다.
 
-```sh
-# npm을 통한 업그레이드
-npm install -g opencode-resolve@latest
-
-# OpenCode 캐시 새로고침
-opencode plugin opencode-resolve --global --force
-
-# OpenCode 재시작
-```
-
-그래도 버전이 바뀌지 않으면 OpenCode가 패키지 캐시를 재사용하는 상태입니다. 해당 플러그인 캐시 항목만 hard refresh 하세요:
-
-Linux/macOS:
+## 업그레이드
 
 ```sh
-export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
-rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+npm install -g opencode-resolve@latest
 opencode plugin opencode-resolve@latest --global --force
-node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
 ```
 
-Windows PowerShell:
+특정 버전을 `opencode.json`에서 고정하고 해당 버전 캐시를 새로고침합니다.
 
-```powershell
-$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
-$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
-Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
-opencode plugin opencode-resolve@latest --global --force
-$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
-node -e "console.log(require(process.argv[1]).version)" $Pkg
+```json
+{ "plugin": ["opencode-resolve@<version>"] }
 ```
 
-업그레이드 후 `postinstall`이 `resolve.json`에 추가적 마이그레이션을 실행합니다 — 새 키가 추가되고, 기존 키는 절대 수정되지 않습니다.
-
-### 특정 버전 고정
-
 ```sh
-npm install -g opencode-resolve@0.1.3
-opencode plugin opencode-resolve --global --force
+opencode plugin opencode-resolve@<version> --global --force
 ```
 
----
-
-## 로컬 개발
-
-이 저장소에서:
+## 개발
 
 ```sh
 npm install
-npm run hooks:install
-npm test
-npm run install:local
-```
-
-`install:local`은 플러그인을 빌드하고, OpenCode 전역 플러그인 디렉토리에 링크하며, `~/.config/opencode/resolve.json`이 없으면 생성합니다.
-
-`hooks:install`은 이 checkout의 `core.hooksPath`를 `.githooks`로 설정합니다. 추적되는 훅은 의도적으로 빡세게 동작합니다:
-
-| 훅 | 게이트 |
-|---|---|
-| `pre-commit` | `npm run typecheck`, `npm test`, `npm run coverage` |
-| `pre-push` | 전체 `pre-commit` 게이트와 `npm pack --dry-run`을 통과해야 원격에 반영 |
-
-수동 로컬 설치:
-
-```sh
 npm run build
-mkdir -p ~/.config/opencode/plugins
-ln -sf "$PWD/dist/index.js" ~/.config/opencode/plugins/opencode-resolve.js
+npm test
+npm run coverage
 ```
 
-로컬 플러그인 파일은 OpenCode가 자동으로 로드합니다.
-
----
-
-## 검증
-
-일반 검사 실행:
+이 checkout을 로컬 설치:
 
 ```sh
-npm run typecheck
-npm test
-npm run coverage
-npm run build
+npm run install:local
 ```
 
-테스트 스위트는 빌드된 플러그인을 실행하고 기본 에이전트 주입, `autoApprove` 동작, 모델 별칭, 파일 설정, 플러그인 옵션 재정의, 선택적 명령어, Context7 보존, 네이티브 `plan`/`build` 보존을 검증합니다.
-
-게시 전:
+Git hook:
 
 ```sh
-npm run typecheck
-npm test
-npm run coverage
-npm audit --audit-level=moderate
-npm publish --dry-run
+npm run hooks:install
 ```
 
-`npm pack`과 `npm publish`는 `prepack` 스크립트를 통해 먼저 `npm test`를 실행합니다.
-
----
+테스트는 에이전트 주입, 설정 로딩, 모델 별칭, 권한, 선택적 명령어, Context7 보존, 네이티브 에이전트 보존, postinstall 동작을 검증합니다.
 
 ## 릴리스
 
-릴리스는 버전 태그가 푸시될 때 GitHub Actions에 의해 게시됩니다.
-
-필요한 저장소 시크릿:
-
-| 시크릿 | 설명 |
-|---|---|
-| `NPM_TOKEN` | 게시 권한이 있는 npm 자동화 토큰 |
-
-태그 릴리스 흐름:
+1. `package.json` 버전을 올립니다.
+2. `npm run prepush`를 실행합니다.
+3. 커밋하고 태그를 푸시합니다.
 
 ```sh
-npm version patch
-git push origin main --follow-tags
+git add package.json package-lock.json README.md README.ko.md
+git commit -m "release: vX.Y.Z"
+git tag vX.Y.Z
+git push origin main --tags
 ```
 
-GitHub Actions에서 `Publish to npm` 워크플로우를 수동으로 실행하고 `patch`, `minor`, `major` 또는 특정 버전을 선택할 수도 있습니다.
-
-릴리스 워크플로우는 `npm ci`, `npm run typecheck`, `npm test`, `npm publish --access public --provenance`를 실행합니다.
-
----
+publish workflow가 테스트 후 npm에 배포합니다.
 
 ## 설계 규칙
 
-- 네이티브 `plan` 또는 `build` 에이전트를 덮어쓰지 않음.
-- 핵심 경로는 고정: `resolver`(컨텍스트 효율적 플래너/판정자) → `coder`(구현자).
-- 내부 전문가 서브에이전트(`explorer`, `reviewer`, `deep-reviewer`)는 OpenCode 네이티브 서브에이전트로 기본 주입 — OpenCode의 컴포지션 철학을 계승 — 하지만 기본 실행 경로가 아니며 사용자 대면 기본 역할이 아님.
-- Resolver는 좁은 범위에 로컬 read/grep/glob을 선호; 범위가 불명확할 때만 `explorer` 디스패치.
-- Resolver는 비사소한 변경에 검증 갭이 있을 때만 `reviewer` 디스패치.
-- Resolver는 위험, 보안, 아키텍처, 고영향도 변경에만 `deep-reviewer` 디스패치.
-- Reviewer와 deep-reviewer는 읽기 전용 — 수정은 항상 `coder` 또는 `resolver`를 거침.
-- 반복 검증 실패는 진단, 다른 수정 전략, 차단 사항 보고로 이어져야 함. 대규모 작업은 검증된 체크포인트로 분해됨.
-- Resolver는 컨텍스트 효율을 위해 `maxParallelSubagents`를 준수.
-- 편집 전에 검색하고 검사. 가장 작은 올바른 변경. 실용적인 경우 검증.
-- 필요한 파일만 읽음. 광범위한 탐색 지양. 대상 검증, 전체 스위트 아님.
-
----
+- OpenCode 네이티브 에이전트를 기본적으로 대체하지 않습니다.
+- 기본 설정은 작게 유지합니다.
+- bash 권한은 보수적으로 유지합니다.
+- 마이그레이션은 추가적으로만 수행합니다.
+- 명확한 이점이 없으면 런타임 의존성을 늘리지 않습니다.
 
 ## 라이선스
 
-[MIT](./LICENSE)
+MIT