@uzysjung/agent-harness 26.150.0 → 26.151.0

package/README.ko.md

@@ -63,7 +63,7 @@ npx -y @uzysjung/agent-harness uninstall   # 무엇을 뺄지 고른다
 
 ## 무엇을 얻는가
 
-- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `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. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
+- **스택 기반 큐레이션.** 검증된 옵션 중에서 이 프로젝트에 실제로 필요한 자산만 골라 설치한다. `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. 카탈로그의 나머지는 처음부터 끼어들지 않는다.
 
 - **규율 레이어.** 실제 프로덕션 프로젝트를 에이전트로 운영하며 추출한 룰·훅·방법론 스킬·CI 스캐폴드로 구성된다. 문서 거버넌스와 검증 게이트, 작업 브리프 정규화, 재발 방지 체계를 아우르며, 특히 스킬 14종은 마켓플레이스에 의존하지 않고 이 저장소에서 직접 쓰고 관리한다. 그중 12종은 id 로 지정할 수 있고(`--with`/`--without`), 그 12종 가운데 6종은 3단계 화면에서 한 줄로 묶여 함께 켜지고 꺼진다. 이 레이어 덕분에 단순한 skill 모음을 넘어선 하네스로 작동한다.
 

package/README.md

@@ -59,7 +59,7 @@ 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`, `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.
+- **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.
 
 - **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.
 

package/dist/{chunk-NKBUDHPC.js → chunk-3QBHZUVB.js}

@@ -240,7 +240,7 @@ var EXTERNAL_ASSETS = [
     id: "model-orchestration",
     tier: "official",
     // uzys 자사 스킬 리포
-    description: "Model orchestration \u2014 decompose work by capability and route independent, bounded tasks to available agents while preserving ownership, permissions, and verification (opt-in \u2014 recommended)",
+    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)",
     category: "workflow",
     source: "uzys",
     condition: { kind: "opt-in" },
@@ -261,27 +261,31 @@ var EXTERNAL_ASSETS = [
   {
     // 복원 9종이 아니라 신설이다 — 이관 이력이 없다.
     // 전 트랙인 이유: 위임과 요청 정규화는 개발 트랙의 행위가 아니라 **전 트랙의 행위**다.
-    // executive 트랙도 서브에이전트에 일을 넘기고, 그때 브리프가 없으면 완료 판정 기준 없이
-    // 넘긴다. 짝인 `task-brief-nudge.sh` 훅이 `ALWAYS_HOOKS`(전 설치본)라 스킬만 좁게 깔면
-    // 넛지가 없는 스킬을 가리킨다 — 훅과 스킬의 도달 범위는 같아야 한다.
-    id: "task-brief",
+    // executive 트랙도 서브에이전트에 일을 넘기고, 그때 브리프가 없으면 완료 판정 기준 없이 넘긴다.
+    // ADR-088 (#426 F-04) — 전신 `task-brief` 개명. 문턱이 **위임 · 설계 · 다단계(피처/프로젝트
+    //   규모 이상)** 로 좁혀졌고, 한 줄 요청마다 브리프를 권하던 매 프롬프트 넛지 훅과 상시 스킬
+    //   안내(`CONTINUOUS_SKILLS`)가 함께 빠졌다. 이름이 그 문턱을 들고 있다.
+    id: "objective-brief",
     tier: "official",
     // uzys 자사 스킬
-    description: "Task brief \u2014 normalize an incoming request into the canonical brief (objective \xB7 inputs \xB7 invariants \xB7 success criteria \xB7 boundaries \xB7 autonomy \xB7 verification) and write every delegation prompt in that same shape",
+    description: "Objective brief \u2014 normalize a delegation, a design task, or multi-step work at feature scale into the canonical brief (objective \xB7 inputs \xB7 invariants \xB7 success criteria \xB7 boundaries \xB7 autonomy \xB7 verification) and write every delegation prompt in that same shape",
     category: "workflow",
     source: "uzys",
     condition: { kind: "any-track", tracks: [...TRACKS] },
-    method: { kind: "internal", key: "task-brief" }
+    method: { kind: "internal", key: "objective-brief" }
   },
   {
-    // task-brief 와 같은 신설이다 — 이관 이력이 없다.
+    // objective-brief 와 같은 신설이다 — 이관 이력이 없다.
     // 전 트랙인 이유: 이 하네스는 **모든 트랙에** 앵커·룰·훅을 깐다. 그 상주층이 밥값을 하는지
     // 되묻는 루프만 개발 트랙에 두면, 상주 비용은 전원이 무는데 감사는 일부만 갖는 비대칭이
     // 된다. 감사 대상이 개발 산출물이 아니라 **설치본 자신**이라 트랙 술어와 무관하다.
+    // ADR-084 (#425) — 2판. 판정 근거가 공식 체크리스트 인용에서 **확정된 의도 + 리포 실증**으로
+    //   바뀌었고, 모드 4개(audit · verification · apply · populate)를 SKILL.md 가 references 로
+    //   라우팅한다. 비-Claude CLI 도 디렉터리째 받는 것이 전제다(#431).
     id: "audit-harness-fit",
     tier: "official",
     // uzys 자사 스킬
-    description: "Audit harness fit \u2014 audit whether the resident steering layer (anchor \xB7 rules \xB7 hooks \xB7 permissions \xB7 skill descriptors) still earns its context, judged by published criteria, block logs, and measurement; relocate procedures to skills, guarantees to hooks/permissions, derivable facts to code",
+    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",
     category: "workflow",
     source: "uzys",
     condition: { kind: "any-track", tracks: [...TRACKS] },
@@ -307,15 +311,18 @@ var EXTERNAL_ASSETS = [
     // 트랙과 무관한 글쓰기 규율이라 어느 트랙에서도 고를 수 있고, 어느 트랙에도 자동으로는
     //   안 깔린다(opt-in). 한국어로 쓰지 않는 사용자에게 기본 설치되면 그대로 낭비다.
     // clear-korean-communication 과의 경계: 저쪽은 **무엇을 어떤 형식으로 말할지**(설명·승인
-    //   요청의 구조)이고, 이쪽은 **이미 쓴 글의 문체**를 진단해 최소 수정한다.
-    id: "humanize-korean",
+    //   요청의 구조)이고, 이쪽은 **한국어로 쓰는 행위 자체**(답변·글쓰기·번역·퇴고)의 표현이다.
+    // #428 — 전신 `humanize-korean`(#355, 진단-우선 퇴고)을 개명·교체했다. 범위가 퇴고에서
+    //   쓰기·번역까지로 넓어져 이름이 뜻과 어긋났다. 옛 id 로 깐 설치본은 `update` 가 손대지
+    //   않고(설치된 디렉터리만 갱신) 그대로 남는다 — 새 판은 `--with natural-korean` 으로 받는다.
+    id: "natural-korean",
     tier: "official",
     // uzys 자사 스킬
-    description: "Humanize Korean \u2014 diagnose what actually reads as translationese, AI clich\xE9, or mechanical structure in Korean prose, then fix only what the diagnosis justifies, preserving facts, numbers, terminology and register (opt-in). References epoko77-ai/im-not-ai",
+    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)",
     category: "workflow",
     source: "uzys",
     condition: { kind: "opt-in" },
-    method: { kind: "internal", key: "humanize-korean" }
+    method: { kind: "internal", key: "natural-korean" }
   },
   // === Option-gated (v26.42.0 — opt-in, BREAKING vs prior has-dev-track auto-install) ===
   {
@@ -351,8 +358,8 @@ var EXTERNAL_ASSETS = [
     }
   },
   // v26.110.0 (ADR-039, 오피셜 플러그인 큐레이션) — feature-dev: 탐색→설계→구현 워크플로우 +
-  //   전용 에이전트 3종(code-architect/code-explorer/code-reviewer). 방법론류 — ADR-032
-  //   "워크플로우 강제 구조는 기본 불필요" + 자체 code-reviewer 가 기본 리뷰 에이전트와 중복
+  //   전용 에이전트 3종(탐색·설계·리뷰). 방법론류 — ADR-032 "워크플로우 강제 구조는 기본
+  //   불필요" + 그 리뷰 에이전트가 Claude Code 기본 `/code-review` 와 중복(ADR-089)
   //   → superpowers 와 동급 opt-in.
   {
     id: "feature-dev",
@@ -554,8 +561,8 @@ var EXTERNAL_ASSETS = [
   },
   // === dev tools (has_dev_track) ===
   // v26.110.0 (ADR-039) — code-review: /code-review 커맨드 1개 (다중 에이전트 confidence
-  //   스코어링 PR 리뷰). 기본 리뷰 스택(reviewer·code-reviewer·security-reviewer)과 표면 중복
-  //   + 최신 Claude Code 네이티브 /code-review 와 충돌 소지 → opt-in.
+  //   스코어링 PR 리뷰). 기본 리뷰 레인(`reviewer`)과 표면 중복 + Claude Code 네이티브
+  //   /code-review 와 충돌 소지 → opt-in. (ADR-089 로 우리 리뷰 에이전트 2종은 은퇴했다.)
   {
     id: "code-review",
     tier: "official",
@@ -572,7 +579,7 @@ var EXTERNAL_ASSETS = [
   },
   // v26.110.0 (ADR-039) — security-guidance: 매 편집 패턴 경고 + LLM diff 리뷰 (훅 12파일,
   //   Python + Agent SDK 의존). 상시 훅 = 매 편집 비용 + 폭발 반경 — 실측 전 기본설치 금지
-  //   (Context Cost NSM) → opt-in. security-reviewer 에이전트·agentshield ship 게이트와 보완.
+  //   (Context Cost NSM) → opt-in. Claude Code `/security-review`·agentshield ship 게이트와 보완.
   {
     id: "security-guidance",
     tier: "official",
@@ -1026,12 +1033,31 @@ var INTERNAL_BUNDLED_SKILL_IDS = [
   ...DEV_METHOD_SKILL_IDS,
   "north-star",
   "gh-issue-workflow",
-  "task-brief",
+  "objective-brief",
   "audit-harness-fit",
   "model-orchestration",
   "external-model-consult",
   "self-hosted-github-runner",
-  "humanize-korean"
+  "natural-korean"
+];
+var CONTINUOUS_SKILLS = [
+  {
+    id: "clear-korean-communication",
+    whenToApply: "applies to every answer, report, and approval request \u2014 a decision is presented as AS-IS \u2192 TO-BE from the position of whoever lives with the result; not only at the moment approval is asked for"
+  },
+  {
+    id: "model-orchestration",
+    whenToApply: "when work is delegated, it decides which lane takes the work and how that lane is run"
+  }
+];
+var RENAMED_SKILL_IDS = {
+  "task-brief": "objective-brief",
+  "humanize-korean": "natural-korean"
+};
+var RETIRED_SKILL_IDS = [
+  "strategic-compact",
+  "continuous-learning-v2",
+  "spec-scaling"
 ];
 var TRUST_TIER = Object.fromEntries(
   EXTERNAL_ASSETS.map((a) => [a.id, a.tier])
@@ -1415,9 +1441,34 @@ var HARNESS_ANCHOR_FILE = "CLAUDE-uzys-harness.md";
 var HARNESS_IMPORT_LINE = `@${HARNESS_ANCHOR_FILE}`;
 var IMPORT_MARKER_START = "<!-- uzys-harness:import:start -->";
 var IMPORT_MARKER_END = "<!-- uzys-harness:import:end -->";
-var IMPORT_BLOCK = `${IMPORT_MARKER_START}
-${HARNESS_IMPORT_LINE}
+function renderContinuousSkillsNote(selectedInternalSkills) {
+  const lines = CONTINUOUS_SKILLS.filter((s) => selectedInternalSkills.includes(s.id)).map(
+    (s) => `- \`${s.id}\` \u2014 ${s.whenToApply}.`
+  );
+  if (lines.length === 0) return "";
+  return [
+    "## Skills that apply continuously",
+    "",
+    "These installed skills apply to every response or delegation; no prompt ever looks like their job, so open them from this list:",
+    "",
+    ...lines
+  ].join("\n");
+}
+function withContinuousSkillsNote(scaffold, selectedInternalSkills) {
+  const note = renderContinuousSkillsNote(selectedInternalSkills);
+  return note ? `${scaffold}
+
+${note}` : scaffold;
+}
+function importBlock(continuousSkills) {
+  const note = renderContinuousSkillsNote(continuousSkills);
+  const body = note ? `${HARNESS_IMPORT_LINE}
+
+${note}` : HARNESS_IMPORT_LINE;
+  return `${IMPORT_MARKER_START}
+${body}
 ${IMPORT_MARKER_END}`;
+}
 var TRACK_DISPLAY_NAMES = {
   tooling: "Tooling",
   "csr-supabase": "CSR Supabase",
@@ -1511,18 +1562,27 @@ ${renderFillScaffold()}
 `;
 }
 function upsertHarnessImport(existing, opts) {
+  const block = importBlock(opts.continuousSkills ?? []);
   if (existing === null) {
     return `${mergeProjectClaude(opts)}
-${IMPORT_BLOCK}
+${block}
 `;
   }
+  const start = existing.indexOf(IMPORT_MARKER_START);
+  if (start !== -1) {
+    const endAt = existing.indexOf(IMPORT_MARKER_END, start);
+    if (endAt === -1) return existing;
+    const current = existing.slice(start, endAt + IMPORT_MARKER_END.length);
+    if (current === block) return existing;
+    return `${existing.slice(0, start)}${block}${existing.slice(endAt + IMPORT_MARKER_END.length)}`;
+  }
   if (hasHarnessImport(existing)) {
     return existing;
   }
   const body = existing.endsWith("\n") ? existing : `${existing}
 `;
   return `${body}
-${IMPORT_BLOCK}
+${block}
 `;
 }
 function stripHarnessImport(text) {
@@ -1607,19 +1667,12 @@ function resolveRules(spec) {
 }
 var ALL_RULES = resolveRules({ tracks: [...TRACKS] });
 var CORE_AGENTS = ["reviewer", "data-analyst", "strategist"];
-var CORE_AGENTS_ECC = ["code-reviewer", "security-reviewer"];
 var DEV_AGENTS = ["plan-checker", "implementer"];
 var DEV_AGENTS_ECC = ["silent-failure-hunter", "build-error-resolver"];
-var ALWAYS_HOOKS = [
-  "session-start.sh",
-  "protect-files.sh",
-  // UserPromptSubmit 넛지. 차단하지 않는 유일한 훅 — 판정은 결정적 두 조건뿐이고(길이 ·
-  // `<objective>` 표식 부재) 변환 자체는 `task-brief` 스킬 몫이다. `templates/settings.json`
-  // 배선과 한 벌 (hook-wiring-parity 가 한쪽만 있는 상태를 문다).
-  "task-brief-nudge.sh"
-];
+var RETIRED_AGENT_IDS = ["code-reviewer", "security-reviewer"];
+var ALWAYS_HOOKS = ["session-start.sh", "protect-files.sh"];
 var COMMON_SKILL_DIRS = [];
-var COMMON_SKILL_DIRS_ECC = ["strategic-compact", "continuous-learning-v2"];
+var COMMON_SKILL_DIRS_ECC = [];
 var MODIFIED_COMMON_SKILL_DIRS = ["deep-research"];
 var DEV_SKILL_DIRS = [];
 var DEV_SKILL_DIRS_ECC = ["agent-introspection-debugging"];
@@ -1681,14 +1734,6 @@ function buildManifest(spec) {
       applies: dev
     });
   }
-  for (const a of CORE_AGENTS_ECC) {
-    m.push({
-      source: `agents/${a}.md`,
-      target: `.claude/agents/${a}.md`,
-      type: "file",
-      applies: (s) => !s.withEcc
-    });
-  }
   for (const a of DEV_AGENTS_ECC) {
     m.push({
       source: `agents/${a}.md`,
@@ -1721,12 +1766,6 @@ function buildManifest(spec) {
       applies: all
     });
   }
-  m.push({
-    source: "skills/spec-scaling",
-    target: ".claude/skills/spec-scaling",
-    type: "dir",
-    applies: all
-  });
   for (const sd of ["market-research", "investor-materials", "investor-outreach"]) {
     m.push({
       source: `skills/${sd}`,
@@ -1932,7 +1971,12 @@ function residentCost(entries, root = resolveBundleRoot()) {
     }
   }
   const harnessAnchor = fileTokens(join3(root, "templates", "CLAUDE.md"));
-  const projectScaffold = estimateTokens(renderFillScaffold().trim().length);
+  const projectScaffold = estimateTokens(
+    withContinuousSkillsNote(
+      renderFillScaffold(),
+      CONTINUOUS_SKILLS.map((s) => s.id)
+    ).trim().length
+  );
   const projectClaudeMd = harnessAnchor + projectScaffold;
   const claudeMdItems = (harnessAnchor > 0 ? 1 : 0) + (projectScaffold > 0 ? 1 : 0);
   return makeResidentCost({
@@ -2044,6 +2088,9 @@ export {
   EXTERNAL_ASSETS,
   DEV_METHOD_SKILL_IDS,
   INTERNAL_BUNDLED_SKILL_IDS,
+  CONTINUOUS_SKILLS,
+  RENAMED_SKILL_IDS,
+  RETIRED_SKILL_IDS,
   TRUST_TIER,
   assetTrustTier,
   isAssetSelected,
@@ -2074,12 +2121,14 @@ export {
   legacyInstallLogPath,
   HARNESS_ANCHOR_FILE,
   HARNESS_IMPORT_LINE,
+  withContinuousSkillsNote,
   renderFillScaffold,
   upsertHarnessImport,
   stripHarnessImport,
   buildAssetSpec,
   resolveRules,
   ALL_RULES,
+  RETIRED_AGENT_IDS,
   isCliNeutralTarget,
   buildManifest,
   CATEGORIES,
@@ -2092,4 +2141,4 @@ export {
   formatResidentCostLine,
   formatResidentCostBlock
 };
-//# sourceMappingURL=chunk-NKBUDHPC.js.map
+//# sourceMappingURL=chunk-3QBHZUVB.js.map