@uzysjung/agent-harness 26.151.0 → 26.153.0

package/README.ko.md

@@ -63,9 +63,9 @@ npx -y @uzysjung/agent-harness uninstall   # 무엇을 뺄지 고른다
 
 ## 무엇을 얻는가
 
-- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 세 묶음이 미리 체크된다 — 모든 track 이 받는 4종(`north-star`·`objective-brief`·`gh-issue-workflow`·`audit-harness-fit`), 개발 track 이 받는 것들(`find-skills`·`agent-browser`·`frontend-design` + 방법론 스킬 6종), 그리고 이 스택이 필요로 하는 React·shadcn·Supabase·Postgres. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
+- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `csr-supabase` 를 고르면 세 묶음이 미리 체크된다 — 모든 track 이 받는 4종(`north-star`·`objective-brief`·`gh-issue-workflow`·`audit-harness-fit`), 개발 track 이 받는 것들(`find-skills`·`agent-browser`·`frontend-design` + 방법론 스킬 5종), 그리고 이 스택이 필요로 하는 React·shadcn·Supabase·Postgres. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
 
-- **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 작업 브리프 정규화, 재발 방지 체계를 아우르며, 특히 스킬 14종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 그중 12종은 id 로 지정할 수 있고(`--with`/`--without`), 그 12종 가운데 6종은 3단계 화면에서 한 줄로 묶여 함께 켜지고 꺼진다. 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
+- **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 작업 브리프 정규화, 재발 방지 체계를 아우르며, 특히 스킬 14종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 그중 13종은 id 로 지정할 수 있고(`--with`/`--without`), 그 13종 가운데 5종은 3단계 화면에서 한 줄로 묶여 함께 켜지고 꺼진다. 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
 
 - **4개 CLI, 하나의 어휘.** 1급 지원 대상인 Claude Code 에는 모든 자산·훅·plugin 을 적용하고, Codex, OpenCode, Antigravity 에는 skill 과 rule 레이어를 적용한다. 프로젝트가 특정 CLI 에 묶이지 않는다.
 

package/README.md

@@ -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 three groups: the four that every track gets (`north-star`, `objective-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.
+- **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`, `objective-brief`, `gh-issue-workflow`, `audit-harness-fit`), the dev-track set (`find-skills`, `agent-browser`, `frontend-design`, and the five 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, 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.
+- **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 — thirteen of them selectable by id with `--with` / `--without`, five 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-3QBHZUVB.js → chunk-OYNSK6QF.js}

@@ -195,16 +195,6 @@ var EXTERNAL_ASSETS = [
     condition: { kind: "has-dev-track" },
     method: { kind: "internal", key: "audit-service-gaps" }
   },
-  {
-    id: "verification-loop",
-    tier: "official",
-    // uzys 자사 스킬 리포
-    description: "Verification loop \u2014 run proportional verification tracks (UI \xB7 API \xB7 CLI \xB7 library \xB7 docs \xB7 real user flow) and end with evidence plus a fixed verdict; a green build is not proof of user-visible completion",
-    category: "dev-tools",
-    source: "uzys",
-    condition: { kind: "has-dev-track" },
-    method: { kind: "internal", key: "verification-loop" }
-  },
   {
     id: "multi-persona-review",
     tier: "official",
@@ -285,7 +275,7 @@ var EXTERNAL_ASSETS = [
     id: "audit-harness-fit",
     tier: "official",
     // uzys 자사 스킬
-    description: "Audit harness fit \u2014 audit or clean up agent instructions and skills: remove needless questions and rechecks, reconcile conflicting or changed guidance, retire low-value rules and skills, move decision history out of resident text, right-size user-journey verification; also fill or refresh AGENTS.md / CLAUDE.md project context from repository evidence",
+    description: "Audit harness fit \u2014 improve agent instructions and skills for autonomous, productive delivery with verifiable quality: resolve needless questions and repeated checks, conflicting decisions, missing actionable context, and low-value procedures; adapt guidance to demonstrated model and tool capabilities; also fill or refresh AGENTS.md / CLAUDE.md project context from repository evidence",
     category: "workflow",
     source: "uzys",
     condition: { kind: "any-track", tracks: [...TRACKS] },
@@ -526,7 +516,10 @@ var EXTERNAL_ASSETS = [
     condition: { kind: "opt-in" },
     // 리포에 스킬 14종(brandkit·brutalist·minimalist 등)이 있고 본체가 `taste-skill` —
     // 스타일 변형은 그 안에서 고른다. 다른 단일 대표 자산(remotion)과 같은 형태.
-    method: { kind: "skill", source: "Leonxlnx/taste-skill", skill: "taste-skill" }
+    // 2026-09-20 (#420) — 업스트림이 SKILL.md 의 `name:` 을 `design-taste-frontend` 로 바꿨다. `npx skills
+    // add --skill` 은 디렉터리명이 아니라 **frontmatter name** 으로 맞춘다(실측: 옛 이름은 "No matching
+    // skills found", 새 이름은 설치 완료). 디렉터리는 여전히 `skills/taste-skill/` 이다.
+    method: { kind: "skill", source: "Leonxlnx/taste-skill", skill: "design-taste-frontend" }
   },
   {
     id: "scroll-world",
@@ -541,10 +534,10 @@ var EXTERNAL_ASSETS = [
   // 2026-08-16 — Preline 은 Tailwind 컴포넌트 킷이지만 **프레임워크에 매이지 않는다**: htmx·
   // vanilla 에도 붙는다(사용자 확인). 그래서 `frontend` 이면서 React/Vue 트랙 전용이 아니다.
   //
-  // 리포 안에 스킬은 `skills/theme-generator/` **하나**다 — 공식 문서는 이것을
-  // "preline-theme-generator" 라 부르지만 실제 디렉터리명은 `theme-generator` 이고,
-  // `npx skills add` 가 보는 것은 디렉터리명이다(실측 2026-08-16). 문서 표기를 그대로 옮겼다면
-  // 설치가 조용히 빗나갔다.
+  // 리포 안에 테마 스킬은 `skills/theme-generator/` 하나다. 2026-08-16 실측에서는 `npx skills add`
+  // 가 디렉터리명(`theme-generator`)으로 맞췄는데, 2026-09-01 부터 그 이름이 "No matching skills
+  // found" 가 됐다(#420) — 지금은 SKILL.md 의 `name:`(`preline-theme-generator`)으로 맞춘다(실측
+  // 2026-09-20: 옛 이름 exit 1 · 새 이름 설치 완료). 이름이 바뀌면 월 1회 catalog-verify 가 잡는다.
   //
   // 같은 날 조사한 flowbite 는 **넣지 않는다**: 에이전트용 제공물이 MCP 서버뿐인데, 이 저장소의
   // `.mcp.json` 조립은 트랙 조건만 읽어 opt-in 경로가 없다 — 넣으면 해당 트랙 전원에게 항상
@@ -557,7 +550,11 @@ var EXTERNAL_ASSETS = [
     category: "frontend",
     source: "htmlstreamofficial",
     condition: { kind: "opt-in" },
-    method: { kind: "skill", source: "htmlstreamofficial/preline", skill: "theme-generator" }
+    method: {
+      kind: "skill",
+      source: "htmlstreamofficial/preline",
+      skill: "preline-theme-generator"
+    }
   },
   // === dev tools (has_dev_track) ===
   // v26.110.0 (ADR-039) — code-review: /code-review 커맨드 1개 (다중 에이전트 confidence
@@ -1026,8 +1023,7 @@ var DEV_METHOD_SKILL_IDS = [
   "clear-korean-communication",
   "audit-service-gaps",
   "multi-persona-review",
-  "recurrence-prevention",
-  "verification-loop"
+  "recurrence-prevention"
 ];
 var INTERNAL_BUNDLED_SKILL_IDS = [
   ...DEV_METHOD_SKILL_IDS,
@@ -1057,7 +1053,12 @@ var RENAMED_SKILL_IDS = {
 var RETIRED_SKILL_IDS = [
   "strategic-compact",
   "continuous-learning-v2",
-  "spec-scaling"
+  "spec-scaling",
+  // ADR-090 (#452) — 관측 없는 자산 은퇴. 앞 세 종과 같은 경로로 안내한다.
+  "verification-loop",
+  "deep-research",
+  "eval-harness",
+  "agent-introspection-debugging"
 ];
 var TRUST_TIER = Object.fromEntries(
   EXTERNAL_ASSETS.map((a) => [a.id, a.tier])
@@ -1666,17 +1667,29 @@ function resolveRules(spec) {
   return [...set].sort();
 }
 var ALL_RULES = resolveRules({ tracks: [...TRACKS] });
-var CORE_AGENTS = ["reviewer", "data-analyst", "strategist"];
-var DEV_AGENTS = ["plan-checker", "implementer"];
-var DEV_AGENTS_ECC = ["silent-failure-hunter", "build-error-resolver"];
-var RETIRED_AGENT_IDS = ["code-reviewer", "security-reviewer"];
+var CORE_AGENTS = ["reviewer"];
+var DEV_AGENTS = ["implementer"];
+var TRACK_AGENTS = [
+  ["data-analyst", "data|full"],
+  ["strategist", "executive|full"]
+];
+var RETIRED_AGENTS = [
+  { id: "code-reviewer", instead: "Claude Code \uC758 `/code-review` \uAC00 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4" },
+  { id: "security-reviewer", instead: "Claude Code \uC758 `/security-review` \uAC00 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4" },
+  // ADR-090 (#452) — spawn 0 · 결함만 관측된 세 종. **대안을 종마다 적는다**: 한 문구로 뭉치면
+  // 자기 에이전트와 상관없는 대안을 읽게 되고, 그건 "대신 쓸 것을 말한다"의 뜻을 잃는다.
+  { id: "plan-checker", instead: "`reviewer` \uAC00 \uACC4\uD68D \uBB38\uC11C\uB3C4 \uAC19\uC740 \uACC4\uC57D\uC73C\uB85C \uAC80\uD1A0\uD55C\uB2E4" },
+  { id: "silent-failure-hunter", instead: "Claude Code \uC758 `/code-review` \uAC00 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4" },
+  { id: "build-error-resolver", instead: "\uBAA8\uB378\uC774 \uAE30\uBCF8\uC73C\uB85C \uD558\uB294 \uC77C\uC774\uB77C \uB300\uCCB4 \uC790\uC0B0\uC774 \uC5C6\uB2E4" }
+];
+var RETIRED_AGENT_IDS = RETIRED_AGENTS.map((a) => a.id);
 var ALWAYS_HOOKS = ["session-start.sh", "protect-files.sh"];
 var COMMON_SKILL_DIRS = [];
 var COMMON_SKILL_DIRS_ECC = [];
-var MODIFIED_COMMON_SKILL_DIRS = ["deep-research"];
+var MODIFIED_COMMON_SKILL_DIRS = [];
 var DEV_SKILL_DIRS = [];
-var DEV_SKILL_DIRS_ECC = ["agent-introspection-debugging"];
-var MODIFIED_DEV_SKILL_DIRS = ["eval-harness"];
+var DEV_SKILL_DIRS_ECC = [];
+var MODIFIED_DEV_SKILL_DIRS = [];
 var MODIFIED_ECC_SKILL_DIRS = [...MODIFIED_COMMON_SKILL_DIRS, ...MODIFIED_DEV_SKILL_DIRS];
 var UI_SKILL_DIRS = ["ui-visual-review"];
 var UI_SKILL_DIRS_ECC = ["e2e-testing"];
@@ -1734,12 +1747,12 @@ function buildManifest(spec) {
       applies: dev
     });
   }
-  for (const a of DEV_AGENTS_ECC) {
+  for (const [a, pattern] of TRACK_AGENTS) {
     m.push({
       source: `agents/${a}.md`,
       target: `.claude/agents/${a}.md`,
       type: "file",
-      applies: (s) => !s.withEcc && hasDevTrack(s.tracks)
+      applies: onTracks(pattern)
     });
   }
   for (const sd of COMMON_SKILL_DIRS) {
@@ -1948,6 +1961,7 @@ function descriptorTokens(path2) {
 }
 function residentCost(entries, root = resolveBundleRoot()) {
   const tpl = (source) => join3(root, "templates", source);
+  const measured = (e) => e.file ?? tpl(e.source);
   const perSkill = {};
   let rules = 0;
   let skillDescriptors = 0;
@@ -1957,13 +1971,13 @@ function residentCost(entries, root = resolveBundleRoot()) {
   let agentItems = 0;
   for (const e of entries) {
     if (e.target.startsWith(".claude/rules/")) {
-      rules += fileTokens(tpl(e.source));
+      rules += fileTokens(measured(e));
       ruleItems += 1;
     } else if (e.target.startsWith(".claude/agents/")) {
-      agentDescriptors += descriptorTokens(tpl(e.source));
+      agentDescriptors += descriptorTokens(measured(e));
       agentItems += 1;
     } else if (e.target.startsWith(".claude/skills/")) {
-      const t = descriptorTokens(join3(tpl(e.source), "SKILL.md"));
+      const t = descriptorTokens(join3(measured(e), "SKILL.md"));
       skillDescriptors += t;
       skillItems += 1;
       const id = /\.claude\/skills\/([^/]+)/.exec(e.target)?.[1];
@@ -2128,6 +2142,8 @@ export {
   buildAssetSpec,
   resolveRules,
   ALL_RULES,
+  TRACK_AGENTS,
+  RETIRED_AGENTS,
   RETIRED_AGENT_IDS,
   isCliNeutralTarget,
   buildManifest,
@@ -2141,4 +2157,4 @@ export {
   formatResidentCostLine,
   formatResidentCostBlock
 };
-//# sourceMappingURL=chunk-3QBHZUVB.js.map
+//# sourceMappingURL=chunk-OYNSK6QF.js.map