@uzysjung/agent-harness 26.95.0 → 26.97.0

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   hasUiTrack,
   init_esm_shims,
   isAssetSelected
-} from "./chunk-DSWWKCW3.js";
+} from "./chunk-WKXYOTUV.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -699,7 +699,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.95.0",
+  version: "26.97.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -928,13 +928,13 @@ function padDisplay(s, width) {
 init_esm_shims();
 import {
   chmodSync as chmodSync2,
-  existsSync as existsSync12,
+  existsSync as existsSync11,
   mkdirSync as mkdirSync4,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync11,
   writeFileSync as writeFileSync9
 } from "fs";
-import { dirname as dirname4, join as join11, resolve } from "path";
+import { basename as basename4, dirname as dirname4, join as join10, resolve } from "path";
 
 // src/antigravity/transform.ts
 init_esm_shims();
@@ -948,7 +948,7 @@ function renameSlashes(text) {
 }
 function renderAgentsMd(params) {
   const body = params.claudeMd.replace(/^#\s+.*\r?\n/, "").trim();
-  const replaced = params.template.replaceAll("{PROJECT_NAME}", params.projectName).replaceAll("{PROJECT_RULES}", body);
+  const replaced = params.template.replaceAll("{PROJECT_NAME}", params.projectName).replaceAll("{PROJECT_RULES}", body).replaceAll("{PROJECT_CONTEXT}", params.projectContext);
   return renameSlashes(replaced);
 }
 
@@ -1048,6 +1048,98 @@ function ensureProjectSkeleton(projectDir) {
   }
 }
 
+// src/project-claude-merge.ts
+init_esm_shims();
+var TRACK_DISPLAY_NAMES = {
+  tooling: "Tooling",
+  "csr-supabase": "CSR Supabase",
+  "csr-fastify": "CSR Fastify",
+  "csr-fastapi": "CSR FastAPI",
+  "ssr-htmx": "SSR HTMX",
+  "ssr-nextjs": "SSR Next.js",
+  data: "Data",
+  executive: "Executive",
+  full: "Full",
+  "project-management": "Project Management",
+  "growth-marketing": "Growth Marketing"
+};
+var FULL_EXPANSION = TRACKS.filter((t) => t !== "full");
+var FILL_SECTIONS = [
+  "identity",
+  "stack",
+  "architecture",
+  "installed-assets",
+  "boundaries",
+  "verify"
+];
+var FILL_SPECS = {
+  identity: {
+    title: "Identity & Purpose",
+    prompt: `Replace the H1 title above with this project's real name, then state in 1-2 plain sentences what it does, who uses it, and why it exists. Sources: README.md, the package.json / pyproject.toml "description", docs/. Do NOT describe the harness itself. Delete this comment when done.`,
+    placeholder: "what this project is, who it is for, and why it exists"
+  },
+  stack: {
+    title: "Stack & Commands",
+    prompt: "Replace the list below with this project's REAL stack. Inspect package.json / pyproject.toml / go.mod / Cargo.toml / Gemfile + lockfiles and any Makefile/justfile/package scripts. List the language(s)+versions, framework(s), package manager, and the exact install/build/test/run commands. Verify each command exists before writing it \u2014 never guess. Delete lines that do not apply, then delete this comment.",
+    placeholder: "languages, runtimes, package manager, and the install/build/test/run commands"
+  },
+  architecture: {
+    title: "Architecture & Layout",
+    prompt: "Map this repository. List each top-level source directory and what it holds, the entry point(s), the 3-5 files a newcomer reads first, and how data/requests flow between the main layers. View the real tree (e.g. `git ls-files | sed 's#/.*##' | sort -u`) \u2014 do not assume a framework's conventional layout. Flag any generated/vendored directories that must never be hand-edited. If this is a single small module, say so in one line. Delete this comment when done.",
+    placeholder: "where things live, the entry points, and how data flows between layers"
+  },
+  "installed-assets": {
+    title: "Installed Harness Assets",
+    prompt: "List the harness assets installed in this project (rules / skills / agents / commands) and add one line each on when to reach for it here. Verify against .claude/rules/*.md, .claude/skills/, .claude/agents/, .claude/commands/ (or this CLI's equivalent) and list ONLY assets whose file exists on disk \u2014 do not invent any. Do NOT restate the universal Rule 1-12 (they live in the rules layer) \u2014 cross-reference them instead. Delete this comment when done.",
+    placeholder: "the installed rules/skills/agents/commands and when to use each"
+  },
+  boundaries: {
+    title: "Boundaries \u2014 Always / Ask First / Never",
+    prompt: `Fill the Always / Ask First / Never lists with this repo's real red lines. Read the CI config, CODEOWNERS, .gitignore, and release/deploy scripts. Never must include secrets, generated files, force-push, and direct commits to the default branch, plus any repo-specific "do not touch" directories. Every entry must be specific and enforceable here. Delete this comment when done.`,
+    placeholder: "what to always do, ask before doing, and never do in this repo"
+  },
+  verify: {
+    title: "Verification Gate",
+    prompt: 'State the single command (or short sequence) that PROVES a change is safe here \u2014 the test/lint/typecheck/build gate you run before committing \u2014 plus the coverage/CI threshold and what "done" means. Sources: package scripts, CI workflow files, CONTRIBUTING. An agent must be able to self-verify without guessing. Delete this comment when done.',
+    placeholder: "the single command that proves a change is safe, and the done bar"
+  }
+};
+var SCAFFOLD_BANNER = [
+  "> \u2699\uFE0F **SCAFFOLD \u2014 not filled in yet.** The sections below are a fill-in template for THIS project, not verified facts.",
+  "> To fill: open this file and paste each `<!-- FILL: \u2026 -->` comment's instruction into your coding agent (e.g. Claude Code) \u2014 it will inspect the real repo and write the section. You can also fill them by hand; the comments are the instructions.",
+  "> The universal harness rules (Rule 1\u201312) live in the separate rules layer. This file is **project-specific context only**."
+].join("\n");
+function renderFillScaffold() {
+  const blocks = FILL_SECTIONS.map((id) => {
+    const spec = FILL_SPECS[id];
+    return `## ${spec.title}
+
+<!-- FILL:${id} \u2014 ${spec.prompt} -->
+
+_(not filled yet \u2014 ${spec.placeholder})_`;
+  });
+  return `${SCAFFOLD_BANNER}
+
+${blocks.join("\n\n")}`;
+}
+function mergeProjectClaude(tracks, opts) {
+  const expanded = expandTracks(tracks);
+  const trackList = expanded.map((t) => TRACK_DISPLAY_NAMES[t]).join(", ");
+  const header = `# ${opts.projectName}
+
+> Active track(s): ${trackList}`;
+  return `${header}
+
+${renderFillScaffold()}
+`;
+}
+function expandTracks(tracks) {
+  if (tracks.includes("full")) {
+    return FULL_EXPANSION;
+  }
+  return tracks;
+}
+
 // src/antigravity/transform.ts
 function runAntigravityTransform(params) {
   const { harnessRoot, projectDir, selectedInternalSkills = [] } = params;
@@ -1077,7 +1169,14 @@ function writeRules(harnessRoot, projectDir) {
   const rulesDir = join2(projectDir, ".agents", "rules");
   ensureDir(rulesDir);
   const target = join2(rulesDir, "uzys-harness.md");
-  writeFileSync(target, renderAgentsMd({ template, claudeMd, projectName: basename(projectDir) }));
+  const rulesOut = renderAgentsMd({
+    template,
+    claudeMd,
+    projectName: basename(projectDir),
+    projectContext: renderFillScaffold()
+  });
+  backupFileIfChanged(target, rulesOut);
+  writeFileSync(target, rulesOut);
   return target;
 }
 
@@ -1210,7 +1309,14 @@ function runCodexTransform(params) {
   const mcp = readOptionalJson(join4(harnessRoot, ".mcp.json"));
   const agentsMdPath = join4(projectDir, "AGENTS.md");
   ensureDir(projectDir);
-  writeFileSync3(agentsMdPath, renderAgentsMd({ template: agentsTemplate, claudeMd, projectName }));
+  const agentsMdOut = renderAgentsMd({
+    template: agentsTemplate,
+    claudeMd,
+    projectName,
+    projectContext: renderFillScaffold()
+  });
+  backupFileIfChanged(agentsMdPath, agentsMdOut);
+  writeFileSync3(agentsMdPath, agentsMdOut);
   const configTomlPath = join4(projectDir, ".codex/config.toml");
   ensureDir(join4(projectDir, ".codex"));
   writeFileSync3(
@@ -1999,7 +2105,7 @@ function renameSlashes2(text) {
 }
 function renderAgentsMd2(params) {
   const body = params.claudeMd.replace(/^#\s+.*\r?\n/, "").trim();
-  const replaced = params.template.replaceAll("{PROJECT_NAME}", params.projectName).replaceAll("{PROJECT_RULES}", body);
+  const replaced = params.template.replaceAll("{PROJECT_NAME}", params.projectName).replaceAll("{PROJECT_RULES}", body).replaceAll("{PROJECT_CONTEXT}", params.projectContext);
   return renameSlashes2(replaced);
 }
 
@@ -2093,7 +2199,14 @@ function runOpencodeTransform(params) {
   const mcp = readOptionalJson2(join8(harnessRoot, ".mcp.json"));
   ensureDir(projectDir);
   const agentsMdPath = join8(projectDir, "AGENTS.md");
-  writeFileSync7(agentsMdPath, renderAgentsMd2({ template: agentsTemplate, claudeMd, projectName }));
+  const agentsMdOut = renderAgentsMd2({
+    template: agentsTemplate,
+    claudeMd,
+    projectName,
+    projectContext: renderFillScaffold()
+  });
+  backupFileIfChanged(agentsMdPath, agentsMdOut);
+  writeFileSync7(agentsMdPath, agentsMdOut);
   const opencodeJsonPath = join8(projectDir, "opencode.json");
   writeFileSync7(opencodeJsonPath, renderOpencodeJson({ template: opencodeTemplate, mcp }));
   const cmdDir = join8(projectDir, ".opencode/commands");
@@ -2127,134 +2240,6 @@ function readOptionalJson2(path) {
   }
 }
 
-// src/project-claude-merge.ts
-init_esm_shims();
-import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
-import { join as join9 } from "path";
-var SECTIONS = [
-  "stack",
-  "workflow",
-  "active-rules",
-  "agents",
-  "skills",
-  "plugins",
-  "commands",
-  "boundaries",
-  "supabase-auth"
-];
-var SECTION_TITLES = {
-  stack: "Stack",
-  workflow: "Workflow",
-  "active-rules": "Active Rules",
-  agents: "Agents",
-  skills: "Skills",
-  plugins: "Plugins",
-  commands: "Commands",
-  boundaries: "Boundaries",
-  "supabase-auth": "Supabase auth configuration"
-};
-var TRACK_DISPLAY_NAMES = {
-  tooling: "Tooling",
-  "csr-supabase": "CSR Supabase",
-  "csr-fastify": "CSR Fastify",
-  "csr-fastapi": "CSR FastAPI",
-  "ssr-htmx": "SSR HTMX",
-  "ssr-nextjs": "SSR Next.js",
-  data: "Data",
-  executive: "Executive",
-  full: "Full",
-  "project-management": "Project Management",
-  "growth-marketing": "Growth Marketing"
-};
-var FULL_EXPANSION = [
-  "tooling",
-  "csr-fastapi",
-  "csr-fastify",
-  "csr-supabase",
-  "ssr-htmx",
-  "ssr-nextjs",
-  "data",
-  "executive",
-  "project-management",
-  "growth-marketing"
-];
-function mergeProjectClaude(tracks, opts) {
-  const expanded = expandTracks(tracks);
-  const baseRaw = readFileSync10(join9(opts.baseDir, "_base.md"), "utf8");
-  let output = baseRaw;
-  output = output.replace("<!-- INSERT: track-list -->", trackList(expanded));
-  output = output.replace("<!-- INSERT: tagline -->", taglineList(expanded, opts.baseDir));
-  for (const section of SECTIONS) {
-    const marker = `<!-- INSERT: ${section} -->`;
-    const block = renderSection(section, expanded, opts.baseDir);
-    if (block === null) {
-      output = stripMarkerLine(output, marker);
-    } else {
-      output = output.replace(marker, block);
-    }
-  }
-  return `${output.replace(/\n{3,}/g, "\n\n").trimEnd()}
-`;
-}
-function expandTracks(tracks) {
-  if (tracks.includes("full")) {
-    return FULL_EXPANSION;
-  }
-  return tracks;
-}
-function trackList(tracks) {
-  return tracks.map((t) => TRACK_DISPLAY_NAMES[t]).join(", ");
-}
-function taglineList(tracks, baseDir) {
-  const taglines = [];
-  for (const t of tracks) {
-    const path = join9(baseDir, "fragments", t, "tagline.md");
-    if (!existsSync10(path)) {
-      continue;
-    }
-    const body = readFileSync10(path, "utf8").trim();
-    if (body) {
-      taglines.push(body);
-    }
-  }
-  return taglines.join(" / ");
-}
-function renderSection(section, tracks, baseDir) {
-  const present = [];
-  for (const t of tracks) {
-    const path = join9(baseDir, "fragments", t, `${section}.md`);
-    if (!existsSync10(path)) {
-      continue;
-    }
-    const body = readFileSync10(path, "utf8").trim();
-    if (body) {
-      present.push({ track: t, body });
-    }
-  }
-  if (present.length === 0) {
-    return null;
-  }
-  const title = `## ${SECTION_TITLES[section]}`;
-  if (present.length === 1 && present[0]) {
-    return `${title}
-
-${present[0].body}
-`;
-  }
-  const blocks = present.map(({ track, body }) => `### ${TRACK_DISPLAY_NAMES[track]}
-
-${body}`);
-  return `${title}
-
-${blocks.join("\n\n")}
-`;
-}
-function stripMarkerLine(text, marker) {
-  const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const pattern = new RegExp(`\\n*${escaped}\\n*`);
-  return text.replace(pattern, "\n");
-}
-
 // src/settings-merge.ts
 init_esm_shims();
 function addPreToolUseHook(settings, matcher, command) {
@@ -2283,15 +2268,15 @@ function addPreToolUseHook(settings, matcher, command) {
 init_esm_shims();
 import {
   copyFileSync as copyFileSync2,
-  existsSync as existsSync11,
+  existsSync as existsSync10,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync11,
+  readFileSync as readFileSync10,
   unlinkSync,
   writeFileSync as writeFileSync8
 } from "fs";
-import { join as join10 } from "path";
+import { join as join9 } from "path";
 function runUpdateMode(projectDir, templatesDir) {
-  const claudeDir = join10(projectDir, ".claude");
+  const claudeDir = join9(projectDir, ".claude");
   const report = {
     updated: {},
     pruned: {},
@@ -2300,26 +2285,26 @@ function runUpdateMode(projectDir, templatesDir) {
   };
   const targets = [
     {
-      target: join10(claudeDir, "rules"),
-      source: join10(templatesDir, "rules"),
+      target: join9(claudeDir, "rules"),
+      source: join9(templatesDir, "rules"),
       pattern: ".md",
       label: ".claude/rules"
     },
     {
-      target: join10(claudeDir, "agents"),
-      source: join10(templatesDir, "agents"),
+      target: join9(claudeDir, "agents"),
+      source: join9(templatesDir, "agents"),
       pattern: ".md",
       label: ".claude/agents"
     },
     {
-      target: join10(claudeDir, "commands/uzys"),
-      source: join10(templatesDir, "commands/uzys"),
+      target: join9(claudeDir, "commands/uzys"),
+      source: join9(templatesDir, "commands/uzys"),
       pattern: ".md",
       label: ".claude/commands/uzys"
     },
     {
-      target: join10(claudeDir, "hooks"),
-      source: join10(templatesDir, "hooks"),
+      target: join9(claudeDir, "hooks"),
+      source: join9(templatesDir, "hooks"),
       pattern: ".sh",
       label: ".claude/hooks"
     }
@@ -2328,26 +2313,26 @@ function runUpdateMode(projectDir, templatesDir) {
     report.updated[t.label] = updateDir(t.target, t.source, t.pattern);
     report.pruned[t.label] = pruneOrphans(t.target, t.source, t.pattern);
   }
-  const claudeMd = join10(claudeDir, "CLAUDE.md");
-  const templateMd = join10(templatesDir, "CLAUDE.md");
-  if (existsSync11(claudeMd) && existsSync11(templateMd)) {
+  const claudeMd = join9(claudeDir, "CLAUDE.md");
+  const templateMd = join9(templatesDir, "CLAUDE.md");
+  if (existsSync10(claudeMd) && existsSync10(templateMd)) {
     copyFileSync2(templateMd, claudeMd);
     report.claudeMdUpdated = true;
   }
-  const settingsPath = join10(claudeDir, "settings.json");
-  if (existsSync11(settingsPath)) {
-    report.staleHookRefs = cleanStaleHookRefs(settingsPath, join10(claudeDir, "hooks"));
+  const settingsPath = join9(claudeDir, "settings.json");
+  if (existsSync10(settingsPath)) {
+    report.staleHookRefs = cleanStaleHookRefs(settingsPath, join9(claudeDir, "hooks"));
   }
   return report;
 }
 function updateDir(target, source, ext) {
-  if (!existsSync11(target) || !existsSync11(source)) return 0;
+  if (!existsSync10(target) || !existsSync10(source)) return 0;
   let count = 0;
   for (const file of readdirSync2(target)) {
     if (!file.endsWith(ext)) continue;
-    const targetFile = join10(target, file);
-    const sourceFile = join10(source, file);
-    if (existsSync11(sourceFile)) {
+    const targetFile = join9(target, file);
+    const sourceFile = join9(source, file);
+    if (existsSync10(sourceFile)) {
       copyFileSync2(sourceFile, targetFile);
       count++;
     }
@@ -2355,13 +2340,13 @@ function updateDir(target, source, ext) {
   return count;
 }
 function pruneOrphans(target, source, ext) {
-  if (!existsSync11(target) || !existsSync11(source)) return [];
+  if (!existsSync10(target) || !existsSync10(source)) return [];
   const removed = [];
   for (const file of readdirSync2(target)) {
     if (!file.endsWith(ext)) continue;
-    const sourceFile = join10(source, file);
-    if (!existsSync11(sourceFile)) {
-      const targetFile = join10(target, file);
+    const sourceFile = join9(source, file);
+    if (!existsSync10(sourceFile)) {
+      const targetFile = join9(target, file);
       try {
         unlinkSync(targetFile);
         removed.push(file);
@@ -2374,7 +2359,7 @@ function pruneOrphans(target, source, ext) {
 function cleanStaleHookRefs(settingsPath, hooksDir) {
   let settings;
   try {
-    settings = JSON.parse(readFileSync11(settingsPath, "utf8"));
+    settings = JSON.parse(readFileSync10(settingsPath, "utf8"));
   } catch {
     return [];
   }
@@ -2402,7 +2387,7 @@ function keepHookRef(hook, hooksDir, removed) {
   const refMatch = (hook?.command ?? "").match(/\/\.claude\/hooks\/([^"\s/]+\.sh)/);
   if (!refMatch?.[1]) return true;
   const fname = refMatch[1];
-  const exists = existsSync11(join10(hooksDir, fname));
+  const exists = existsSync10(join9(hooksDir, fname));
   if (!exists && !removed.includes(fname)) removed.push(fname);
   return exists;
 }
@@ -2413,12 +2398,12 @@ var KARPATHY_ASSET_ID = "karpathy-coder";
 function runInstall(ctx) {
   const { harnessRoot, projectDir, spec } = ctx;
   const mode = ctx.mode ?? "fresh";
-  const templatesDir = join11(harnessRoot, "templates");
-  if (!existsSync12(templatesDir)) {
+  const templatesDir = join10(harnessRoot, "templates");
+  if (!existsSync11(templatesDir)) {
     throw new Error(`Templates dir not found: ${templatesDir}`);
   }
-  const claudeDir = join11(projectDir, ".claude");
-  if (mode === "update" && !existsSync12(claudeDir)) {
+  const claudeDir = join10(projectDir, ".claude");
+  if (mode === "update" && !existsSync11(claudeDir)) {
     throw new Error(`Update mode requires existing .claude/ at ${claudeDir}`);
   }
   const backupPath = resolveBackupPath(ctx, mode, claudeDir);
@@ -2426,7 +2411,7 @@ function runInstall(ctx) {
     return runUpdateInstall(ctx, templatesDir, backupPath);
   }
   const manifestSpec = buildManifestSpec(spec);
-  const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, harnessRoot, projectDir, templatesDir) : emptyClaudeBaseline();
+  const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, projectDir, templatesDir) : emptyClaudeBaseline();
   const mcpResult = composeAndWriteMcp(harnessRoot, projectDir, spec);
   const baseline = {
     filesCopied: base.filesCopied,
@@ -2512,7 +2497,7 @@ function emptyClaudeBaseline() {
     backups: []
   };
 }
-function installClaudeBaseline(manifestSpec, harnessRoot, projectDir, templatesDir) {
+function installClaudeBaseline(manifestSpec, projectDir, templatesDir) {
   ensureProjectSkeleton(projectDir);
   const result = emptyClaudeBaseline();
   const manifest = buildManifest(manifestSpec);
@@ -2520,15 +2505,15 @@ function installClaudeBaseline(manifestSpec, harnessRoot, projectDir, templatesD
     if (!entry.applies(manifestSpec)) {
       continue;
     }
-    const source = join11(templatesDir, entry.source);
-    const target = join11(projectDir, entry.target);
-    if (!existsSync12(source)) {
+    const source = join10(templatesDir, entry.source);
+    const target = join10(projectDir, entry.target);
+    if (!existsSync11(source)) {
       result.skipped += 1;
       continue;
     }
     if (entry.type === "file") {
       if (entry.target === ".claude/settings.json") {
-        const backup = backupFileIfChanged(target, readFileSync12(source, "utf-8"));
+        const backup = backupFileIfChanged(target, readFileSync11(source, "utf-8"));
         if (backup) {
           result.backups.push(backup);
         }
@@ -2541,12 +2526,12 @@ function installClaudeBaseline(manifestSpec, harnessRoot, projectDir, templatesD
     }
     accumulateCategory(result.categories, entry);
   }
-  const hookDir = join11(projectDir, ".claude/hooks");
-  if (existsSync12(hookDir)) {
+  const hookDir = join10(projectDir, ".claude/hooks");
+  if (existsSync11(hookDir)) {
     chmodHooksSync(hookDir);
   }
   writeInstalledTracks(projectDir, manifestSpec.tracks);
-  const rootClaudeMd = writeRootClaudeMd(harnessRoot, projectDir, manifestSpec.tracks);
+  const rootClaudeMd = writeRootClaudeMd(projectDir, manifestSpec.tracks);
   result.rootClaudeMd = { tracks: manifestSpec.tracks };
   result.rootClaudeMdLog = { path: "CLAUDE.md", sha256: hashContent(rootClaudeMd.content) };
   if (rootClaudeMd.backup) {
@@ -2649,10 +2634,10 @@ function wireKarpathyHook(spec, external, harnessRoot, projectDir) {
   if (!karpathyResult?.ok) {
     return { wired: false, reason: "plugin-install-failed" };
   }
-  const sourceHook = join11(harnessRoot, "templates/hooks/karpathy-gate.sh");
-  const targetHook = join11(projectDir, ".claude/hooks/karpathy-gate.sh");
+  const sourceHook = join10(harnessRoot, "templates/hooks/karpathy-gate.sh");
+  const targetHook = join10(projectDir, ".claude/hooks/karpathy-gate.sh");
   let hookScriptCopied = false;
-  if (existsSync12(sourceHook)) {
+  if (existsSync11(sourceHook)) {
     copyFile(sourceHook, targetHook);
     try {
       chmodSync2(targetHook, 493);
@@ -2660,10 +2645,10 @@ function wireKarpathyHook(spec, external, harnessRoot, projectDir) {
     }
     hookScriptCopied = true;
   }
-  const settingsPath = join11(projectDir, ".claude/settings.json");
+  const settingsPath = join10(projectDir, ".claude/settings.json");
   let settingsUpdated = false;
-  if (existsSync12(settingsPath)) {
-    const raw = readFileSync12(settingsPath, "utf8");
+  if (existsSync11(settingsPath)) {
+    const raw = readFileSync11(settingsPath, "utf8");
     let before;
     try {
       before = JSON.parse(raw);
@@ -2682,10 +2667,10 @@ function wireKarpathyHook(spec, external, harnessRoot, projectDir) {
   return { wired: true, settingsUpdated, hookScriptCopied };
 }
 function composeAndWriteMcp(harnessRoot, projectDir, spec) {
-  const mcpPath = join11(projectDir, ".mcp.json");
+  const mcpPath = join10(projectDir, ".mcp.json");
   const composed = composeMcpJson({
-    templateMcpPath: join11(harnessRoot, "templates/mcp.json"),
-    trackMapPath: join11(harnessRoot, "templates/track-mcp-map.tsv"),
+    templateMcpPath: join10(harnessRoot, "templates/mcp.json"),
+    trackMapPath: join10(harnessRoot, "templates/track-mcp-map.tsv"),
     existingPath: mcpPath,
     tracks: spec.tracks
   });
@@ -2711,16 +2696,15 @@ function accumulateCategory(cats, entry) {
   }
 }
 function writeInstalledTracks(projectDir, tracks) {
-  const path = join11(projectDir, ".claude/.installed-tracks");
+  const path = join10(projectDir, ".claude/.installed-tracks");
   mkdirSync4(dirname4(path), { recursive: true });
   const sorted = [...new Set(tracks)].sort().join("\n");
   writeFileSync9(path, `${sorted}
 `);
 }
-function writeRootClaudeMd(harnessRoot, projectDir, tracks) {
-  const baseDir = join11(harnessRoot, "templates/project-claude");
-  const content = mergeProjectClaude(tracks, { baseDir });
-  const target = join11(projectDir, "CLAUDE.md");
+function writeRootClaudeMd(projectDir, tracks) {
+  const content = mergeProjectClaude(tracks, { projectName: basename4(projectDir) });
+  const target = join10(projectDir, "CLAUDE.md");
   const backup = backupFileIfChanged(target, content);
   writeFileSync9(target, content);
   return { content, backup };
@@ -2956,8 +2940,27 @@ function renderFinalSummary(log, spec, report, fromWizard) {
   const primary = (spec.cli.includes("claude") ? "claude" : spec.cli[0]) ?? "claude";
   const label = CLI_SUMMARY_LABELS[primary];
   log(infoRow("NEXT", `Open ${c.bold(label)} \u2014 installed rules & skills are now active`));
+  const scaffoldFiles = scaffoldFilesForCli(spec.cli);
+  if (scaffoldFiles.length > 0) {
+    log(
+      infoRow(
+        "FILL",
+        `${scaffoldFiles.map((f) => c.bold(f)).join(" \xB7 ")} \u2014 a fill-in scaffold. Open and paste each ${c.bold("<!-- FILL: \u2026 -->")} prompt to your agent to tailor it to this project`
+      )
+    );
+  }
   log("");
 }
+function scaffoldFilesForCli(cli2) {
+  const files = [];
+  if (cli2.includes("claude")) {
+    files.push("CLAUDE.md");
+  }
+  if (cli2.some((target) => target !== "claude")) {
+    files.push("AGENTS.md");
+  }
+  return files;
+}
 function formatAssetMeta(asset, version) {
   const m = asset.method;
   const v2 = version ? ` ${c.dim(`v${version.replace(/^v/, "")}`)}` : "";
@@ -3065,7 +3068,7 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false) {
       assetRow(
         "success",
         "CLAUDE.md (root)",
-        `merged from ${n} track${n > 1 ? "s" : ""}`,
+        `fill-in scaffold \xB7 ${n} track${n > 1 ? "s" : ""} noted`,
         TEMPLATES_COL
       )
     );
@@ -3332,8 +3335,8 @@ function registerInstallCommand(cli2) {
 // src/commands/uninstall.ts
 init_esm_shims();
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync13, readFileSync as readFileSync13, rmSync } from "fs";
-import { join as join12, resolve as resolve3 } from "path";
+import { existsSync as existsSync12, readFileSync as readFileSync12, rmSync } from "fs";
+import { join as join11, resolve as resolve3 } from "path";
 function uninstallAction(options, deps = {}) {
   const log = deps.log ?? console.log;
   const err = deps.err ?? console.error;
@@ -3505,22 +3508,22 @@ function buildGlobalAdvisoryCmd(asset) {
   }
 }
 function removeTemplates(log, projectDir, rm) {
-  rm(join12(projectDir, log.templates.claudeDir));
-  if (log.templates.codexDir) rm(join12(projectDir, log.templates.codexDir));
-  if (log.templates.opencodeDir) rm(join12(projectDir, log.templates.opencodeDir));
+  rm(join11(projectDir, log.templates.claudeDir));
+  if (log.templates.codexDir) rm(join11(projectDir, log.templates.codexDir));
+  if (log.templates.opencodeDir) rm(join11(projectDir, log.templates.opencodeDir));
   const rootMd = log.templates.rootClaudeMd;
   if (rootMd) {
     if (rootClaudeMdModified(log, projectDir)) return { rootClaudeMdKept: true };
-    rm(join12(projectDir, rootMd.path));
+    rm(join11(projectDir, rootMd.path));
   }
   return { rootClaudeMdKept: false };
 }
 function rootClaudeMdModified(log, projectDir) {
   const rootMd = log.templates.rootClaudeMd;
   if (!rootMd) return false;
-  const path = join12(projectDir, rootMd.path);
-  if (!existsSync13(path)) return false;
-  return hashContent(readFileSync13(path, "utf8")) !== rootMd.sha256;
+  const path = join11(projectDir, rootMd.path);
+  if (!existsSync12(path)) return false;
+  return hashContent(readFileSync12(path, "utf8")) !== rootMd.sha256;
 }
 function formatTemplateList(log) {
   const items = [log.templates.claudeDir];
@@ -3532,7 +3535,7 @@ function defaultSpawn2(cmd, args) {
   return spawnSync2(cmd, [...args], { encoding: "utf8", stdio: "pipe", timeout: 12e4 });
 }
 function defaultRm(path) {
-  if (existsSync13(path)) {
+  if (existsSync12(path)) {
     rmSync(path, { recursive: true, force: true });
   }
 }
@@ -4563,9 +4566,9 @@ function summarizeState(state) {
   if (state.state === "new") {
     return "No prior install detected \u2014 new install flow.";
   }
-  const trackList2 = state.tracks.length > 0 ? state.tracks.join(", ") : "(no tracks resolved)";
+  const trackList = state.tracks.length > 0 ? state.tracks.join(", ") : "(no tracks resolved)";
   const sourceLabel = state.source === "metafile" ? "via .claude/.installed-tracks" : state.source === "legacy" ? "via legacy rules/*.md heuristic" : "via no source";
-  return `Existing install detected ${sourceLabel}. Tracks: ${trackList2}.`;
+  return `Existing install detected ${sourceLabel}. Tracks: ${trackList}.`;
 }
 
 // src/wizard-steps.ts
@@ -4808,8 +4811,8 @@ Proceed?`,
 
 // src/state.ts
 init_esm_shims();
-import { existsSync as existsSync14, readFileSync as readFileSync14 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync13, readFileSync as readFileSync13 } from "fs";
+import { join as join12 } from "path";
 var META_FILE = ".claude/.installed-tracks";
 var LEGACY_SIGNATURES = [
   { rule: "htmx.md", track: "ssr-htmx" },
@@ -4819,13 +4822,13 @@ var LEGACY_SIGNATURES = [
   { rule: "cli-development.md", track: "tooling" }
 ];
 function detectInstallState(projectDir) {
-  const claudeDir = join13(projectDir, ".claude");
-  const hasClaudeDir = existsSync14(claudeDir);
+  const claudeDir = join12(projectDir, ".claude");
+  const hasClaudeDir = existsSync13(claudeDir);
   if (!hasClaudeDir) {
     return { state: "new", tracks: [], source: "none", hasClaudeDir: false };
   }
-  const metaPath = join13(projectDir, META_FILE);
-  if (existsSync14(metaPath)) {
+  const metaPath = join12(projectDir, META_FILE);
+  if (existsSync13(metaPath)) {
     const tracks2 = readMetafile(metaPath);
     return { state: "existing", tracks: tracks2, source: "metafile", hasClaudeDir: true };
   }
@@ -4833,7 +4836,7 @@ function detectInstallState(projectDir) {
   return { state: "existing", tracks, source: "legacy", hasClaudeDir: true };
 }
 function readMetafile(path) {
-  const raw = readFileSync14(path, "utf8");
+  const raw = readFileSync13(path, "utf8");
   const seen = /* @__PURE__ */ new Set();
   for (const line of raw.split(/\s+/)) {
     const trimmed = line.trim();
@@ -4844,13 +4847,13 @@ function readMetafile(path) {
   return [...seen].sort();
 }
 function inferFromLegacySignatures(projectDir) {
-  const rulesDir = join13(projectDir, ".claude/rules");
-  if (!existsSync14(rulesDir)) {
+  const rulesDir = join12(projectDir, ".claude/rules");
+  if (!existsSync13(rulesDir)) {
     return [];
   }
   const found = /* @__PURE__ */ new Set();
   for (const sig of LEGACY_SIGNATURES) {
-    if (existsSync14(join13(rulesDir, sig.rule))) {
+    if (existsSync13(join12(rulesDir, sig.rule))) {
       found.add(sig.track);
     }
   }