@uzysjung/agent-harness 26.147.0 → 26.148.0

package/README.ko.md

@@ -50,28 +50,28 @@ npx -y @uzysjung/agent-harness uninstall   # 무엇을 뺄지 고른다
 ```
 
 터미널에서 `uninstall` 을 실행하면 항목별로 지울지 전부 지울지 묻는다. 안전하게 되돌릴 수 있는
-것만 되돌리고, 글로벌 자산·훅 등록·`.mcp.json` 같은 `.claude/` 밖 파일은 지우는 대신 경로를
+것만 되돌리고, 글로벌 자산과 `.mcp.json` 같은 `.claude/` 밖 파일은 지우는 대신 경로를
 *출력한다* — 사용자 내용이 섞인 파일은 기계적으로 고치지 않는다. 설치 화면에서 체크를 풀어도
 제거되지 않으며, 제거는 오직 이 명령에서만 일어난다. 자세한 내용은
 [uninstall](docs/USAGE.md#uninstall-v26640) 참고.
 
 ## 왜
 
-코딩 에이전트는 계속 강해지지만, 한 번 설치한 skill 과 MCP 는 실제 사용 여부와 무관하게 매 세션 context window 를 차지한다. awesome-list 에 수백 개의 선택지가 있어도 내 기술 스택에 맞는 항목을 짚어주지는 않는다. 결국 전부 설치해 매 세션 불필요한 비용을 치르거나, 프로젝트를 시작할 때마다 직접 목록을 읽고 골라야 한다.
+코딩 에이전트는 계속 발전하지만, 한 번 설치한 skill 과 MCP 는 실제 사용과 무관하게 매 세션 context window 를 점유한다. awesome-list 에 수백 개의 선택지가 있어도 내 기술 스택에 맞는 항목을 찾아주지는 않는다. 결국 전부 설치해 매 세션 불필요한 비용을 치르거나, 프로젝트를 시작할 때마다 직접 목록을 확인하고 골라야 한다.
 
 이 도구는 스택에서 출발한다. 원하는 track 을 고르면 해당 track 이 필요로 하는 자산이 미리 체크된다. 사용자는 설치를 진행하기 전에 선택된 자산을 검토하고 필요 없는 항목을 해제할 수 있다.
 
 ## 무엇을 얻는가
 
-- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 React, shadcn, Supabase, Postgres 자산만 미리 체크된다 — 나머지 38개는 처음부터 끼어들지 않는다.
+- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 세 묶음이 미리 체크된다 — 모든 track 이 받는 4종(`north-star`·`task-brief`·`gh-issue-workflow`·`audit-harness-fit`), 개발 track 이 받는 것들(`find-skills`·`agent-browser`·`frontend-design` + 방법론 스킬 6종), 그리고 이 스택이 필요로 하는 React·shadcn·Supabase·Postgres. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
 
-- **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 벤치마크 패리티 루프, 재발 방지 체계를 아우르며, 특히 스킬 11종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
+- **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 작업 브리프 정규화, 재발 방지 체계를 아우르며, 특히 스킬 14종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 그중 12종은 id 로 지정할 수 있고(`--with`/`--without`), 그 12종 가운데 6종은 3단계 화면에서 한 줄로 묶여 함께 켜지고 꺼진다. 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
 
 - **4개 CLI, 하나의 어휘.** 1급 지원 대상인 Claude Code 에는 모든 자산·훅·plugin 을 적용하고, Codex, OpenCode, Antigravity 에는 skill 과 rule 레이어를 적용한다. 프로젝트가 특정 CLI 에 묶이지 않는다.
 
 ## 검증
 
-vetted 등급의 조건은 셋이다 — GitHub star 1,000개 이상, 활발한 유지보수, 격리된 Docker 컨테이너에서의 실설치 검증 통과. CI cron 이 매월 세 기준을 다시 검사한다.
+vetted 등급의 조건은 GitHub star 1,000개 이상, 활발한 유지보수, 격리된 Docker 컨테이너에서의 실설치 검증 통과 세 가지다. 매월 CI cron 이 이 세 기준을 다시 검사한다.
 
 단, vetted 가 라인 단위 보안 감사나 prompt-injection 스캔을 거쳤다는 뜻은 아니다. npm 과 npx 자산은 버전을 고정하지만, plugin 과 skill 자산은 upstream HEAD 를 참조하므로 아직 commit 을 고정하지 않는다. 설치하는 모든 자산은 일반적인 서드파티 의존성과 똑같이 취급할 것 — [SECURITY.md](SECURITY.md) 참고.
 

package/README.md

@@ -49,7 +49,7 @@ npx -y @uzysjung/agent-harness update      # refresh it to the current release
 npx -y @uzysjung/agent-harness uninstall   # pick what to remove
 ```
 
-Run in a terminal, `uninstall` asks what to take out — item by item, or everything. It reverses what it safely can and *prints* the rest — global assets, hook registrations, and files outside `.claude/` such as `.mcp.json` — instead of editing files that hold your own content. Unchecking something in the installer never removes it; removal only happens here. See [uninstall](docs/USAGE.md#uninstall-v26640).
+Run in a terminal, `uninstall` asks what to take out — item by item, or everything. It reverses what it safely can and *prints* the rest — global-scope assets, and files outside `.claude/` such as `.mcp.json` — instead of editing files that hold your own content. Unchecking something in the installer never removes it; removal only happens here. See [uninstall](docs/USAGE.md#uninstall-v26640).
 
 ## Why
 
@@ -59,9 +59,9 @@ This tool starts from the stack instead. You pick a track, and it pre-checks the
 
 ## What you get
 
-- **Curation by tech stack.** Of the vetted options, you install only what this project calls for. Pick `csr-supabase` and step 3 pre-checks React, shadcn, Supabase, and Postgres assets — not the other forty.
+- **Curation by tech stack.** Of the vetted options, you install only what this project calls for. Pick `csr-supabase` and step 3 pre-checks three groups: the four that every track gets (`north-star`, `task-brief`, `gh-issue-workflow`, `audit-harness-fit`), the dev-track set (`find-skills`, `agent-browser`, `frontend-design`, and the six method skills), and the ones this stack calls for — React, shadcn, Supabase, Postgres. Not the rest of the catalog.
 
-- **A discipline layer.** Rules, hooks, method skills, and CI scaffolds distilled from running real production projects with agents: doc governance, verification gates, benchmark-parity loops, recurrence prevention. Eleven of those skills are written and maintained in this repo rather than pulled from a marketplace, so the harness ships the method, not just a pointer to one. This layer is what makes it a harness rather than a skill pack.
+- **A discipline layer.** Rules, hooks, method skills, and CI scaffolds distilled from running real production projects with agents: doc governance, verification gates, normalized task briefs, recurrence prevention. Fourteen of those skills are written and maintained in this repo rather than pulled from a marketplace — twelve of them selectable by id with `--with` / `--without`, six of which collapse into one row at step 3 — so the harness ships the method, not just a pointer to one. This layer is what makes it a harness rather than a skill pack.
 
 - **Four CLIs, one vocabulary.** Claude Code is first class — all assets, hooks, and plugins. Codex, OpenCode, and Antigravity get the skills and rules layer. Your project is not locked to one CLI.
 

package/dist/{chunk-GPH5AWLX.js → chunk-PTUM2NI3.js}

@@ -443,23 +443,25 @@ var EXTERNAL_ASSETS = [
     method: { kind: "npm", pkg: "supabase", version: "2.108.0" }
   },
   // === UI tracks (csr-*|ssr-*|full) ===
-  // v26.92.0 — frontend-design (Anthropic official, claude-plugins-official 984.5K installs).
+  // v26.92.0 — frontend-design (Anthropic official).
   //   사용자 결정: has-dev-track 기본추천 (모든 개발 트랙, executive 제외).
   //   category=frontend (UI 자산, wizard 그룹).
-  //   repoForAsset=marketplace(anthropics/claude-plugins-official); official tier=drift 제외.
+  //
+  // 2026-08-26 (#344) — **plugin → skill.** 배달 방식이 도달 CLI 를 정한다(assetCliSupport):
+  //   `plugin` 은 `claude plugin install` 을 spawn 하므로 **구조적으로 Claude Code 전용**이라,
+  //   Codex·OpenCode·Antigravity 를 고른 사용자는 기본 추천 자산인데도 한 번도 받지 못했다
+  //   (사용자 적발). 같은 스킬이 `anthropics/skills` 에 원본으로 있고 `npx skills add` 는
+  //   `--agent` 로 네 CLI 전부에 깐다 — 실재 확인 2026-08-26: `skills/frontend-design/SKILL.md`.
+  //   tier 는 official 그대로(저자 동일). marketplace 경유가 아니게 되어 upstream 판본을 직접 쓴다.
   {
     id: "frontend-design",
     tier: "official",
-    // anthropics/claude-plugins-official (Anthropic 저자, 984.5K installs)
+    // anthropics/skills (Anthropic 저자, ★171.5K — 2026-08-26 gh api 실측)
     description: "frontend-design \u2014 distinctive production-grade UI generation (Anthropic official, avoids generic AI aesthetics)",
     category: "frontend",
     source: "anthropics",
     condition: { kind: "has-dev-track" },
-    method: {
-      kind: "plugin",
-      marketplace: "anthropics/claude-plugins-official",
-      pluginId: "frontend-design@claude-plugins-official"
-    }
+    method: { kind: "skill", source: "anthropics/skills", skill: "frontend-design" }
   },
   // 2026-08-02 정비 — 프론트엔드 품질 3종 (사용자 지시). 전부 opt-in: frontend-design 이 기본
   //   생성기이고 이 셋은 그 위의 취향·디테일 층이라 상시 비용을 물릴 근거가 없다 (ADR-032/035
@@ -1093,12 +1095,21 @@ function copyFile(source, target) {
   mkdirSync(dirname(target), { recursive: true });
   copyFileSync(source, target);
 }
-function copyDir(source, target) {
+function copyDir(source, target, foreignOf) {
   if (!existsSync(source)) {
     throw new Error(`Source dir not found: ${source}`);
   }
   mkdirSync(target, { recursive: true });
-  cpSync(source, target, { recursive: true, force: true });
+  const skipped = [];
+  for (const rel of listFilesRecursive(source)) {
+    const foreign = foreignOf(rel);
+    if (foreign !== null) {
+      skipped.push(foreign);
+      continue;
+    }
+    copyFile(join(source, rel), join(target, rel));
+  }
+  return skipped;
 }
 var MAX_BACKUP_CLAIMS = 100;
 function claimBackupPath(base, claim) {
@@ -1664,25 +1675,19 @@ function buildManifest(spec) {
     type: "file",
     applies: all
   });
-  m.push({
-    source: "skills/market-research",
-    target: ".claude/skills/market-research",
-    type: "dir",
-    applies: onTracks("executive|full")
-  });
-  for (const sd of ["investor-materials", "investor-outreach"]) {
+  for (const sd of ["market-research", "investor-materials", "investor-outreach"]) {
     m.push({
       source: `skills/${sd}`,
       target: `.claude/skills/${sd}`,
       type: "dir",
-      applies: onTracks("executive|full")
+      applies: (s) => !s.withEcc && onTracks("executive|full")(s)
     });
   }
   m.push({
     source: "skills/nextjs-turbopack",
     target: ".claude/skills/nextjs-turbopack",
     type: "dir",
-    applies: onTracks("ssr-nextjs|full")
+    applies: (s) => !s.withEcc && onTracks("ssr-nextjs|full")(s)
   });
   for (const sd of INTERNAL_BUNDLED_SKILL_IDS) {
     m.push({
@@ -1997,4 +2002,4 @@ export {
   formatResidentCostLine,
   formatResidentCostBlock
 };
-//# sourceMappingURL=chunk-GPH5AWLX.js.map
+//# sourceMappingURL=chunk-PTUM2NI3.js.map