@uzysjung/agent-harness 26.166.0 → 26.168.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/README.ko.md +9 -9
  2. package/README.md +9 -9
  3. package/dist/{chunk-AHAAF4HS.js → chunk-V4UY222W.js} +151 -82
  4. package/dist/chunk-V4UY222W.js.map +1 -0
  5. package/dist/index.js +661 -373
  6. package/dist/index.js.map +1 -1
  7. package/dist/trust-tier-drift.js +6 -3
  8. package/dist/trust-tier-drift.js.map +1 -1
  9. package/package.json +1 -1
  10. package/templates/codex/config.toml.template +0 -3
  11. package/templates/github-workflows/ci-node.yml +1 -1
  12. package/templates/github-workflows/ci-python.yml +1 -1
  13. package/templates/github-workflows/e2e.yml +1 -1
  14. package/templates/mcp.json +1 -11
  15. package/templates/rules/ship-checklist.md +2 -2
  16. package/templates/rules/ui-components.md +13 -0
  17. package/templates/skills/audit-harness-fit/SKILL.md +15 -4
  18. package/templates/skills/audit-harness-fit/references/apply.md +18 -0
  19. package/templates/skills/audit-harness-fit/references/audit.md +16 -3
  20. package/templates/skills/audit-harness-fit/references/verification.md +7 -0
  21. package/templates/skills/chatgpt-delegate/SKILL.md +221 -0
  22. package/templates/skills/external-model-consult/SKILL.md +82 -40
  23. package/templates/skills/external-model-consult/references/direct-calls.md +23 -14
  24. package/templates/skills/external-model-consult/references/model-evidence.md +156 -0
  25. package/templates/skills/external-model-consult/scripts/codex-ask.sh +4 -3
  26. package/templates/skills/external-model-consult/scripts/gemini-ask.sh +3 -3
  27. package/templates/skills/gemini-delegate/SKILL.md +223 -0
  28. package/templates/skills/genspark-delegate/SKILL.md +283 -0
  29. package/templates/skills/gh-issue-workflow/SKILL.md +1 -1
  30. package/templates/skills/model-orchestration/SKILL.md +5 -0
  31. package/templates/skills/multi-model-debate/SKILL.md +187 -0
  32. package/templates/skills/multi-model-debate/agents/openai.yaml +4 -0
  33. package/templates/skills/multi-model-debate/references/adapters.md +143 -0
  34. package/templates/skills/multi-model-debate/references/evaluation.md +80 -0
  35. package/templates/skills/multi-model-debate/references/prompts.md +87 -0
  36. package/templates/skills/multi-model-debate/references/research.md +171 -0
  37. package/templates/track-mcp-map.tsv +10 -5
  38. package/dist/chunk-AHAAF4HS.js.map +0 -1
package/README.ko.md CHANGED
@@ -28,7 +28,7 @@ uzys-agent-harness는 에이전트를 규칙 목록으로 묶지 않는다. 대
28
28
 
29
29
  ### 4. 여러 관점과 여러 에이전트로 속도, 비용, 품질을 맞춘다
30
30
 
31
- 스스로 하는 점검과 독립 검토를 나눈다. 중요한 변경은 결과물을 만들지 않은 다른 에이전트가 검토하고, 개발 트랙에는 여러 사용자 입장(페르소나)에서 결과물을 따져 보는 스킬도 들어간다. 선택 스킬을 더하면 작업마다 어울리는 모델과 추론 강도를 골라 가벼운 일은 빠르고 싸게, 중요한 일은 꼼꼼하게 처리하고, 다른 회사의 모델에게 의견을 물을 수도 있다.
31
+ 스스로 하는 점검과 독립 검토를 나눈다. 중요한 변경은 결과물을 만들지 않은 다른 에이전트가 검토하고, 개발 트랙에는 여러 사용자 입장(페르소나)에서 결과물을 따져 보는 스킬도 들어간다. 개발 트랙에는 작업마다 어울리는 모델과 추론 강도를 골라 가벼운 일은 빠르고 싸게, 중요한 일은 꼼꼼하게 처리하게 하는 스킬도 들어가고, 그 회사의 CLI 가 있으면 다른 회사의 모델에게 의견을 물을 수도 있다.
32
32
 
33
33
  이 네 가지를 담은 룰과 스킬, 그리고 프로젝트 스택에 맞는 외부 스킬(공식 저장소이거나, 출처와 인기도, 설치 경로를 확인해 고른 것)을 명령 하나로 설치한다. 내 `CLAUDE.md`에는 주석으로 표시한 블록 하나만 붙고 나머지는 건드리지 않는다. 지울 때도 `CLAUDE.md`나 `.mcp.json` 같은 공용 파일에서는 하네스가 넣은 부분만 빠진다. Claude Code, Codex, OpenCode, Antigravity에서 쓸 수 있고, 파일 편집을 막는 훅과 검토 에이전트는 Claude Code에서 동작한다.
34
34
 
@@ -110,7 +110,7 @@ CI, 컨테이너, 스크립트처럼 마법사를 띄울 수 없는 곳에서는
110
110
 
111
111
  ### 만드는 에이전트와 검사하는 에이전트를 나눈다
112
112
 
113
- 자기가 한 일을 자기가 검사하면 놓치기 쉽다. Claude Code에서는 코드를 짜지 않은 `reviewer` 서브에이전트가 테스트나 앱을 직접 돌려 보고 결과를 검사한다. 선택 스킬인 `model-orchestration`을 더하면 에이전트가 일마다 어떤 모델에게 얼마나 깊이 생각하게 할지 고른다. 가벼운 일은 빠르고 싸게, 판단할 게 많은 일은 더 강한 모델에게 맡겨 속도와 비용, 품질 사이에서 균형을 잡는다.
113
+ 자기가 한 일을 자기가 검사하면 놓치기 쉽다. Claude Code에서는 코드를 짜지 않은 `reviewer` 서브에이전트가 테스트나 앱을 직접 돌려 보고 결과를 검사한다. 개발 트랙에는 `model-orchestration` 스킬이 들어가 에이전트가 일마다 어떤 모델에게 얼마나 깊이 생각하게 할지 고른다. 가벼운 일은 빠르고 싸게, 판단할 게 많은 일은 더 강한 모델에게 맡겨 속도와 비용, 품질 사이에서 균형을 잡는다.
114
114
 
115
115
  작업 원칙 전문은 [templates/CLAUDE.md](templates/CLAUDE.md)에서 볼 수 있다. 설치하면 이 파일이 `CLAUDE-uzys-harness.md`라는 이름으로 들어가고, 내 `CLAUDE.md`는 한 줄로 이 파일을 불러온다. 프로젝트의 방향은 [docs/NORTH_STAR.md](docs/NORTH_STAR.md)에 정리해 두었다.
116
116
 
@@ -128,7 +128,7 @@ your-project/
128
128
  │ ├── agents/ 메인 에이전트가 일을 넘기는 서브에이전트(reviewer, implementer 등).
129
129
  │ ├── hooks/ 도구가 자동으로 실행하는 훅 스크립트(세션 시작, 파일 보호).
130
130
  │ └── settings.json 훅을 등록한다. 기존 설정과 합친다.
131
- ├── .mcp.json context7(최신 라이브러리 문서), github 등 MCP 서버. 기존 설정과 합친다.
131
+ ├── .mcp.json context7(최신 라이브러리 문서)와 트랙별 MCP 서버. 기존 설정과 합친다.
132
132
  └── .uzys-agent-harness/ 설치 기록과 보조 스크립트.
133
133
  ```
134
134
 
@@ -170,18 +170,18 @@ your-project/
170
170
  | `tooling` | 앱 스택 없는 Bash·Markdown 프로젝트 | 없음 |
171
171
  | `full` | 개발 트랙 전부와 문서 작업 | 위 항목 전부 + `anthropic-document-skills` |
172
172
  | `executive` | 제안서, 실사, 발표 자료, 재무 모델 | `anthropic-document-skills` |
173
- | `project-management` | PM 업무 | 없음 (`product-skills` 선택 가능) |
173
+ | `project-management` | PM 업무 | 없음 |
174
174
  | `growth-marketing` | 그로스·콘텐츠 마케팅 | 없음 (`marketingskills` 선택 가능) |
175
175
 
176
- MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서), `github`, `chrome-devtools`가 들어가고, `csr-*`와 `ssr-htmx` 트랙에는 배포용 `railway-mcp-server`가, `csr-supabase`에는 `supabase`가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다.
176
+ MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서)가 들어가고, 웹 트랙(`csr-*`, `ssr-*`, `full`)에는 Google 사용 통계를 끈 `chrome-devtools`가 더해진다. `csr-*`와 `ssr-htmx` 트랙에는 `railway-mcp-server`(Railway 원격 서버 — 처음 쓸 때 로그인한다)가, `csr-supabase`에는 `supabase`가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다. Vercel·GitHub 공식 원격 서버(`vercel`, `github-mcp`)는 미리 체크되지 않는다 — `--with`로 더한다.
177
177
 
178
178
  미리 체크되지는 않지만 3단계나 `--with <id>`로 더할 수 있는 것도 있다.
179
179
 
180
180
  - 프론트엔드·디자인: `web-design-guidelines`, `taste-skill`, `jakubkrehel-skills`, `preline`, `scroll-world`
181
- - 배포: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `railway-skills`
182
- - 보안 리뷰: `security-guidance`, `trailofbits-skills`
183
- - 제품·마케팅·재무: `product-skills`, `marketingskills`, `finance-skills`
184
- - 발표·영상: `frontend-slides`, `marp-slide`, `revealjs`, `remotion`, `gsap-skills` 등
181
+ - 배포: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `vercel`, `railway-skills`
182
+ - 보안 리뷰: `security-guidance`, `claude-security`
183
+ - 마케팅·재무: `marketingskills`, `finance-skills`
184
+ - 발표·영상: `frontend-slides`, `marp-slide`, `hyperframes`, `remotion`, `gsap-skills` 등
185
185
  - 정해진 개발 절차가 필요한 팀: `openspec`, `bmad-method` ([WORKFLOWS.md](docs/WORKFLOWS.md)에서 비교)
186
186
 
187
187
  트랙별 전체 구성은 [docs/TRACKS.md](docs/TRACKS.md)에, 항목별 출처와 설치 방식, 지원 도구는 [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md)에 있다.
package/README.md CHANGED
@@ -28,7 +28,7 @@ Every instruction the agent reads each session takes up context, and as they pil
28
28
 
29
29
  ### 4. Several viewpoints and several agents balance speed, cost, and quality
30
30
 
31
- Self-checks and independent review are kept apart. Important changes are reviewed by an agent that didn't build them, and dev tracks also get a skill that examines the work from several user perspectives (personas). With the optional skills, each task gets a fitting model and reasoning effort, light work fast and cheap and important work done carefully, and a model from another vendor can give a second opinion.
31
+ Self-checks and independent review are kept apart. Important changes are reviewed by an agent that didn't build them, and dev tracks also get a skill that examines the work from several user perspectives (personas). Dev tracks also get skills that give each task a fitting model and reasoning effort, light work fast and cheap and important work done carefully, and, if you have that vendor's CLI, let a model from another vendor give a second opinion.
32
32
 
33
33
  One command installs the rules and skills that carry these four ideas, plus third-party skills for your stack (from official repositories, or picked after checking their source, popularity, and install path). Your `CLAUDE.md` gets one block marked with comments and nothing else is touched. On uninstall, shared files such as `CLAUDE.md` and `.mcp.json` lose only the harness's part. Works with Claude Code, Codex, OpenCode, and Antigravity; the hook that blocks file edits and the reviewer agent run on Claude Code.
34
34
 
@@ -110,7 +110,7 @@ Every instruction read each session takes up context, and instructions written f
110
110
 
111
111
  ### The agent that builds is not the one that checks
112
112
 
113
- An agent checking its own work tends to miss things. On Claude Code, a `reviewer` subagent that didn't write the code runs your tests or the app and checks the result. With the optional `model-orchestration` skill, the agent also picks the model and reasoning effort for each task: fast and cheap for light work, stronger where more judgment is needed. That is how speed, cost, and quality get balanced.
113
+ An agent checking its own work tends to miss things. On Claude Code, a `reviewer` subagent that didn't write the code runs your tests or the app and checks the result. On dev tracks, the `model-orchestration` skill also has the agent pick the model and reasoning effort for each task: fast and cheap for light work, stronger where more judgment is needed. That is how speed, cost, and quality get balanced.
114
114
 
115
115
  The full working principles are in [templates/CLAUDE.md](templates/CLAUDE.md). They are installed as `CLAUDE-uzys-harness.md` and pulled in by one line in your `CLAUDE.md`. The project's direction is in [docs/NORTH_STAR.md](docs/NORTH_STAR.md).
116
116
 
@@ -128,7 +128,7 @@ your-project/
128
128
  │ ├── agents/ reviewer, implementer: subagents the main agent hands work to
129
129
  │ ├── hooks/ session start, file protection. Claude Code runs them itself
130
130
  │ └── settings.json registers the hooks (merged with yours)
131
- ├── .mcp.json MCP servers: context7 (current library docs), github, and more (merged with yours)
131
+ ├── .mcp.json MCP servers: context7 (current library docs) and more by track (merged with yours)
132
132
  └── .uzys-agent-harness/ the install record and helper scripts
133
133
  ```
134
134
 
@@ -163,18 +163,18 @@ A track is a starting setup for a dev stack or a kind of work: the top nine rows
163
163
  | `tooling` | Bash and Markdown projects with no app stack | None |
164
164
  | `full` | Every dev track, plus documents | All of the above, plus `anthropic-document-skills` |
165
165
  | `executive` | Proposals, due diligence, decks, financial models | `anthropic-document-skills` |
166
- | `project-management` | PM work | None (`product-skills` available) |
166
+ | `project-management` | PM work | None |
167
167
  | `growth-marketing` | Growth and content marketing | None (`marketingskills` available) |
168
168
 
169
- MCP servers come too. Every track gets `context7` (current library docs), `github`, and `chrome-devtools`. The `csr-*` and `ssr-htmx` tracks add `railway-mcp-server` for deployment, and `csr-supabase` adds `supabase`. `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it.
169
+ MCP servers come too. Every track gets `context7` (current library docs). Web tracks (`csr-*`, `ssr-*`, `full`) add `chrome-devtools`, with Google's usage statistics turned off. The `csr-*` and `ssr-htmx` tracks add `railway-mcp-server` (Railway's remote server — you sign in on first use), and `csr-supabase` adds `supabase`. `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it. Vercel's and GitHub's official remote servers (`vercel`, `github-mcp`) are never pre-checked — add them with `--with`.
170
170
 
171
171
  More external assets are never pre-checked but can be added at step 3 or with `--with <id>`:
172
172
 
173
173
  - Frontend and design: `web-design-guidelines`, `taste-skill`, `jakubkrehel-skills`, `preline`, `scroll-world`
174
- - Deployment: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `railway-skills`
175
- - Security review: `security-guidance`, `trailofbits-skills`
176
- - Product, marketing, finance: `product-skills`, `marketingskills`, `finance-skills`
177
- - Slides and video: `frontend-slides`, `marp-slide`, `revealjs`, `remotion`, `gsap-skills`, and more
174
+ - Deployment: `vercel-cli`, `netlify-cli`, `supabase-cli`, `railway-mcp-server`, `vercel`, `railway-skills`
175
+ - Security review: `security-guidance`, `claude-security`
176
+ - Marketing and finance: `marketingskills`, `finance-skills`
177
+ - Slides and video: `frontend-slides`, `marp-slide`, `hyperframes`, `remotion`, `gsap-skills`, and more
178
178
  - Teams that want a fixed development process: `openspec`, `bmad-method` (compared in [WORKFLOWS.md](docs/WORKFLOWS.md))
179
179
 
180
180
  Each track's full set is in [docs/TRACKS.md](docs/TRACKS.md). Every asset's source, install method, and supported tools are in [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md).
@@ -141,16 +141,17 @@ var EXTERNAL_ASSETS = [
141
141
  // v26.108.0 (ADR-037, 라이프사이클 자산화 ②) — CI 스캐폴드: `.github/workflows/` fill-in
142
142
  // 워크플로(tag-트리거 CI + 실DB 서비스 컨테이너 + coverage 게이트 + Playwright E2E).
143
143
  // 실무 CI 패턴의 도메인 중립 일반화 (CI 부재 프로젝트의 갭이 계기). `.claude/` 밖에
144
- // 쓰는 첫 자산 — opt-in 전용 + 기존 워크플로 파일은 절대 덮어쓰지 않는다 (src/ci-scaffold.ts,
144
+ // 쓰는 첫 자산 — 기존 워크플로 파일은 절대 덮어쓰지 않는다 (src/ci-scaffold.ts,
145
145
  // manifest 경유 아님 — CLI 선택과 무관하게 설치되는 CLI-agnostic 산출물).
146
+ // ADR-105 (#726, 사용자 결정 2026-10-11) — opt-in 전용 → 개발 트랙 기본. 없을 때만 쓰는 계약은 그대로.
146
147
  {
147
148
  id: "ci-scaffold",
148
149
  tier: "official",
149
150
  // uzys 본 하네스 자체 템플릿
150
- description: "CI scaffold \u2014 .github/workflows fill-in templates (tag-triggered CI + real-DB service container + coverage gate + Playwright E2E); never overwrites existing workflow files (opt-in)",
151
+ description: "CI scaffold \u2014 .github/workflows fill-in templates (tag-triggered CI + real-DB service container + coverage gate + Playwright E2E); writes only when the file is absent, never overwrites existing workflow files",
151
152
  category: "workflow",
152
153
  source: "uzys",
153
- condition: { kind: "opt-in" },
154
+ condition: { kind: "has-dev-track" },
154
155
  method: { kind: "internal", key: "ci-scaffold" }
155
156
  },
156
157
  // === Repo-bundled internal skills (uzys 1st-party, v26.87.0) ===
@@ -258,10 +259,11 @@ var EXTERNAL_ASSETS = [
258
259
  id: "model-orchestration",
259
260
  tier: "official",
260
261
  // uzys 자사 스킬 리포
261
- description: "Model orchestration \u2014 decompose work by capability and route independent, bounded tasks to available agents while preserving ownership, permissions, and verification. Model names are Claude Code vocabulary; on other CLIs the same split maps onto that vendor's tiers (opt-in \u2014 recommended)",
262
+ description: "Model orchestration \u2014 decompose work by capability and route independent, bounded tasks to available agents while preserving ownership, permissions, and verification. Model names are Claude Code vocabulary; on other CLIs the same split maps onto that vendor's tiers",
262
263
  category: "workflow",
263
264
  source: "uzys",
264
- condition: { kind: "opt-in" },
265
+ // ADR-105 (#726) — opt-in → 개발 트랙 기본.
266
+ condition: { kind: "has-dev-track" },
265
267
  method: { kind: "internal", key: "model-orchestration" }
266
268
  },
267
269
  {
@@ -270,12 +272,61 @@ var EXTERNAL_ASSETS = [
270
272
  id: "external-model-consult",
271
273
  tier: "official",
272
274
  // uzys 자사 스킬 리포
273
- description: "External model consult \u2014 ask an available external model/provider for an independent draft, critique, or provider-only output such as image generation (opt-in \u2014 recommended; requires that provider's CLI)",
275
+ description: "External model consult \u2014 ask an available external model/provider for an independent draft, critique, or provider-only output such as image generation (requires that provider's CLI)",
274
276
  category: "dev-tools",
275
277
  source: "uzys",
276
- condition: { kind: "opt-in" },
278
+ // ADR-105 (#726) — opt-in → 개발 트랙 기본. 설치는 디렉터리 복사뿐이라 provider CLI 가 없어도
279
+ // 설치는 성공한다 — 없으면 실행 시점에 래퍼가 멈추고 스킬이 "설치·로그인은 사용자 몫"을 알린다.
280
+ condition: { kind: "has-dev-track" },
277
281
  method: { kind: "internal", key: "external-model-consult" }
278
282
  },
283
+ {
284
+ // #729 (ADR-109) — 토론 정책(참여자 · 독립성 · 라운드 · 예산 · 재시도 · 대체 · 복귀 · 통합)은 이 스킬만
285
+ // 소유한다. 하위 경로(external-model-consult · 브라우저 위임 3종)는 실행 매개변수와 결과·상태만 맡는다.
286
+ // has-dev-track 인 이유: 브라우저 전제가 없다 — external-model-consult 의 CLI 둘만으로 "서로 다른 실제 모델 2개"가
287
+ // 성립하고, 없는 경로는 실행 시점에 unavailable 로 기록한다. DEV_METHOD 에 넣지 않는다(수단 — ADR-105 D2).
288
+ id: "multi-model-debate",
289
+ tier: "official",
290
+ // uzys 자사 스킬
291
+ description: "Multi-model debate \u2014 two or three different real models answer independently, then only decision-relevant disagreements are cross-examined and checked; uses whichever installed routes are available (external-model-consult CLIs or the browser delegates)",
292
+ category: "dev-tools",
293
+ source: "uzys",
294
+ condition: { kind: "has-dev-track" },
295
+ method: { kind: "internal", key: "multi-model-debate" }
296
+ },
297
+ // #729 (ADR-109, 사용자 결정 2026-10-12) — 브라우저 위임 3종은 opt-in. 실행 전제(브라우저 도구 · 로그인된 브라우저 ·
298
+ // 그 서비스 계정)가 하네스 밖에 있고 Codex CLI 에는 브라우저가 없다(공식 문서). #489 가 agent-browser 를 opt-in 으로
299
+ // 내린 축과 같다. 설치는 디렉터리 복사뿐이다 — `--with <id>` · 위저드 체크로 켠다.
300
+ {
301
+ id: "gemini-delegate",
302
+ tier: "official",
303
+ // uzys 자사 스킬
304
+ description: "Gemini delegate \u2014 hand design, review, or Korean polishing to Gemini on the web and collect the answer (needs a browser tool + your logged-in browser)",
305
+ category: "dev-tools",
306
+ source: "uzys",
307
+ condition: { kind: "opt-in" },
308
+ method: { kind: "internal", key: "gemini-delegate" }
309
+ },
310
+ {
311
+ id: "chatgpt-delegate",
312
+ tier: "official",
313
+ // uzys 자사 스킬
314
+ description: "ChatGPT delegate \u2014 hand design, planning, or review to ChatGPT on the web and collect the answer (needs a browser tool + your logged-in browser)",
315
+ category: "dev-tools",
316
+ source: "uzys",
317
+ condition: { kind: "opt-in" },
318
+ method: { kind: "internal", key: "chatgpt-delegate" }
319
+ },
320
+ {
321
+ id: "genspark-delegate",
322
+ tier: "official",
323
+ // uzys 자사 스킬
324
+ description: "Genspark delegate \u2014 hand design or planning to Genspark AI Chat, or generate and download images with AI Image (needs a browser tool + your logged-in browser)",
325
+ category: "dev-tools",
326
+ source: "uzys",
327
+ condition: { kind: "opt-in" },
328
+ method: { kind: "internal", key: "genspark-delegate" }
329
+ },
279
330
  {
280
331
  // 복원 9종이 아니라 신설이다 — 이관 이력이 없다.
281
332
  // 전 트랙인 이유: 위임과 요청 정규화는 개발 트랙의 행위가 아니라 **전 트랙의 행위**다.
@@ -326,8 +377,9 @@ var EXTERNAL_ASSETS = [
326
377
  method: { kind: "internal", key: "self-hosted-github-runner" }
327
378
  },
328
379
  {
329
- // 트랙과 무관한 글쓰기 규율이라 어느 트랙에서도 고를 수 있고, 어느 트랙에도 자동으로는
330
- // 안 깔린다(opt-in). 한국어로 쓰지 않는 사용자에게 기본 설치되면 그대로 낭비다.
380
+ // 트랙과 무관한 글쓰기 규율이다. ADR-105 (#726, 사용자 결정 2026-10-11) — opt-in → 개발 트랙
381
+ // 기본. 한국어로 쓰지 않는 설치자에게는 descriptor 상주가 낭비라는 대가를 받아들였다
382
+ // (빼려면 `--without natural-korean`).
331
383
  // user-centered-explanation 과의 경계: 저쪽은 **무엇을 어떤 형식으로 말할지**(설명·승인
332
384
  // 요청의 구조)이고, 이쪽은 **한국어로 쓰는 행위 자체**(답변·글쓰기·번역·퇴고)의 표현이다.
333
385
  // #428 — 전신 `humanize-korean`(#355, 진단-우선 퇴고)을 개명·교체했다. 범위가 퇴고에서
@@ -336,10 +388,10 @@ var EXTERNAL_ASSETS = [
336
388
  id: "natural-korean",
337
389
  tier: "official",
338
390
  // uzys 자사 스킬
339
- description: "Natural Korean \u2014 write, answer, translate, and revise in Korean that reads as Korean: keep meaning and register, cut translationese, needless English, stock phrases, and mechanical repetition; fix only what is actually awkward (opt-in)",
391
+ description: "Natural Korean \u2014 write, answer, translate, and revise in Korean that reads as Korean: keep meaning and register, cut translationese, needless English, stock phrases, and mechanical repetition; fix only what is actually awkward",
340
392
  category: "workflow",
341
393
  source: "uzys",
342
- condition: { kind: "opt-in" },
394
+ condition: { kind: "has-dev-track" },
343
395
  method: { kind: "internal", key: "natural-korean" }
344
396
  },
345
397
  // === Option-gated (v26.42.0 — opt-in, BREAKING vs prior has-dev-track auto-install) ===
@@ -398,12 +450,13 @@ var EXTERNAL_ASSETS = [
398
450
  // #709 (ADR-101) — Railway MCP 서버의 **선택** 경로. 서버 정의는 트랙 표(`templates/track-mcp-map.tsv`)의 같은 이름
399
451
  // 행 하나다(key === 행 이름). 그 행의 패턴이 기본 트랙(csr-* · ssr-htmx · full)을 정하고, 이 항목은 그 밖의 트랙
400
452
  // (ssr-nextjs 등)에서 위저드 체크 · `--with` 로 고르게 한다. experimental 이라 조건으로는 미리 체크되지 않는다.
401
- // 상류 repo 는 archived — Railway 의 현행 경로(`railway mcp`)로 행 명령을 바꾸는 일은 별도 이슈.
453
+ // #712 (ADR-106) — 행이 Railway 공식 원격 서버(`https://mcp.railway.com`, OAuth)로 바뀌었다. 이름 · 키 id 는 그대로라 기록이
454
+ // 이어져 update 가 같은 키를 갈아 끼운다.
402
455
  {
403
456
  id: "railway-mcp-server",
404
457
  tier: "experimental",
405
- // railwayapp/railway-mcp-server 190★ · archived (월간 trust-tier-drift 가 REPO_OVERRIDE 로 감시)
406
- description: "Railway MCP server (`npx -y @railway/mcp-server`) in `.mcp.json` \u2014 already on by default on csr-*, ssr-htmx and full; check it to add it on any other track (e.g. ssr-nextjs). Upstream repo is archived; Railway's current route is `railway mcp` (opt-in)",
458
+ // railwayapp/cli 621★ (원격 서버에 공개 저장소가 따로 없다 — 같은 벤더의 CLI 를 감시, REPO_OVERRIDE)
459
+ description: "Railway's official remote MCP (https://mcp.railway.com, signs in with OAuth on first use) in .mcp.json, Codex and OpenCode \u2014 default on csr-* \xB7 ssr-htmx \xB7 full; check it to add it on any other track",
407
460
  category: "backend",
408
461
  source: "railwayapp",
409
462
  condition: { kind: "opt-in" },
@@ -412,19 +465,59 @@ var EXTERNAL_ASSETS = [
412
465
  cliSupportOverride: ["claude", "codex", "opencode"],
413
466
  method: { kind: "internal", key: "railway-mcp-server" }
414
467
  },
468
+ // #711 (ADR-106) — Vercel 공식 원격 MCP. 트랙 표 행의 패턴은 `-`(기본 트랙 없음) — 어느 트랙에서도 미리 체크하지 않는다
469
+ // (사용자 확정 2026-10-11 "opt-in", ssr-nextjs 포함). Antigravity 는 MCP 를 받지 않는다(Vercel 승인 클라이언트에도 없다).
470
+ {
471
+ id: "vercel",
472
+ tier: "vetted",
473
+ // Vercel MCP 에 공개 저장소가 따로 없다 — 같은 벤더의 vercel/vercel 16k 를 감시(REPO_OVERRIDE)
474
+ description: "Vercel's official remote MCP (https://mcp.vercel.com, signs in with OAuth on first use) in .mcp.json, Codex and OpenCode. Only if this project deploys to Vercel",
475
+ category: "backend",
476
+ source: "vercel",
477
+ condition: { kind: "opt-in" },
478
+ cliSupportOverride: ["claude", "codex", "opencode"],
479
+ method: { kind: "internal", key: "vercel" }
480
+ },
481
+ // #722 (ADR-106) — GitHub 공식 원격 MCP 의 opt-in 경로. 기본에서 뺀 옛 `github`(@modelcontextprotocol/server-github, 상류
482
+ // deprecated)와 **다른 이름**이다 — 같은 이름이면 옛 설치본의 기록된 몫이 선택으로 읽혀 PAT 없는 설치자에게 매 세션 실패하는
483
+ // 서버가 조용히 깔린다. 인증 = 환경변수 GITHUB_PAT(파일에는 이름만).
484
+ {
485
+ id: "github-mcp",
486
+ tier: "vetted",
487
+ // github/github-mcp-server 33.5k (REPO_OVERRIDE)
488
+ description: "GitHub's official remote MCP server (api.githubcopilot.com) in .mcp.json, Codex and OpenCode \u2014 needs a GitHub personal access token in GITHUB_PAT in the shell you start the CLI from. Not needed when the agent uses the gh CLI",
489
+ category: "dev-tools",
490
+ source: "github",
491
+ condition: { kind: "opt-in" },
492
+ cliSupportOverride: ["claude", "codex", "opencode"],
493
+ method: { kind: "internal", key: "github-mcp" }
494
+ },
495
+ // #722 (ADR-106) — Chrome DevTools MCP. 트랙 표 행이 웹 트랙(csr-* · ssr-* · full)의 기본이고, 이 항목은 그 밖의 트랙에서
496
+ // 고르게 한다. Google 사용 통계는 행의 `--no-usage-statistics` 로 끈다.
497
+ {
498
+ id: "chrome-devtools",
499
+ tier: "vetted",
500
+ // ChromeDevTools/chrome-devtools-mcp 53k (REPO_OVERRIDE)
501
+ description: "Chrome DevTools MCP \u2014 browser automation, console, network and performance tools for the agent. Default on csr-* \xB7 ssr-* \xB7 full; check it to add it on any other track. Google's usage statistics are turned off (--no-usage-statistics)",
502
+ category: "understanding",
503
+ source: "ChromeDevTools",
504
+ condition: { kind: "opt-in" },
505
+ cliSupportOverride: ["claude", "codex", "opencode"],
506
+ method: { kind: "internal", key: "chrome-devtools" }
507
+ },
415
508
  // === csr-supabase|full CLI ===
416
509
  {
417
510
  id: "vercel-cli",
418
511
  tier: "vetted",
419
- // vercel/vercel 15k
420
- description: "Vercel CLI \u2014 the real deploy tool as a devDependency (global under --scope global). Only if this project deploys to Vercel. `vercel mcp` then wires Vercel's official MCP (OAuth) into Claude Code",
512
+ // vercel/vercel 16k
513
+ description: "Vercel CLI \u2014 the real deploy tool as a devDependency (global under --scope global). Only if this project deploys to Vercel. Non-interactive `vercel link`/deploy needs `--scope` when your account has several teams (55.0.0+)",
421
514
  category: "backend",
422
515
  source: "vercel",
423
516
  // 2026-08-02 사용자 결정: 트랙 기본 → opt-in (ADR-063). #709 가 ssr-nextjs 기본으로 바꿨다가 #715 에서 되돌렸다 —
424
517
  // 설치자 package.json 에 의존성을 더하고(에이전트는 npx 로 쓸 수 있다) login 없이는 쓸 것이 없으며 핀이 낡는다.
425
- // Next.js 의 Vercel 기본은 공식 MCP(#711)로 채운다.
518
+ // Vercel 공식 MCP 도 opt-in 이다(`vercel` 항목, #711 · ADR-106 — 사용자 확정 2026-10-11).
426
519
  condition: { kind: "opt-in" },
427
- method: { kind: "npm", pkg: "vercel", version: "54.17.3" }
520
+ method: { kind: "npm", pkg: "vercel", version: "63.1.2" }
428
521
  },
429
522
  {
430
523
  // v26.106.0 (ADR-035, 사용자 승인 B): 배포 CLI 2종 동시 기본의 중복 해소 — npm dl 실측 10.11:1
@@ -604,20 +697,6 @@ var EXTERNAL_ASSETS = [
604
697
  pluginId: "understand-anything@understand-anything"
605
698
  }
606
699
  },
607
- {
608
- id: "agentmemory",
609
- tier: "vetted",
610
- // rohitg00/agentmemory 21k
611
- description: "AgentMemory \u2014 a separate memory server (MCP + hooks) that persists state across sessions; the runtime server is its own install (npx @agentmemory/agentmemory). Check first whether your CLI's own memory and project records already cover it",
612
- category: "understanding",
613
- source: "rohitg00",
614
- condition: { kind: "opt-in" },
615
- method: {
616
- kind: "plugin",
617
- marketplace: "rohitg00/agentmemory",
618
- pluginId: "agentmemory@agentmemory"
619
- }
620
- },
621
700
  // === Visual & Media (v26.85.0) — 코드-퍼스트 제작 자산. 전부 opt-in. ===
622
701
  // Docker 실설치 검증 PASS (실 claude 2.1.177): plugin install / npx skills add resolve 확인.
623
702
  {
@@ -684,24 +763,22 @@ var EXTERNAL_ASSETS = [
684
763
  method: { kind: "skill", source: "hugohe3/ppt-master", skill: "ppt-master" }
685
764
  },
686
765
  {
687
- id: "web-video-presentation",
688
- tier: "vetted",
689
- // ConardLi/garden-skills 8.4k
690
- description: "web-video-presentation \u2014 click-driven 16:9 web decks that play like video, with optional TTS narration. Keeps a step-by-step approval procedure; use for narrated web presentations",
691
- category: "visual-media",
692
- source: "ConardLi",
693
- condition: { kind: "opt-in" },
694
- method: { kind: "skill", source: "ConardLi/garden-skills", skill: "web-video-presentation" }
695
- },
696
- {
697
- id: "revealjs",
698
- tier: "experimental",
699
- // ryanbbrown/revealjs-skill 347 (<1000 → experimental, opt-in + 경고)
700
- description: "reveal.js \u2014 HTML presentations with themes, code highlighting, and speaker notes, no build step. Overlaps the other HTML deck assets; pick it when you specifically need reveal.js templates or compatibility",
766
+ // ADR-104 (#726) — web-video-presentation 의 교체. plugin 인 이유: skill 방식이면 상류 CLI 가
767
+ // 작업 중 `npx hyperframes skills update`/`init` 으로 같은 스킬 디렉터리를 다시 쓰고 prune 해
768
+ // 설치 기록(#573 sha)과 어긋난다. plugin 모드는 그 런타임 설치를 상류가 스스로 금한다.
769
+ // Anthropic 공식 마켓플레이스 항목(sha 고정 URL 소스, 내용 저자 HeyGen) — 그래서 tier official.
770
+ id: "hyperframes",
771
+ tier: "official",
772
+ // anthropics/claude-plugins-official 등재 (heygen-com/hyperframes)
773
+ description: "HyperFrames \u2014 write video as HTML and render it to MP4 (headless Chrome + FFmpeg): narrated explainers, slideshow-style decks, captions and voice-over. Rendering needs Node 22+ and FFmpeg",
701
774
  category: "visual-media",
702
- source: "ryanbbrown",
775
+ source: "heygen-com",
703
776
  condition: { kind: "opt-in" },
704
- method: { kind: "skill", source: "ryanbbrown/revealjs-skill", skill: "revealjs" }
777
+ method: {
778
+ kind: "plugin",
779
+ marketplace: "anthropics/claude-plugins-official",
780
+ pluginId: "hyperframes@claude-plugins-official"
781
+ }
705
782
  },
706
783
  // === Supabase agent-skills (csr-supabase|full) ===
707
784
  {
@@ -830,25 +907,6 @@ var EXTERNAL_ASSETS = [
830
907
  pluginId: "finance-skills@claude-code-skills"
831
908
  }
832
909
  },
833
- // === Project Management Track (v0.5.0) ===
834
- // SPEC §3.5 — product-skills: has-dev-track + project-management 합집합 (executive/growth-marketing 제외).
835
- {
836
- id: "product-skills",
837
- tier: "vetted",
838
- // alirezarezvani 16k
839
- description: "product-skills \u2014 RICE prioritization, PRD, interview analysis, design tokens, project scaffolding (15 skills with Python tools). Pick it for product-management work, and use the tools you need",
840
- category: "dev-tools",
841
- source: "alirezarezvani",
842
- // v26.106.0 (ADR-035, 사용자 승인 C): dev 8트랙 기본에서 제외 — PM 스킬 15종은 PM 트랙 목적
843
- // 자산. dev 트랙은 wizard 체크 / --with 로 opt-in.
844
- // 2026-08-02 사용자 결정: 트랙 기본 → opt-in (ADR-063)
845
- condition: { kind: "opt-in" },
846
- method: {
847
- kind: "plugin",
848
- marketplace: "alirezarezvani/claude-skills",
849
- pluginId: "product-skills@claude-code-skills"
850
- }
851
- },
852
910
  // === Growth Marketing Track (v0.5.0) ===
853
911
  // 2026-08-02 정비 — alirezarezvani 번들 4종(c-level·business-growth·pm·marketing) +
854
912
  // research-summarizer 제거. 남는 마케팅 번들은 아래 coreyhaines31/marketingskills 하나로,
@@ -881,24 +939,29 @@ var EXTERNAL_ASSETS = [
881
939
  // karpathy-gate.sh · settings.json PreToolUse auto-wire)도 함께 삭제 — BREAKING, ADR-060.
882
940
  // === Option-gated ===
883
941
  {
884
- // v26.39.2 fix — marketplace name = "trailofbits" (NOT "trailofbits-skills") +
885
- // "trailofbits-skills" plugin 자체가 존재하지 않음. marketplace 안에 14+ 개별 plugin.
886
- // 단일 대표 plugin = `differential-review` (코드 변경 보안 리뷰, 가장 보편).
887
- // 추가 plugin 원하는 사용자는: `claude plugin install <name>@trailofbits` (예: audit-context-building)
888
- id: "trailofbits-skills",
889
- tier: "vetted",
890
- // trailofbits/skills 5.5k (CC-BY-SA — 출처 신뢰)
891
- description: "Trail of Bits differential-review \u2014 security review of a change: history, call impact, attack scenarios, verification scope. For security-relevant changes, not every PR",
942
+ // ADR-104 (#726) — trailofbits-skills(differential-review)의 교체. Anthropic 공식 플러그인.
943
+ // `git push` 에 훅을 걸고 스캔이 시간·토큰을 쓰므로 opt-in 이다.
944
+ id: "claude-security",
945
+ tier: "official",
946
+ // anthropics/claude-plugins-official 등재 (./plugins/claude-security)
947
+ description: "Claude Security \u2014 on-request vulnerability scan of a branch, PR, or commit diff; a verifier agent challenges each finding and results are tallied in code; asks you to confirm the cost before it starts. For a light diff check, the built-in /security-review is enough",
892
948
  category: "dev-tools",
893
- source: "trailofbits",
949
+ source: "anthropics",
894
950
  condition: { kind: "opt-in" },
895
951
  method: {
896
952
  kind: "plugin",
897
- marketplace: "trailofbits/skills",
898
- pluginId: "differential-review@trailofbits"
953
+ marketplace: "anthropics/claude-plugins-official",
954
+ pluginId: "claude-security@claude-plugins-official"
899
955
  }
900
956
  }
901
957
  ];
958
+ var REMOVED_CATALOG_ASSETS = {
959
+ "product-skills": {},
960
+ agentmemory: {},
961
+ revealjs: {},
962
+ "trailofbits-skills": { replacedBy: "claude-security" },
963
+ "web-video-presentation": { replacedBy: "hyperframes" }
964
+ };
902
965
  var DEV_METHOD_SKILL_IDS = [
903
966
  "compaction-handoff",
904
967
  "user-centered-explanation",
@@ -919,7 +982,12 @@ var INTERNAL_BUNDLED_SKILL_IDS = [
919
982
  "model-orchestration",
920
983
  "external-model-consult",
921
984
  "self-hosted-github-runner",
922
- "natural-korean"
985
+ "natural-korean",
986
+ // #729 (ADR-109) — 토론(개발 트랙 기본) + 브라우저 위임 3종(opt-in). condition 이 설치를 가른다.
987
+ "multi-model-debate",
988
+ "gemini-delegate",
989
+ "chatgpt-delegate",
990
+ "genspark-delegate"
923
991
  ];
924
992
  var CONTINUOUS_SKILLS = [
925
993
  {
@@ -1029,7 +1097,7 @@ import { dirname as dirname3, join as join4 } from "path";
1029
1097
  // package.json
1030
1098
  var package_default = {
1031
1099
  name: "@uzysjung/agent-harness",
1032
- version: "26.166.0",
1100
+ version: "26.168.0",
1033
1101
  description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
1034
1102
  type: "module",
1035
1103
  publishConfig: {
@@ -2097,7 +2165,7 @@ var dev = (s) => hasDevTrack(s.tracks);
2097
2165
  var onTracks = (pattern) => (s) => anyTrack(s.tracks, pattern);
2098
2166
  var COMMON_RULES = ["git-policy", "change-management", "doc-governance"];
2099
2167
  var DEV_RULES = ["test-policy", "ship-checklist"];
2100
- var UI_RULES = [];
2168
+ var UI_RULES = ["ui-components"];
2101
2169
  var TRACK_RULES = {
2102
2170
  base: [],
2103
2171
  // #456 — 공통 룰만. cli-development 는 tooling·full 전용
@@ -2568,6 +2636,7 @@ export {
2568
2636
  anyTrack,
2569
2637
  hasUiTrack,
2570
2638
  EXTERNAL_ASSETS,
2639
+ REMOVED_CATALOG_ASSETS,
2571
2640
  DEV_METHOD_SKILL_IDS,
2572
2641
  INTERNAL_BUNDLED_SKILL_IDS,
2573
2642
  CONTINUOUS_SKILLS,
@@ -2654,4 +2723,4 @@ export {
2654
2723
  CATEGORIES,
2655
2724
  CATEGORY_TITLES
2656
2725
  };
2657
- //# sourceMappingURL=chunk-AHAAF4HS.js.map
2726
+ //# sourceMappingURL=chunk-V4UY222W.js.map