@osfactory/har 1.18.0 → 1.19.0

package/dist/index.js

@@ -82005,7 +82005,9 @@ function buildInstallPlan(detection, targets, options = {}) {
     agentsMd: writeAgentsMd,
     migrateLegacyAgentMd: writeAgentsMd && detection.agentMd,
     providers: targets,
-    claudeMd: targets.includes("claude"),
+    // Deprecated: Claude Code reads AGENTS.md directly, so HAR no longer
+    // creates a CLAUDE.md. An existing one is still kept pointing at AGENTS.md.
+    claudeMd: targets.includes("claude") && detection.claudeMd,
     cursorRule: wantsCursor,
     skills: options.skills ?? []
   };
@@ -82019,7 +82021,7 @@ function formatInstallPlan(plan, detection) {
     lines.push(`  ${mark(true)} Migrate ${LEGACY_AGENT_MD} \u2192 ${AGENTS_MD}, then remove legacy file`);
   }
   lines.push(
-    `  ${mark(plan.claudeMd)} Claude \u2014 ensure ${CLAUDE_MD} points at ${AGENTS_MD}`
+    plan.claudeMd ? `  ${mark(true)} Claude \u2014 keep the existing ${CLAUDE_MD} pointing at ${AGENTS_MD}` : `  ${mark(false)} Claude \u2014 reads ${AGENTS_MD} directly (no ${CLAUDE_MD} created)`
   );
   lines.push(
     `  ${mark(plan.cursorRule)} Cursor \u2014 install/refresh .cursor/rules/har-workflow.mdc`
@@ -82153,13 +82155,6 @@ ${legacyTrimmed}
   return true;
 }
 var CLAUDE_MD_IMPORT = "@AGENTS.md";
-function loadClaudeMdTemplate() {
-  const templatePath = resolveTemplateFile("CLAUDE.md.template");
-  if (!templatePath) {
-    throw new Error("CLAUDE.md.template not found. Run npm run build.");
-  }
-  return fs51.readFileSync(templatePath, "utf8");
-}
 function isHarOwnedClaudeMd(content) {
   const trimmed = content.trim();
   if (trimmed === CLAUDE_MD_IMPORT) return true;
@@ -82171,11 +82166,9 @@ function hasAgentsImport(content) {
 }
 function ensureClaudeMdPointer(repoPath, options = {}) {
   const dest = path59.join(repoPath, CLAUDE_MD);
-  const thin = loadClaudeMdTemplate();
-  if (!fs51.existsSync(dest)) {
-    writeFileSafe(dest, thin);
-    return "created";
-  }
+  if (!fs51.existsSync(dest)) return "skipped";
+  const thin = `${CLAUDE_MD_IMPORT}
+`;
   const existing = fs51.readFileSync(dest, "utf8");
   if (isHarOwnedClaudeMd(existing) || options.force) {
     if (existing.trim() === CLAUDE_MD_IMPORT) return "skipped";
@@ -82283,9 +82276,7 @@ async function handleInstructionFiles(options) {
   }
   if (plan.claudeMd) {
     claudeMdAction = ensureClaudeMdPointer(repoPath);
-    if (claudeMdAction === "created") {
-      success(`Wrote ${CLAUDE_MD} (pointer \u2192 ${AGENTS_MD})`);
-    } else if (claudeMdAction === "updated" || claudeMdAction === "appended") {
+    if (claudeMdAction === "updated" || claudeMdAction === "appended") {
       info(
         `${claudeMdAction === "updated" ? "Updated" : "Appended"} ${CLAUDE_MD} pointer \u2192 ${AGENTS_MD}`
       );
@@ -83713,13 +83704,7 @@ function buildInstructionFileNotes(repoPath) {
     notes.push({
       kind: "claude_md_pointer",
       path: "CLAUDE.md",
-      message: "Keep CLAUDE.md as the `@AGENTS.md` import \u2014 no workflow content of its own. Existing project-specific notes stay; the import goes on top."
-    });
-  } else {
-    notes.push({
-      kind: "claude_md_pointer",
-      path: "CLAUDE.md",
-      message: "Optional: add a CLAUDE.md containing `@AGENTS.md` when Claude Code is used on this repo."
+      message: "Keep CLAUDE.md as the `@AGENTS.md` import \u2014 no workflow content of its own. Existing project-specific notes stay; the import goes on top. It is optional now that Claude Code reads AGENTS.md directly."
     });
   }
   return notes;

package/dist/templates/adaptation-prompt-init.md

@@ -202,7 +202,7 @@ Launch creates an isolated session worktree at `~/worktrees/<base>-<sha4>-har-ag
 
 Coding agents discover the harness through two files:
 
-1. **`AGENTS.md`** (repo root) — shared agent instructions (Codex auto-loads this; Claude via `CLAUDE.md` pointer)
+1. **`AGENTS.md`** (repo root) — shared agent instructions (Codex and Claude Code both auto-load this)
 2. **`.har/README.md`** — full index of what's in the harness
 
 Do **not** create `AGENT.md` (singular) — that legacy name is obsolete. If `AGENT.md` exists, merge any unique notes into `AGENTS.md` and delete `AGENT.md`.
@@ -219,14 +219,14 @@ If **no `AGENTS.md` exists**, create one at the repo root using this structure:
 
 If **`AGENTS.md` already exists** (project-owned), add or update a concise **HAR / agent environment** section — do not replace unrelated content.
 
-Keep **`CLAUDE.md`** as the line `@AGENTS.md` (Claude Code auto-loads `CLAUDE.md` and follows the import). Never paste the harness workflow into it — `AGENTS.md` is the single instruction file.
+Do **not** create a `CLAUDE.md` — Claude Code reads `AGENTS.md` directly. If one already exists, keep it as the line `@AGENTS.md` and never paste the harness workflow into it — `AGENTS.md` is the single instruction file.
 
 ### Monorepos / multiple harnesses
 
 If this repository contains **more than one project or `.har` harness** (check for `.har/` directories above or below this one):
 
 - Maintain a **"Harnesses in this repo"** table in the ROOT `AGENTS.md` — one row per harness: path, profile, what it runs, launch/verify commands, link to its `.har/README.md`. Lead with "pick the harness that owns the files you are changing."
-- Keep a small `AGENTS.md` (and `CLAUDE.md` pointer) **inside each project directory** for local discovery, with a back-link to the root index.
+- Keep a small `AGENTS.md` **inside each project directory** for local discovery, with a back-link to the root index.
 - Keep ONE Cursor rule at the repo root (`.cursor/rules/har-workflow.mdc`) listing all harnesses — not one rule per project.
 
 Include a **Run history** subsection:

package/dist/templates/adaptation-prompt-maintain.md

@@ -90,7 +90,7 @@ come back here afterwards. Two standing rules:
 
 - Verification customization lives in `stages.json` / `.har/stages/` — the
   top-level `*.sh` files are generated shims, safe to regenerate.
-- Repo-root agent docs (`AGENTS.md`, `CLAUDE.md`) follow Step 3 below.
+- Repo-root agent docs (`AGENTS.md`) follow Step 3 below.
 
 ## Step 3 — Refresh repo-root `AGENTS.md`
 
@@ -105,7 +105,7 @@ If harness commands, rules, or workflow changed, update the **HAR / agent enviro
 
 If `AGENTS.md` does not mention HAR yet, add a concise section. If it already has a HAR section, update it minimally — do not replace unrelated content.
 
-Do **not** create `AGENT.md` (singular). If legacy `AGENT.md` exists, merge unique notes into `AGENTS.md` and delete `AGENT.md`. Keep `CLAUDE.md` as the line `@AGENTS.md`.
+Do **not** create `AGENT.md` (singular). If legacy `AGENT.md` exists, merge unique notes into `AGENTS.md` and delete `AGENT.md`. Do not create a `CLAUDE.md`; if one exists, keep it as the line `@AGENTS.md`.
 
 ## Rules
 

package/dist/templates/agent-skills/setup-har.md

@@ -79,7 +79,7 @@ Fix the harness scripts until both pass. Then tear down or keep the slot as the
 After the user confirms, commit the harness:
 
 ```bash
-git add .har/ AGENTS.md CLAUDE.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENTS.md
+git add .har/ AGENTS.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENTS.md
 git commit -m "chore: add har agent harness"
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "HAR: open agent harness CLI and MCP server for coding agents, isolated worktrees, and software-factory workflows",
   "keywords": [
     "har",

package/dist/templates/CLAUDE.md.template

@@ -1 +0,0 @@
-@AGENTS.md