@tienne/gestalt 0.120.1 → 0.121.0

package/dist/plugin/skills/_shared/cli-launcher.md

@@ -1,45 +1,56 @@
-# gestalt CLI를 어떻게 부르는지 먼저 판정한다
+# 플러그인과 같은 버전의 CLI 실행
 
-이 문서는 여러 스킬이 공유하는 규칙이다. `gestalt` CLI(`humanize-scan`, `pr`, `review-loop`, `setup` 등)를 셸로 부르는 단계에서 적용한다.
-
-## 왜 필요한가
-
-플러그인으로 설치되면 호스트가 복사해 가는 건 `plugin/` 아래뿐이다. `bin/`도 `package.json`도 `node_modules`도 그 안에 없다. 그래서 스킬 본문에 `pnpm tsx bin/gestalt.ts ...`만 적혀 있으면 게슈탈트 레포 밖에서는 그 명령이 원리상 안 돈다.
-
-그때 읽는 쪽이 하는 말이 "의존성이 안 깔려 있어서 못 돌립니다"다. 실제로는 전역 `gestalt`가 깔려 있어 돌릴 수 있는데도 스킬이 적어준 형태 하나가 막혀서 포기한다. 어투 검사처럼 **필수 검사인 단계가 이렇게 조용히 건너뛰어지면** 막으려던 문장이 그대로 나간다.
-
-그래서 호출 형태를 스킬마다 박아두지 않고 한 번 판정해서 쓴다.
-
-## 판정
-
-CLI를 처음 부르기 전에 한 번 돌린다.
+스킬 본문의 `gestalt ...` 예시는 아래 런처로 실행한다. 전역 `gestalt` 설치는 필요하지 않다.
+이 문서가 있는 디렉토리(`.../skills/_shared`)에서 두 단계 위가 플러그인 루트다.
+런처는 그 아래 `scripts/gestalt-cli.mjs`에 있다. 예를 들어 문서가 `/cache/gestalt/skills/_shared/cli-launcher.md`이면 런처는 `/cache/gestalt/scripts/gestalt-cli.mjs`다.
+현재 작업 레포의 동명 파일이나 `bin/gestalt.ts`를 찾아 실행하지 않는다.
 
 ```bash
-if gestalt --version >/dev/null 2>&1; then
-  echo "OK gestalt"
-elif pnpm tsx bin/gestalt.ts --version >/dev/null 2>&1; then
-  echo "OK pnpm"
-else
-  echo "MISSING"
-fi
+node "/플러그인/절대경로/scripts/gestalt-cli.mjs" humanize-scan --file "$scanTmp/report.md" --register report
 ```
 
-- **`OK gestalt`** — 스킬 본문의 예시를 그대로 쓴다. 본문은 전부 `gestalt ...` 형태로 적혀 있다.
-- **`OK pnpm`** — 게슈탈트 레포 안이라는 뜻이다. 그 뒤로 모든 호출의 `gestalt`를 `pnpm tsx bin/gestalt.ts`로 바꿔 쓴다.
-- **`MISSING`** — 아래 "없을 때"를 따른다.
-
-한 번 확인하고 그 뒤로는 같은 형태를 쓴다. 단계마다 다시 찌르지 않는다.
+루트 `skills` 심링크로 읽었다면 먼저 이 문서 경로를 `realpath`로 풀고 부모 경로를 계산한다.
+런처는 자신의 위치를 기준으로 다음을 수행한다.
+
+1. `.codex-plugin/plugin.json`에서 설치된 플러그인의 버전을 읽는다. 버전을 모르면 중단한다.
+2. 로컬 의존성이 있는 게슈탈트 개발 체크아웃이면 그 TypeScript 엔트리를 사용한다.
+   같은 버전의 npm 설치본 안에 빌드된 CLI가 있으면 그 엔트리를 사용한다.
+   소스만 있고 의존성이 없는 플러그인 설치본은 다음 npm 해석 단계로 진행한다.
+3. 설치된 복사본이면 npm 캐시에서 정확히 같은 `@tienne/gestalt@<version>`을 해석하고
+   캐시가 없으면 같은 버전을 다운로드한다. 패키지 이름과 버전, 실제 CLI 버전을 확인한다.
+4. 실제 명령은 원래 작업 디렉토리에서 실행하며 stdin, 인자, 종료 코드를 보존한다.
+   터미널 Ctrl-C는 자식도 함께 받으므로 중복 전달하지 않는다. 래퍼 pid만 지정해 취소할 때는 SIGTERM을 사용한다.
+   SIGTERM과 SIGHUP은 npm 실행과 버전 확인, 실제 명령에 전달하고 자식 종료를 기다린다.
+   npm 실행과 버전 확인 중에는 SIGTERM이나 SIGHUP을 보낸 뒤 5초간 자식이 끝나지 않으면 SIGKILL을 보낸다.
+   SIGKILL은 직접 실행한 프로세스 하나에만 보낸다. npm이 신호를 자식에게 넘기지 못하고 멈추면 설치 스크립트 같은 자손은 남을 수 있다.
+   이 두 단계에서 SIGINT를 받으면 SIGINT를 다시 전달하지 않고 2초 동안 자식이 스스로 끝나기를 기다린다.
+   그래도 남아 있으면 SIGTERM을 보낸다. 래퍼 pid만 받은 SIGINT도 이 경로로 정리된다.
+   취소한 뒤에는 임시 디렉토리를 지운다. 오프라인 해석이나 버전 확인이 실패하거나 시간을 넘기면 같은 버전을 온라인으로 한 번 더 시도한다.
+   온라인 시도도 실패하거나 시간을 넘기면 사용자 취소가 아닌 오류로 알린다.
+
+npm 해석은 별도의 임시 디렉토리에서 한다. 작업 레포의 로컬 패키지나 다른 버전의 전역 CLI를
+선택하지 않으며 `latest`로 떨어지지 않는다.
+npm으로 CLI 패키지를 받는 동안에는 알려진 비밀 환경 변수를 npm에 넘기지 않는다.
+모델 공급자 접두어(`ANTHROPIC_`, `OPENAI_` 등)로 시작하는 변수와 클라우드, GitHub의 인증 변수(`AWS_SECRET_ACCESS_KEY`, `GITHUB_TOKEN` 등)가 여기에 든다.
+이름이 `_API_KEY`, `_PASSWORD`, `_SECRET`, `_AUTH_TOKEN` 등으로 끝나는 변수도 대소문자 구분 없이 제외한다. 이 필터는 알려진 이름과 패턴만 검사한다.
+`NPM_*`, `NODE_AUTH_TOKEN`과 `npm_config_*`는 보존한다. 사용자 `.npmrc`와 전역 설정 파일에서 `${NAME}` 또는 `${NAME?}`으로 참조한 변수도 인증에 필요하므로 예외로 남긴다.
+사용자 설정 경로는 `npm_config_userconfig` 또는 홈의 `.npmrc`다. 전역 설정은 `npm_config_globalconfig` 또는 npm prefix의 `etc/npmrc`에서 읽는다. prefix를 지정하지 않았으면 Node 설치 경로를 기준으로 한다.
+프록시와 CA 설정은 유지하며 최종 CLI에는 원래 환경을 전달한다. 처음 실행할 때 Node.js >=22와 npm, 네트워크가 필요할 수 있다.
+셸 함수가 필요하면 명령을 문자열 변수로 합치지 말고 인자를 그대로 넘긴다.
 
-**쓰려는 하위 명령이 최근에 생긴 것이면 그 하위 명령으로 찌른다.** `--version`은 설치본이 뒤처져 하위 명령만 없는 경우를 못 잡는다. 그 상태로 라운드를 돌다 `unknown option`으로 죽으면 앞선 단계가 통째로 헛돈다.
-
-**명령을 변수에 담아 함수로 넘기지 않는다.** zsh는 인용 안 한 변수 전개에서 단어 분리를 안 해 `$cmd`가 통째로 명령 이름이 된다. 실제로 깔려 있어도 `MISSING`이 나온다. 같은 코드가 bash에서는 도는 탓에 눈으로는 안 걸린다.
-
-## 없을 때
+```bash
+gestalt() { node "/플러그인/절대경로/scripts/gestalt-cli.mjs" "$@"; }
+```
 
-`MISSING`이면 **그 단계가 필수 검사인지로 갈린다.**
+셸 함수는 `xargs`의 외부 실행 파일이 아니다. **파이프라인과 `xargs`를 포함한 모든 예시**에서도
+`gestalt`를 `node`와 런처의 절대 경로로 치환한다. 함수 선언만 하고 `xargs gestalt`를 실행하지 않는다.
 
-- **필수 검사면 멈춘다.** 어투 검사(`humanize-scan`)가 그렇다. 검사를 못 돌린 걸 통과로 읽으면 검사가 없는 것과 같다. 무엇을 못 돌렸는지와 `npm i -g @tienne/gestalt`를 함께 알리고 사용자가 그대로 진행할지 정하게 둔다.
-- **판정에 쓰는 수를 그 명령이 내면 멈춘다.** `review-loop`처럼 모든 단계가 한 명령에 매달린 자리다.
-- **그 밖에는 알리고 건너뛴다.** 없다고 스킬 전체를 막을 이유는 없다. 대신 완료 보고에 어느 단계를 안 돌렸는지 적는다.
+```bash
+find "$scanTmp" -name '*.md' -print0 | xargs -0 node "/플러그인/절대경로/scripts/gestalt-cli.mjs" humanize-scan --register chat
+```
 
-어느 쪽이든 **직접 흉내내지 않는다.** 스캔 결과를 지어내거나 룰북을 눈으로 훑어 "깨끗합니다"로 답하지 않는다 ([`tool-availability.md`](./tool-availability.md)와 같은 규칙이다).
+`humanize-scan`의 종료 코드 `10`은 검사 실행 실패가 아니라 탐지 없음이다. 그 명령의 계약대로 읽는다.
+`xargs`는 자식의 종료 코드 `10`을 그대로 전달하지 않는다. 검사 판정에는 파일별 출력의 `EXIT=` 값을 사용한다. 단일 파일처럼 파일별 표지가 없는 호출에서 종료 코드가 필요하면 `xargs` 대신 런처를 직접 실행한다.
+런처를 찾지 못했거나 버전 해석이 실패하면 필수 검사와 그 수치에 의존하는 단계는 중단하고 오류를 알린다.
+그 밖의 선택적 단계는 실행하지 못한 단계를 완료 보고에 적는다. 검사 결과를 직접 지어내거나
+다른 버전의 실행을 같은 결과로 보고하지 않는다. MCP 도구는 [`tool-availability.md`](./tool-availability.md)를 따른다.

package/dist/plugin/skills/_shared/host-runtime.md

@@ -0,0 +1,47 @@
+# 호스트별 도구 호출
+
+스킬 본문의 `Agent`, `Explore`, `AskUserQuestion`, `TaskCreate`는 Claude Code 표기다.
+실행 전에 이 문서를 읽고 **현재 호스트가 실제로 제공한 도구**로 옮긴다. Codex에서는 이 문서가
+다른 문서의 Claude 전용 타입, 모델 필수 인자, `sonnet` 폴백 지시보다 우선한다.
+MCP 도구의 입력과 2-Call 제출 계약은 호스트가 바뀌어도 그대로다.
+
+모든 호스트에서 스킬의 `gestalt ...` 예시는 먼저 [CLI 실행 지침](./cli-launcher.md)을 읽고
+버전 고정 런처로 실행한다. 개별 스킬에 이 링크가 없어도 적용하며 파이프라인과 `xargs` 호출도 포함한다.
+
+## Codex
+
+`ges_status {}`의 `hostClient`가 `codex`이면 Codex 모델 기본값은 `inherit`다.
+`client`는 실행 컨텍스트를 기록할 파일의 선택이라 `both`일 수도 있다. 이 값을 호스트 판정과 혼동하지 않는다.
+`hostClient`가 없는 이전 서버와 연결돼 있어도 현재 호스트가 Codex이면 서버의 Claude 별칭을 그대로 모델 인자로 보내지 않는다. `fable`, `haiku`, `sonnet`, `opus`는 이때 `inherit`로 취급한다. 명시한 다른 모델 ID는 유지한다. 이전 서버에는 `ges_execute` 요청의 `client: "codex"`도 명시해 컨텍스트 기록 대상을 맞추고 플러그인 갱신을 안내한다.
+사용자가 명시한 모델 ID와 실제 도구의 지원 여부를 우선한다. Claude 모델 별칭을 GPT 모델로 추측해서 바꾸지 않는다.
+실행 태스크의 자동 `task.model`이 `haiku`, `sonnet`, `opus`이면 기존 tier 힌트다. 각각 `ges_status`의
+`tierModels.frugal`, `tierModels.standard`, `tierModels.frontier`로 해석한 뒤 아래 모델 규칙을 적용한다.
+명시적인 Codex 모델 ID는 다시 매핑하지 않는다.
+
+| 본문의 표기 | Codex에서 수행할 일 |
+|---|---|
+| `Agent`의 `gestalt:` 에이전트 타입 | [`agent-delegation.md`](./agent-delegation.md)의 Explore 폴백 프롬프트를 사용해 범용 서브에이전트 안에서 `ges_agent get`으로 페르소나를 받는다. 해당 문서의 절차대로 룰북 디렉토리를 절대 경로로 풀어 프롬프트에 직접 넣는다. 경로를 못 풀었으면 그 사실을 보고한다. `subagent_type`은 전달하지 않는다. |
+| `Explore` | 읽기 전용 조사를 위임한다. 실제 읽기 전용 타입이 없으면 파일 수정, 커밋, 외부 전송 금지를 프롬프트에 명시하고 도구로 강제된 제한이라고 말하지 않는다. |
+| `Agent.model`, `reasoningModel`, `tierModels` | `inherit`이면 모델 인자를 생략한다. 명시 모델 ID는 스폰 도구가 받는 경우에만 전달한다. |
+| `effort` | 해당 도구가 받는 `reasoning_effort` 또는 동등한 인자로 옮긴다. 지원하지 않는 인자는 보내지 않는다. |
+| `AskUserQuestion` | 현재 모드의 질문 도구가 있으면 쓰고, 없으면 일반 대화로 묻는다. 필수 답변과 승인 없이 종속 단계를 실행하지 않는다. |
+| `TaskCreate`, `TaskUpdate`, `TaskList` | 호스트의 진행 계획 도구가 있으면 쓰고, 없으면 짧은 진행 메시지로 알린다. 진행 패널 부재는 작업을 막지 않는다. |
+| `Bash`, `Read`, `Grep`, `Glob`, `Edit`, `Write` | 호스트의 셸, 파일 읽기, 검색, 패치 도구를 사용한다. 명령 인자와 쓰기 범위는 그대로 지킨다. |
+
+`spawn_agent`, `send_message`, `followup_task`, `wait_agent`가 제공되면 그 도구로 위임하고 결과를 기다린다.
+스폰 스키마가 `fork_turns: "all"`일 때 모델 재지정을 금지하면, 상속 모델은 그대로 두고
+모델이나 effort를 명시해야 할 때만 `fork_turns: "none"`으로 필수 맥락과 절대 경로를 직접 전달한다.
+이 매개변수가 없는 호스트에는 그 인자를 보내지 않는다. 특정 Codex 버전의 도구명을 필수 조건으로 삼지 않는다.
+
+스폰 도구가 명시한 모델을 거절했을 때만 아래 순서로 재시도한다.
+`ges_status.hostClient`가 `codex`인 새 서버에서는 `reasoningModelFallback`이 `inherit`가 아니면 그 값으로 한 번 재시도한다. `hostClient`가 없는 이전 서버에서는 Claude 기본 별칭이 아닌 폴백 ID만 사용한다. 그것도 거절되거나 별도 폴백 ID가 없으면 세션 상속으로 한 번 재시도하고 끝낸다. 서버 기본값인 Claude 별칭으로 재시도하지 않는다. `inherit`를 지원 모델 이름처럼 전달하지 않는다. 모델 선택을 지원하지 않는 호스트에서는
+상속으로 실행하고 완료 보고에 모델 지정이 적용되지 않았음을 적는다.
+
+서브에이전트가 없으면 메인이 `ges_agent get`으로 페르소나를 받아 직접 수행할 수 있다.
+이때 컨텍스트가 메인에 실렸음을 완료 보고에 밝힌다. **독립된 판정자가 필요한 단계**는 `doubt`, review의 3.5 `continuity-judge`, 3.7 `suggestion-verifier`다. 이 셋은 메인의 자기 검토로 대체하지 않는다. 제안 검증을 못 돌렸으면 review 지침에 따라 미실행을 알린다. 정합 심급을 못 돌렸으면 그 사실을 적고 Pass를 승인으로 게시하지 않는다. MCP 자체의 부재는
+[`tool-availability.md`](./tool-availability.md)를 따르며 도구 없이 세션이나 검사 결과를 만들지 않는다.
+
+## Claude Code와 그 밖의 호스트
+
+Claude Code는 기존 `Agent` 타입과 모델 별칭을 그대로 쓴다. `inherit`를 명시했다면 모델 인자를 생략한다.
+Grok 등 다른 호스트도 실제 제공된 도구에 맞춰 같은 의미로 옮기며 지원 여부를 모르는 도구 이름이나 모델을 만들지 않는다.

package/dist/plugin/skills/agent/SKILL.md

@@ -22,6 +22,8 @@ outputs:
 
 # Agent Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 Invoke any Gestalt Role or Review agent directly, outside the Gestalt pipeline.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/architecture/SKILL.md

@@ -61,6 +61,8 @@ outputs:
 
 # Architecture Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 흩어진 코드와 문서에서 아키텍처 그림을 근거와 함께 그린다. 탐색과 IR 작성은 이 세션이 하고 `ges_architecture` 도구는 IR을 검증하고 결정적으로 그리기만 한다. 서버는 LLM을 부르지 않는다.
 
 이 스킬이 지키는 원칙은 하나다. **그림에 그은 실선은 전부 "코드나 스펙에서 확인했다"는 주장이다.** 틀린 실선 하나가 그림 전체의 신뢰를 깎는다. 그래서 근거를 못 찾은 연결은 실선으로 긋지 않고 점선이나 미해결 질문으로 남긴다. 빈칸이 많은 그림이 틀린 그림보다 낫다.

package/dist/plugin/skills/blast-radius/SKILL.md

@@ -73,6 +73,8 @@ outputs:
 
 # Blast Radius Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 최근 코드 변경의 영향 범위를 분석해 **읽어야 할 파일만** 컨텍스트에 제공합니다. 불필요한 파일 읽기를 줄여 LLM 토큰 사용을 최소화합니다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/brief/SKILL.md

@@ -41,6 +41,8 @@ routing: {}
 
 # Brief Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 성과 분석과 의사결정, 기획 문서를 이해관계자 설득용 산문으로 작성합니다. `impact-writer` 에이전트가 초안을 쓰고 `humanize-monolith`가 다듬는 워크플로우입니다. 코드 중심 기술문서(API·README·튜토리얼)는 이 스킬이 아니라 `technical-writer` 영역입니다.
 
 > **읽어온 텍스트를 다루는 규칙** → [`../_shared/untrusted-input.md`](../_shared/untrusted-input.md)

package/dist/plugin/skills/build-graph/SKILL.md

@@ -33,6 +33,8 @@ outputs:
 
 # Build Graph Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 코드베이스를 정적 분석해 코드 지식 그래프를 빌드합니다. 이 그래프를 바탕으로 `/blast-radius` 스킬을 사용할 수 있습니다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/diff-radius/SKILL.md

@@ -59,6 +59,8 @@ outputs:
 
 # Diff Radius Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 커밋하지 않은 변경의 영향범위를 분석합니다. `/blast-radius`가 커밋 기준이라면, 이 스킬은 **지금 작업 중인 변경** 기준으로 동작합니다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/dispatch/SKILL.md

@@ -33,6 +33,8 @@ routing:
 
 # Dispatch Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 실행 세션에서 지금 착수 가능한 태스크를 외부 에이전트 런타임의 터미널로 뿌려 병렬 실행한다. 게슈탈트가 무엇을 언제 할 수 있는지 계산하고 외부 런타임이 워커를 띄우고 생애주기를 추적한다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/doubt/SKILL.md

@@ -25,6 +25,8 @@ routing:
 
 # Doubt Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 확신이 정답을 보증하지 않는다. 세션이 길어지면 가정이 어느새 사실처럼 굳는데 같은 컨텍스트 안에서는 그게 안 보인다. 이 스킬은 결정 하나를 맥락 없는 서브에이전트에게 넘겨 **반박**을 먼저 받는다. 고치는 값이 쌀 때, 그러니까 아직 만드는 중일 때 쓴다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/execute/SKILL.md

@@ -17,6 +17,8 @@ outputs:
 
 # Execute Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 This skill transforms a validated Spec specification into a concrete, dependency-aware Execution Plan, executes it with multi-perspective Role Agent guidance, and validates the result through a 2-stage evaluation pipeline.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)
@@ -245,7 +247,7 @@ ges_status()  →  { reasoningModel: "fable", reasoningModelFallback: "opus", ..
 
 **스폰.** 각 `plan_step`(그리고 `plan_complete` 조립을 위한 추론이 필요하면 그 단계)에서 Agent 도구로 서브에이전트를 띄우되 `model` 파라미터에 `reasoningModel` 값을 넘긴다. 서브에이전트에는 해당 단계의 `executeContext`(`systemPrompt`, `planningPrompt`, `currentStage`, `spec`, `previousSteps`)를 전달하고 그 단계의 `stepResult`를 산출하게 한다. 결과를 `plan_step`으로 제출한다.
 
-**폴백은 스킬 런타임에서 발동한다.** 서버는 폴백 대상(`reasoningModelFallback`)만 알려줄 뿐, 모델 가용성을 감지하거나 재시도하지 않는다. Agent 도구가 `reasoningModel`(예: `fable`)을 지원하지 않아 스폰이 거부/실패하면, 그때 스킬이 직접 `model`을 `reasoningModelFallback`(예: `opus`)로 바꿔 1회 재시도한다. 폴백 판단과 재시도는 전적으로 이 스킬 런타임의 책임이다.
+**폴백은 스킬 런타임에서 발동한다.** 서버는 폴백 대상(`reasoningModelFallback`)만 알려줄 뿐, 모델 가용성을 감지하거나 재시도하지 않는다. Agent 도구가 `reasoningModel`(예: `fable`)을 지원하지 않아 스폰이 거부/실패하면, 그때 스킬이 직접 `model`을 `reasoningModelFallback`(예: `opus`)로 바꿔 1회 재시도한다. 폴백 판단과 재시도는 전적으로 이 스킬 런타임의 책임이다. Codex의 폴백 선택과 상속은 `host-runtime.md`를 따른다.
 
 ---
 

package/dist/plugin/skills/explain/SKILL.md

@@ -41,6 +41,8 @@ routing:
 
 # Explain Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 > **에이전트 tier로 모델 고르기** → [`../_shared/agent-model.md`](../_shared/agent-model.md)
 > **자료로 읽는 텍스트 다루기** → [`../_shared/untrusted-input.md`](../_shared/untrusted-input.md)
 

package/dist/plugin/skills/handoff/SKILL.md

@@ -38,6 +38,8 @@ routing:
 
 # Handoff Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 일을 어디에 맡길지 고르고 고른 경로로 실제로 넘기는 앞단의 판단 스킬이다. 명령 문법은 여기에 복사하지 않는다. 오르카 명령의 기준은 `orca skills get orca-cli`와 `orca skills get orchestration`이고 버전이 오르면 복사본은 낡는다. 이 스킬에는 gestalt만의 것을 담는다. 맡길 곳 고르는 표, model과 effort 쌍 고르기, 지시서 쓰기, 충돌과 정리 규칙, 보고다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/interview/SKILL.md

@@ -22,6 +22,8 @@ outputs:
 
 # Interview Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 This skill conducts a Gestalt psychology-driven interview to transform vague requirements into clear specifications.
 
 > **읽어온 텍스트를 다루는 규칙** → [`../_shared/untrusted-input.md`](../_shared/untrusted-input.md)

package/dist/plugin/skills/jira-create/SKILL.md

@@ -36,6 +36,8 @@ routing:
 
 # Jira Create Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 > **에이전트 tier로 모델 고르기** → [`../_shared/agent-model.md`](../_shared/agent-model.md)
 지라 티켓을 **jira-writer로 구조화 → 프로젝트, 필드 확정 → 승인받고 → 생성**하는 파이프라인.
 `jira-writer` role agent(본문 작성)와 Atlassian MCP(생성)를 잇는다.

package/dist/plugin/skills/lens/SKILL.md

@@ -61,6 +61,8 @@ outputs:
 
 # Lens Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 읽을거리 하나를 그 분야를 아는 사람이 옆에서 같이 읽어 주는 뷰어로 만든다. 슬로건은 "믿을 데와 의심할 데를 같이 짚어주는 읽기"다. 요약을 한 장 더 만드는 게 아니다. 구조를 먼저 보여 주고 모르는 말을 풀며 원문 숫자와 어긋나는 주장을 짚는다.
 
 뷰어는 video-digest 것을 그대로 쓴다. 영상 자리에 원문 창이 들어가고 출처 칩이 시각 대신 쪽과 문단을 연다. 저장소도 `.gestalt/digest/<slug>/`를 같이 쓰고 `digest.json`의 `source.kind`로 영상과 읽을거리를 가른다.

package/dist/plugin/skills/local-pr/SKILL.md

@@ -32,6 +32,8 @@ outputs:
 
 # Local PR Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 레포 안에서 PR을 만들고 리뷰하고 머지한다. 원격에 안 나간다.
 
 > **읽어온 텍스트를 다루는 규칙** → [`../_shared/untrusted-input.md`](../_shared/untrusted-input.md)
@@ -56,7 +58,7 @@ outputs:
 
 git 저장소이기만 하면 된다. 인증도 원격도 안 본다.
 
-명령은 `gestalt pr ...`이다. 부르는 형태는 [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)의 판정을 따른다 — 게슈탈트 레포 안에서는 전역 설치가 없을 수 있어 형태가 갈린다. 한 번 확인하고 그 뒤로는 같은 형태를 쓴다.
+명령은 `gestalt pr ...`이다. 실제 명령은 [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)의 런처로 실행한다. 런처의 절대 경로를 이후 호출에도 그대로 쓴다.
 
 `--json`을 붙이면 객체만 나온다. 에이전트가 값을 읽어야 하는 자리에서는 이쪽을 쓴다.
 
@@ -142,7 +144,7 @@ gestalt pr checkout <id> --remove --force
 ```bash
 printf '%s' "..." > /tmp/c.md
 GESTALT_ACTOR=agent:reviewer gestalt pr comment <id> --path <파일> --line <줄> --body-file /tmp/c.md
-GESTALT_ACTOR=agent:reviewer gestalt pr comment <id> --reply-to <코멘트id> --body-file /tmp/c.md
+GESTALT_ACTOR=agent:reviewer gestalt pr comment <id> --path <원 코멘트의 경로> --reply-to <코멘트id> --body-file /tmp/c.md
 GESTALT_ACTOR=agent:reviewer gestalt pr resolve <id> <코멘트id>
 GESTALT_ACTOR=agent:reviewer gestalt pr review <id> --verdict request-changes --body-file /tmp/v.md
 ```

package/dist/plugin/skills/market-scan/SKILL.md

@@ -35,6 +35,8 @@ outputs:
 
 # Market Scan Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 제품 지형 조사만 한다. 같은 문제를 서로 다르게 푼 제품을 찾아 규모와 유형으로 묶고 `research.json`의 `productCandidates`와 `references`까지 채운다. 화면을 열거나 캡처하지 않는다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/pr/SKILL.md

@@ -31,10 +31,12 @@ routing:
 
 # PR Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 > **에이전트 tier로 모델 고르기** → [`../_shared/agent-model.md`](../_shared/agent-model.md)
 >
 > **`gestalt` CLI를 부르는 형태** → [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)
-> 본문의 셸 예시는 `gestalt ...`입니다. 게슈탈트 레포 안에서는 `pnpm tsx bin/gestalt.ts ...`로 바꿔 부릅니다. description 어투 검사가 이 CLI에 매달려 있고 **그건 필수 검사라 못 돌리면 멈춥니다.**
+> 본문의 셸 예시는 `gestalt ...`입니다. 설치 위치의 버전 고정 런처로 실행합니다. description 어투 검사가 이 CLI에 매달려 있고 **그건 필수 검사라 못 돌리면 멈춥니다.**
 레포의 PR 규칙을 먼저 탐색하고 미니 인터뷰로 컨텍스트를 수집한 뒤, diff를 분석해 레포 규칙에 맞는 PR description을 생성하고 `gh pr create`로 제출합니다.
 
 ## 사용 방법
@@ -304,19 +306,9 @@ echo "$scanTmp"
 
 윤문된 제목과 본문을 합쳐 `"$scanTmp/description.md"`에 씁니다.
 
-```bash
-if gestalt --version >/dev/null 2>&1; then
-  echo "OK gestalt"
-elif pnpm tsx bin/gestalt.ts --version >/dev/null 2>&1; then
-  echo "OK pnpm"
-else
-  echo "MISSING"
-fi
-```
-
-`OK pnpm`이면 아래 호출의 `gestalt`를 `pnpm tsx bin/gestalt.ts`로 바꿔 부릅니다.
-
-**`MISSING`이면 검사를 건너뛰지 않고 멈춥니다.** 못 돌린 걸 통과로 읽으면 검사가 없는 것과 같습니다. `npm i -g @tienne/gestalt`를 함께 알리고 그대로 진행할지 사용자가 정하게 둡니다.
+[`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)에 따라 이 플러그인의 버전 고정 런처를 사용한다.
+아래 `gestalt` 호출은 `node`와 런처의 절대 경로로 바꿔 실행한다. 이후 단계와 파이프라인에도 같은 규칙을 적용한다.
+런처 실행이 실패하면 필수 검사를 건너뛰지 않고 오류를 알린 뒤 멈춘다. 전역 CLI 설치를 요구하거나 다른 버전으로 대신 실행하지 않는다.
 
 ```bash
 gestalt humanize-scan --file "$scanTmp/description.md" --register report

package/dist/plugin/skills/presentation/SKILL.md

@@ -35,6 +35,8 @@ routing:
 
 # Presentation Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 > **에이전트 tier로 모델 고르기** → [`../_shared/agent-model.md`](../_shared/agent-model.md)
 발표 자료를 **콘텐츠 먼저, 디자인 나중** 순서로 만드는 파이프라인.
 `presentation-writer`(슬라이드 콘텐츠)와 `presentation-designer`(Reveal.js HTML)를 잇고 산출 전 승인 단계를 둔다.

package/dist/plugin/skills/research/SKILL.md

@@ -52,6 +52,8 @@ outputs:
 
 # Research Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 경쟁사와 시장 레퍼런스를 조사하고 역기획까지 해서 기획 판단의 근거를 만든다. 조사와 `research.json` 작성은 이 세션이 하고 `ges_research` 도구는 출처 상태 확인, 개인정보 치환, 검증, 렌더만 한다. 서버는 LLM을 부르지 않는다.
 
 이 스킬이 지키는 원칙은 하나다. **관찰과 해석을 나눈다.** 화면에서 보이는 것과 숫자는 출처를 댈 수 있어야 한다. 추론과 효과 예측은 문장 끝에 `(해석)`을 붙인다. 근거를 못 찾은 칸은 그럴싸하게 채우지 않고 확인 못함으로 적는다. 빈칸이 있는 결과가 지어낸 결과보다 낫다.

package/dist/plugin/skills/reverse-plan/SKILL.md

@@ -26,6 +26,8 @@ outputs:
 
 # Reverse Plan Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 이미 모은 화면에서 한 걸음 더 나가 레퍼런스가 그 화면을 만든 이유를 쓴다. `reasons`(섹션 5)만 채운다. 새 화면을 캡처하지 않는다.
 
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)

package/dist/plugin/skills/review/SKILL.md

@@ -52,6 +52,8 @@ routing: {}
 
 # Review Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 execute 세션 없이 PR, 브랜치, 커밋의 변경사항을 직접 리뷰 파이프라인에 주입해 검토합니다.
 변경 파일을 수집하고 리뷰 에이전트(보안, 성능, 품질, 주석, 문서와 문자열이 바뀌었으면 라이팅, 스킬이나 에이전트 문서가 바뀌었으면 하네스)로 다각도 리뷰한 뒤(**결함 심급**), `continuity-judge`가 변경 전체의 목표 정합성과 일관성을 감독하고(**정합 심급**), `suggestion-verifier`가 리뷰어 제안을 반영하면 무엇이 깨지는지 게시 전에 확인한 뒤(**제안 검증**), Pass/Block 판정과 마크다운 리포트를 생성합니다. 리뷰 대상이 PR이면 — GitHub PR이든 로컬 `gestalt pr` PR이든 — `code-review-writer` 에이전트가 작성한 인라인 코멘트로 그 PR에 게시까지 이어집니다.
 
@@ -61,7 +63,7 @@ execute 세션 없이 PR, 브랜치, 커밋의 변경사항을 직접 리뷰 파
 > **도구가 없을 때** → [`../_shared/tool-availability.md`](../_shared/tool-availability.md)
 >
 > **`gestalt` CLI를 부르는 형태** → [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)
-> 본문의 셸 예시는 전부 `gestalt ...`입니다. 게슈탈트 레포 안에서는 `pnpm tsx bin/gestalt.ts ...`로 바꿔 부릅니다. 어투 검사(1.5, 4.5, 4.7단계)가 이 CLI에 매달려 있고 **그 셋은 필수 검사라 못 돌리면 멈춥니다.**
+> 본문의 셸 예시는 전부 `gestalt ...`입니다. 설치 위치의 버전 고정 런처로 실행합니다. 어투 검사(1.5, 4.5, 4.7단계)가 이 CLI에 매달려 있고 **그 셋은 필수 검사라 못 돌리면 멈춥니다.**
 >
 > **에이전트 tier로 모델 고르기** → [`../_shared/agent-model.md`](../_shared/agent-model.md)
 >
@@ -615,19 +617,9 @@ echo "$scanTmp"
 
 작성된 컨텍스트 문서를 `"$scanTmp/change-context.md"`에 쓴다 (파일 쓰기 도구 사용, 셸로 넘기지 않는다).
 
-```bash
-if gestalt --version >/dev/null 2>&1; then
-  echo "OK gestalt"
-elif pnpm tsx bin/gestalt.ts --version >/dev/null 2>&1; then
-  echo "OK pnpm"
-else
-  echo "MISSING"
-fi
-```
-
-`OK pnpm`이면 아래 호출의 `gestalt`를 `pnpm tsx bin/gestalt.ts`로 바꿔 부릅니다. 한 번 확인하고 그 뒤로는(4.5, 4.7단계 포함) 같은 형태를 씁니다.
-
-**`MISSING`이면 검사를 건너뛰지 않고 멈춥니다.** 못 돌린 걸 통과로 읽으면 검사가 없는 것과 같습니다. `npm i -g @tienne/gestalt`를 함께 알리고 그대로 진행할지 사용자가 정하게 둡니다.
+[`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)에 따라 이 플러그인의 버전 고정 런처를 사용한다.
+아래 `gestalt` 호출은 `node`와 런처의 절대 경로로 바꿔 실행한다. 이후 단계와 파이프라인에도 같은 규칙을 적용한다.
+런처 실행이 실패하면 필수 검사를 건너뛰지 않고 오류를 알린 뒤 멈춘다. 전역 CLI 설치를 요구하거나 다른 버전으로 대신 실행하지 않는다.
 
 ```bash
 gestalt humanize-scan --file "$scanTmp/change-context.md" --register report
@@ -1392,15 +1384,20 @@ echo "파일 $found 개"
 
 # 파일마다 프로세스를 새로 띄우지 않고 한 번의 호출에 전부 실어 보냅니다.
 # humanize-scan 은 넘겨받은 파일 각각을 읽고 스캔을 따로 돌리므로 결과는 파일별로 갈립니다.
-find "$scanTmp" -maxdepth 1 -name '*.md' | sort | sed 's/^/--file /' \
-  | xargs gestalt humanize-scan --register chat
+if [ "$found" -eq 1 ]; then
+  scanFile=$(find "$scanTmp" -maxdepth 1 -name '*.md')
+  gestalt humanize-scan --file "$scanFile" --register chat
+elif [ "$found" -gt 1 ]; then
+  find "$scanTmp" -maxdepth 1 -name '*.md' | sort | sed 's/^/--file /' \
+    | xargs gestalt humanize-scan --register chat
+fi
 ```
 
 `found` 가 코멘트 수와 다르면 **검사 실패입니다.** 그 자리에서 멈추고 무엇이 어긋났는지 알립니다. 파일 쓰기가 어긋났는데 조용히 넘어가면 이 검사가 막으려던 상황이 그대로 재현됩니다.
 
 이 호출이 답하는 질문은 두 층입니다.
 
-- **프로세스 종료 코드**는 파일 전체를 합친 값입니다 — 하나라도 0이면 0, 아니면 하나라도 12면 12, 아니면 하나라도 11이면 11, 나머지는 10입니다. "게시를 미뤄야 하는가"는 이 값 하나로 답이 납니다.
+- **스캐너 프로세스 종료 코드**는 파일 전체를 합친 값입니다 — 하나라도 0이면 0, 아니면 하나라도 12면 12, 아니면 하나라도 11이면 11, 나머지는 10입니다. `xargs`는 이 값을 다른 코드로 바꾸므로 여러 파일 호출에서는 셸의 종료 코드로 게시 여부를 판단하지 않습니다.
 - **어느 코멘트를 다시 써야 하는가**는 출력에 파일마다 찍히는 `== <경로> EXIT=<코드>` 줄로 답이 납니다. 파일별로 스캔을 따로 돌린 결과라 이 코드는 코멘트 단위 그대로입니다.
 
 각 줄의 EXIT 값이 뜻하는 바는 다음과 같습니다.
@@ -1410,7 +1407,7 @@ find "$scanTmp" -maxdepth 1 -name '*.md' | sort | sed 's/^/--file /' \
 - **11** — 어투는 깨끗하고 맞춤법만 걸렸습니다. 그것만 고칩니다.
 - **12** — **검사할 산문이 없습니다.** 코멘트가 인용줄뿐이라 검사가 안 된 것이지 통과가 아닙니다. 자기 문장을 인용 밖에 두고 다시 쓰게 합니다.
 - 재작성은 **한 번만** 돕니다. 두 번째도 걸리면 무엇이 남았는지 사용자에게 알리고 게시할지 묻습니다.
-- 프로세스 종료 코드가 10이나 11이면 게시합니다. 게시가 끝나면 `rm -rf "$scanTmp"`로 그 실행 칸만 치웁니다 — 상위 `gestalt-review`나 PR 칸을 통째로 지우면 다른 세션이 쓰는 중인 파일까지 날아갑니다.
+- 여러 파일이면 파일별 EXIT가 모두 10이나 11일 때 게시합니다. 표지가 없는 단일 파일 직접 호출은 그 프로세스의 종료 코드를 씁니다. 게시가 끝나면 `rm -rf "$scanTmp"`로 그 실행 칸만 치웁니다 — 상위 `gestalt-review`나 PR 칸을 통째로 지우면 다른 세션이 쓰는 중인 파일까지 날아갑니다.
 
 **코멘트 여러 개를 파일 하나에 모아 담으면 이 검사가 무력화됩니다.** 인용 판정이 그 파일 전체를 한 덩어리로 보기 때문에 코멘트 하나를 통째로 인용으로 감싸도 같은 파일 안 다른 코멘트의 산문에 묻혀 안 걸립니다. 파일 하나에 코멘트 하나가 이 검사가 서는 조건입니다.
 

package/dist/plugin/skills/review-loop/SKILL.md

@@ -44,6 +44,8 @@ routing:
 
 # Review Loop Skill
 
+> **호스트별 도구와 모델 호출** → [`../_shared/host-runtime.md`](../_shared/host-runtime.md). 실행 전에 읽고 현재 호스트에 맞게 적용한다.
+
 남의 GitHub PR 하나를 **리뷰어로 끝까지 따라간다.** 리뷰하고 판정을 남기고 작성자가 고칠 때까지 지켜보다가 다시 리뷰한다.
 
 ```
@@ -220,11 +222,12 @@ gh repo view --json owner,name,nameWithOwner
 
 **판정에 쓰는 수를 전부 이 명령이 낸다.** 없으면 첫 단계부터 아무것도 못 한다 — 설치본이 뒤처져 있으면 `unknown option` 으로 죽는데, 그걸 라운드를 돌다가 알면 늦다.
 
-먼저 [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)의 판정을 돌려 `gestalt`를 어떤 형태로 부르는지 정한다. 그다음 그 형태로 하위 명령을 찌른다.
+먼저 [`../_shared/cli-launcher.md`](../_shared/cli-launcher.md)에 따라 플러그인 버전에 맞는 런처가 설치된 절대 경로를 구한다.
+아래 경로 자리에 실제 값을 직접 넣는다. 도구 호출 사이에 셸 변수가 남는다고 가정하지 않는다.
 
 ```bash
-if gestalt review-loop parse 1 >/dev/null 2>&1 \
-  && gestalt review-loop dir >/dev/null 2>&1; then
+if node "<공유 지침으로 구한 런처 절대 경로>" review-loop parse 1 >/dev/null 2>&1 \
+  && node "<공유 지침으로 구한 런처 절대 경로>" review-loop dir >/dev/null 2>&1; then
   echo "OK"
 else
   echo "MISSING"
@@ -234,14 +237,14 @@ fi
 
 **명령을 변수에 담아 함수로 넘기지 않는다.** zsh는 인용 안 한 변수 전개에서 단어 분리를 안 해 `$cmd`가 통째로 명령 이름이 된다. 그러면 실제로 깔려 있어도 `MISSING`이 나온다. 같은 코드가 bash에서는 도는 탓에 눈으로는 안 걸린다.
 
-`OK`면 아래 예시를 앞의 판정에서 정한 형태로 쓴다. **`MISSING`이면 라운드를 시작하지 않는다.**
+`OK`면 이후 모든 CLI 예시의 `gestalt`를 `node "<공유 지침으로 구한 런처 절대 경로>"`로 바꿔 실행한다. **`MISSING`이면 라운드를 시작하지 않는다.**
 
 **하위 명령을 둘 다 찔러본다.** 하나만 보면 그것만 있고 나머지가 없는 중간 설치본이 통과해 라운드 중간에 죽는다. 1.1이 입력 하나가 아니라 셋을 보는 이유와 같다.
 
 ```
 이 버전에는 `gestalt review-loop` 명령이 없네요. 판정에 쓰는 수를 낼 방법이 없어요.
 
-`/plugin install gestalt@gestalt`로 플러그인을 올린 뒤 다시 불러주세요.
+먼저 Node.js >=22, npm과 네트워크 연결을 확인해요. 그래도 이 버전에 하위 명령이 없으면 플러그인을 갱신한 뒤 다시 불러주세요.
 ```
 
 1.1의 `review` 스킬 검사와 같은 격이다. 둘 다 없으면 루프가 성립하지 않는 전제라 시작 전에 본다.
@@ -391,7 +394,7 @@ done
 설치된 `review` 스킬이 `postVerdict`를 안 받네요. 그대로 돌리면 라운드마다 판정이 두 번 나가요.
 이슈가 남았는데 승인으로 끝나는 경우도 생기고요.
 
-`/plugin install gestalt@gestalt`로 플러그인을 올린 뒤 다시 불러주세요.
+플러그인이 최신인지 확인하고 아니면 갱신한 뒤 다시 불러주세요.
 ```
 
 **이 스킬을 새로 부른 세션마다 한 번 돈다.** 같은 세션 안에서는 설치본이 안 바뀌므로 라운드 2부터 건너뛴다. 다만 `round` 파일이 있어 **이어서 도는 세션은 다시 돈다** — 지난 세션 뒤에 플러그인이 올라갔을 수 있다.
@@ -413,10 +416,10 @@ postVerdict: false
 
 ```
 #{prNumber}에 이미 판정이 게시됐어요 — {postedReview}.
-`postVerdict: false`로 불렀는데 설치된 review 가 그걸 못 읽은 것 같습니다.
+`postVerdict: false`로 불렀는데 설치된 review가 그 입력을 못 읽었어요.
 
 이 라운드는 여기서 멈출게요. 제가 판정을 또 내면 두 번 나갑니다.
-`/plugin install gestalt@gestalt`로 플러그인을 올린 뒤 다시 불러주세요.
+플러그인이 최신인지 확인하고 아니면 갱신한 뒤 다시 불러주세요.
 ```
 
 `loopState`를 `blocked`로 두고 끝낸다. **2.5로 내려가지 않는다** — 이미 나간 판정 위에 하나 더 얹는 게 이 계약이 막으려던 바로 그 일이다.
@@ -608,7 +611,7 @@ gestalt humanize-scan --file "$stateDir/verdict-r<N>.md" --register chat
 echo "EXIT=$?"
 ```
 
-부르는 형태는 위 "조회 명령이 있는지 먼저 본다"에서 판정한 것을 그대로 쓴다.
+위 "조회 명령이 있는지 먼저 본다"에서 구한 런처의 절대 경로를 그대로 쓴다.
 
 | 종료 코드 | 무엇 |
 | --- | --- |
@@ -619,7 +622,7 @@ echo "EXIT=$?"
 
 **ⓦ 두 번째도 걸리면** 무엇이 남았는지 알리고 게시할지 묻는다.
 
-어느 형태로 부를지는 Phase 0의 `OK gestalt`와 `OK pnpm`에서 이미 정해졌다.
+Phase 0에서 정한 버전 고정 런처를 여기서도 사용한다. `gestalt` 예시는 `node "<공유 지침으로 구한 런처 절대 경로>"`로 바꿔 실행한다.
 
 ### 2.5 게시