@osfactory/har 0.43.1 → 0.44.0

package/dist/prompts/system-authoring.md

@@ -12,7 +12,7 @@ Explore the target repository, then edit files in `.har/` directly to make the h
 
 Coding agents discover the harness through two files:
 
-1. **`AGENT.md`** (repo root) — short pointer, always read first. Propose via `proposeAgentMd` — never write it directly.
+1. **`AGENTS.md`** (repo root) — short pointer, always read first. Propose via `proposeAgentsMd` — never write it directly.
 2. **`.har/README.md`** — full index of what's in the harness. **You must maintain this** on every init/maintain run.
 
 ## Tools Available
@@ -29,7 +29,7 @@ Coding agents discover the harness through two files:
 - `deleteHarnessFile(path)` — remove unnecessary files
 
 **Root agent guide:**
-- `proposeAgentMd(content, rationale)` — propose AGENT.md changes for user approval
+- `proposeAgentsMd(content, rationale)` — propose AGENTS.md changes for user approval
 
 **Other:**
 - `ask(question, options?)` — ask user when genuinely ambiguous
@@ -87,7 +87,7 @@ Detailed agent instructions: commands, credentials, architecture, definition of
 ### `.har/env.template`, `setup-infra.sh`, `docker-compose.agent.yml`
 As needed for the project's infra.
 
-### `AGENT.md` (repo root — via proposeAgentMd only)
+### `AGENTS.md` (repo root — via proposeAgentsMd only)
 Short pointer document. Structure:
 - Link to `.har/README.md` and `.har/CLAUDE.agent.md`
 - State plainly: **the harness is how you run this project** — to see the app live (manual testing, browser, screenshots), `launch` a slot; never hand-roll docker/dev-server startup; fix or report a failing harness command instead of working around it
@@ -96,12 +96,12 @@ Short pointer document. Structure:
 - Rules (no hardcoded ports, use agent-cli.sh)
 - Project-specific notes section
 
-If AGENT.md already exists, read it first and propose minimal updates — don't replace unrelated content.
+If AGENTS.md already exists, read it first and propose minimal updates — don't replace unrelated content.
 
 ### Monorepos / multiple harnesses
 If the repository contains more than one project or `.har` harness (check for `.har/` directories above or below the one you are adapting):
-- Propose a **"Harnesses in this repo"** table for the ROOT `AGENT.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 `AGENT.md` / `CLAUDE.md` pointer inside each project directory (local discovery), back-linking to the root index.
+- Propose a **"Harnesses in this repo"** table for 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` / `CLAUDE.md` pointer inside each project directory (local discovery), back-linking to the root index.
 - One Cursor rule at repo root listing all harnesses — never one rule per project.
 
 ## Port allocation & shared services
@@ -138,7 +138,7 @@ Set slot limits in `.har/stages.json` (`agentSlots`) based on machine capacity.
 
 1. **Edit .har/ files directly** — no YAML runtime config
 2. **Always update README.md** in .har/ to reflect current harness state
-3. **Always call proposeAgentMd** with AGENT.md content (create or update proposal)
+3. **Always call proposeAgentsMd** with AGENTS.md content (create or update proposal)
 4. **Reuse existing project commands** from package.json, Makefile, etc.
 5. **Replace all TODO placeholders**
 6. **Do not edit manifest.json** — managed by har CLI

package/dist/templates/AGENTS.md.template

@@ -0,0 +1,73 @@
+# Agent Environment
+
+This repository uses a **`.har/` harness** for isolated agent development.
+
+<!-- har:agent-environment:start -->
+## HAR / agent environment
+
+The harness is not just a verification gate — it is **how you run this project**.
+To see the app live (manual testing, browser sessions, screenshots, driving the UI),
+use `har env launch <id>` or `./.har/launch.sh <id>`. It already encodes database
+setup, ports, env vars, and process management — never hand-roll `docker` / dev-server
+startup, and never claim a task "can't be verified live" without launching a slot first.
+
+If a harness command fails, fix the harness (or report the failure) — do not quietly
+fall back to ad-hoc commands.
+
+### Before making changes
+
+1. On the **main checkout**, switch to the intended base (usually `main`) — launch
+   creates a worktree from that HEAD.
+2. **Launch first** — MCP `har_launch_environment` / `har env launch 1`. Use the
+   returned **work dir** for ALL edits (never the main checkout).
+3. Read [`.har/README.md`](.har/README.md), [`.har/stages.json`](.har/stages.json), then
+   [`.har/CLAUDE.agent.md`](.har/CLAUDE.agent.md) (slot URLs / definition of done).
+4. Hot-reload usually applies; if not, `./.har/agent-cli.sh <id> restart` (no-op on
+   cli/ios profiles without managed processes).
+
+**Occupied slots always block.** Run `complete` / `teardown`, then `launch`. Resume
+failed/starting launches with `--resume` / `recover`. Prefer a free slot (2+) over
+sharing slot 1 across unrelated chats. Check `har_get_status` / `har env status` first.
+Commit early — teardown keeps the branch, not uncommitted work.
+
+### After making changes
+
+Prefer MCP → CLI → shell. Quick verify for the loop; **full verify before done**.
+
+- MCP: `har_run_verification` / `full: true`; finish with `har_complete_environment`
+  (propose; wait for approval) or `har_teardown_environment`
+- CLI: `har env verify 1`, `har env verify 1 --full`, `complete 1`, `teardown 1`
+- Shell: `./.har/verify.sh 1`, `./.har/verify.sh 1 --full`, `./.har/teardown.sh 1`
+
+Commit in the session worktree. Run JSON stays in the main checkout `.har/runs/`.
+
+### Definition of done
+
+- Full verify passes; edits only in the session worktree; tests cover new behavior;
+  changes committed; show preview URLs; then **session handoff** (below).
+
+### Session handoff (required)
+
+After full verify and commit, stop. Include summary, session branch
+(`.har/slots/agent-<id>.json`), and preview URLs. Wait — never autonomously
+complete, teardown, push, or open a PR. **Default:** when `gh`/GitHub MCP is available,
+recommend **Complete + open a PR** (still needs approval). Alternatives: **Complete only**,
+or **Something else**. Without PR tooling, recommend **Complete only** and give the
+session branch for a manual push.
+
+### Commit gate
+
+Full verify records a tree hash under `.har/validations/`. With `har hooks install`,
+commits must match a passing full verify. Re-verify after any edit; `git add -A`.
+Do not bypass (`--no-verify`, `HAR_SKIP_GATE=1`).
+
+### Cursor IDE
+
+If `.cursor/rules/har-workflow.mdc` exists, the same harness workflow is injected into
+every Cursor agent session automatically. Run `har env init` or `har env maintain` to
+create or refresh it.
+<!-- har:agent-environment:end -->
+
+## Project-specific notes
+
+<!-- Adapt when customizing the harness (see .har/ADAPT-PROMPT.md) -->

package/dist/templates/CLAUDE.md.template

@@ -1,5 +1,5 @@
 # __PROJECT_DISPLAY_NAME__
 
-Read [AGENT.md](./AGENT.md) and [.har/README.md](./.har/README.md) before changing this project.
+Read [AGENTS.md](./AGENTS.md) and [.har/README.md](./.har/README.md) before changing this project.
 Harness workflow is enforced automatically in Cursor via `.cursor/rules/har-workflow.mdc`
 (created by `har env init`).

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

@@ -167,14 +167,18 @@ Onboarding may set an initial `agentSlots.max` in `.har/stages.json`. After you
 ### Git worktree
 `launch.sh` creates an isolated session worktree at `~/worktrees/<base>-<sha4>-har-agent-<id>-<rand4>` by default (`HARNESS_USE_WORKTREE=true`) and records it in `.har/slots/agent-<id>.json`. Agents should commit from that worktree, not the main checkout.
 
-## Step 3 — Update repo-root `AGENT.md`
+## Step 3 — Update repo-root `AGENTS.md`
 
 Coding agents discover the harness through two files:
 
-1. **`AGENT.md`** (repo root) — short pointer, always read first
+1. **`AGENTS.md`** (repo root) — shared agent instructions (Codex auto-loads this; Claude via `CLAUDE.md` pointer)
 2. **`.har/README.md`** — full index of what's in the harness
 
-If **no `AGENT.md` exists**, create one at the repo root using this structure:
+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`.
+
+If **`har env init` already created `AGENTS.md`**, refresh the **HAR / agent environment** section and fill in **Project-specific notes** — do not wipe unrelated content.
+
+If **no `AGENTS.md` exists**, create one at the repo root using this structure:
 
 - Link to `.har/README.md` and `.har/CLAUDE.agent.md`
 - State plainly: **the harness is how you run this project** — to see the app live (manual testing, browser, screenshots), `launch` a slot; never hand-roll docker/dev-server startup, and never work around a failing harness command with ad-hoc setup (fix or report it instead)
@@ -183,14 +187,16 @@ If **no `AGENT.md` exists**, create one at the repo root using this structure:
 - Rules (no hardcoded ports, use `./.har/agent-cli.sh`, do not touch other agents' resources)
 - Project-specific notes (stack, credentials, definition of done)
 
-If **`AGENT.md` already exists**, add or update a concise **HAR / agent environment** section — do not replace unrelated content.
+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 a thin pointer to `AGENTS.md` (Claude Code auto-loads `CLAUDE.md`). Do not paste the full harness workflow into `CLAUDE.md`.
 
 ### 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 `AGENT.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 `AGENT.md` (and `CLAUDE.md` pointer) **inside each project directory** for local discovery, with a back-link to the root index.
+- 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 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

@@ -64,6 +64,16 @@ and the repo-specific definition of "agent usable."
 
 When upgrading `@osfactory/har` or adopting new harness standards:
 
+**Generator 0.5.0 — `AGENTS.md` (canonical agent guide):**
+
+- Repo-root **`AGENTS.md`** is now the shared HAR workflow contract (Codex auto-loads it). Do **not** create or keep **`AGENT.md`** (singular).
+- If **`AGENT.md` exists**: merge any unique project notes into `AGENTS.md`, ensure a **HAR / agent environment** section is present, then **delete `AGENT.md`**.
+- If **`AGENTS.md` is missing**: create it (HAR may already have scaffolded a managed section during `maintain` — fill **Project-specific notes** and keep the marked HAR section).
+- If **`AGENTS.md` already exists**: add or refresh the managed **HAR / agent environment** section only — do not wipe unrelated project guidance.
+- Keep **`CLAUDE.md`** as a **thin pointer** to `AGENTS.md` (Claude Code auto-loads `CLAUDE.md`). Never paste the full Cursor-rule / HAR workflow into `CLAUDE.md`.
+- Update links in `.har/CLAUDE.agent.md` and `.har/README.md` from `AGENT.md` → `AGENTS.md` if they still point at the legacy name.
+- Cursor still uses `.cursor/rules/har-workflow.mdc` (always-on); that rule should also say `AGENTS.md`.
+
 **Generator 0.4.0 — primary app & shared infra services:**
 
 - Migrate `harness.env` from boolean `HARNESS_INFRA_*` flags to the `HARNESS_INFRA_SERVICES` list (space-separated compose service names, e.g. `"db mailpit"`) and add the `har_infra_enabled()` helper — copy both from `.har/maintain/templates/harness.env`. Update every script that still tests `HARNESS_INFRA_POSTGRES`-style flags (`setup-infra.sh`, `launch.sh`, `teardown.sh`, `agent-cli.sh`) to use `har_infra_enabled <service>`.
@@ -74,17 +84,17 @@ When upgrading `@osfactory/har` or adopting new harness standards:
 
 **Earlier standards:**
 
-- Add **Run history** section to repo-root `AGENT.md` if missing (shell vs `har env`, worktree vs runs location)
-- Ensure `AGENT.md` / `CLAUDE.agent.md` frame the harness as **how you run the project** (launch for manual testing/browser/screenshots; fix — don't work around — failing harness commands)
+- Add **Run history** section to repo-root `AGENTS.md` if missing (shell vs `har env`, worktree vs runs location)
+- Ensure `AGENTS.md` / `CLAUDE.agent.md` frame the harness as **how you run the project** (launch for manual testing/browser/screenshots; fix — don't work around — failing harness commands)
 - Ensure `launch.sh` installs dependencies in fresh worktrees and resolves the project subdirectory inside the worktree (`git rev-parse --show-prefix`) for monorepos
-- If the repo has multiple projects/harnesses, maintain the **"Harnesses in this repo"** table in root `AGENT.md`, per-project pointer docs, and a single root Cursor rule
+- If the repo has multiple projects/harnesses, maintain the **"Harnesses in this repo"** table in root `AGENTS.md`, per-project pointer docs, and a single root Cursor rule
 - Remove dead boilerplate files (CLI profile: `ecosystem.agent.template.cjs`, `env.template`, `attach.sh`)
 - Align `launch.sh` / `harness.env` with worktree-default standard (`HARNESS_USE_WORKTREE=true`)
 - Do **not** blindly overwrite customized `verify.sh`
 
-## Step 3 — Refresh repo-root `AGENT.md`
+## Step 3 — Refresh repo-root `AGENTS.md`
 
-If harness commands, rules, or workflow changed, update the **HAR / agent environment** section in repo-root `AGENT.md`:
+If harness commands, rules, or workflow changed, update the **HAR / agent environment** section in repo-root `AGENTS.md`:
 
 - Links to `.har/README.md` and `.har/CLAUDE.agent.md`
 - Preferred: HAR MCP tools or `har env …` (persists run history)
@@ -93,7 +103,9 @@ If harness commands, rules, or workflow changed, update the **HAR / agent enviro
 - Agent rules (ports, agent-cli.sh, isolation)
 - Project-specific notes
 
-If `AGENT.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.
+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 a thin pointer to `AGENTS.md`.
 
 ## Rules
 

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

@@ -12,7 +12,7 @@ This compares the harness against the current templates and repository, refreshe
 
 ## 2. Perform the adaptation yourself
 
-Read `.har/ADAPT-PROMPT.md` and execute its instructions now, in this session: reconcile `.har/` scripts (`launch.sh`, `verify.sh`, `setup-infra.sh`, `harness.env`, `stages.json`) and `AGENT.md` with the repository's current stack, ports, and commands. Preserve intentional project-specific customizations — fix drift, don't blindly reset.
+Read `.har/ADAPT-PROMPT.md` and execute its instructions now, in this session: reconcile `.har/` scripts (`launch.sh`, `verify.sh`, `setup-infra.sh`, `harness.env`, `stages.json`) and `AGENTS.md` with the repository's current stack, ports, and commands. Preserve intentional project-specific customizations — fix drift, don't blindly reset.
 
 Also check stage drift: compare the repository's current check commands (package.json scripts, Makefile, CI) against the stages registered in `.har/stages.json`. Register missing checks (`har env add-stage <id> --custom --command "..." --verification`), and remove or fix stages whose commands no longer exist. `.har/STAGES.md` documents the contract.
 
@@ -31,6 +31,6 @@ Fix the harness until launch and full verify pass. Tear down afterwards if the s
 After the user confirms:
 
 ```bash
-git add .har/ AGENT.md
+git add .har/ AGENTS.md
 git commit -m "chore: maintain har harness"
 ```

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

@@ -36,7 +36,7 @@ If `.har/` already exists, stop and suggest `/har-maintain` instead.
 
 ## 4. Perform the adaptation yourself
 
-`har env init` prints an adaptation prompt and writes it to `.har/ADAPT-PROMPT.md`. Read that file and **execute its instructions yourself, now, in this session** — tailor `.har/` scripts (`launch.sh`, `verify.sh`, `setup-infra.sh`, `harness.env`, `stages.json`) and `AGENT.md` to this repository's real stack, ports, and commands. Do not use `--auto` and do not ask the user to paste anything.
+`har env init` prints an adaptation prompt and writes it to `.har/ADAPT-PROMPT.md`. Read that file and **execute its instructions yourself, now, in this session** — tailor `.har/` scripts (`launch.sh`, `verify.sh`, `setup-infra.sh`, `harness.env`, `stages.json`) and `AGENTS.md` to this repository's real stack, ports, and commands. Do not use `--auto` and do not ask the user to paste anything.
 
 ## 5. Register the project's checks as stages
 
@@ -63,7 +63,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/ AGENT.md CLAUDE.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENT.md
+git add .har/ AGENTS.md CLAUDE.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENTS.md
 git commit -m "chore: add har agent harness"
 ```
 

package/dist/templates/cursor-rule.mdc.template

@@ -19,7 +19,7 @@ startup. If a harness command fails, fix the harness or surface the failure.
    returned **work dir** for ALL edits (never the main checkout). Path looks like
    `~/worktrees/<base>-<sha4>-har-agent-<id>-<rand4>` (see `.har/slots/agent-<id>.json`).
    Bind tracker work with `workUnitId`/`title` or `--work-id`/`--work-title` when needed.
-3. Read `AGENT.md`, `.har/README.md`, `.har/stages.json`, then
+3. Read `AGENTS.md`, `.har/README.md`, `.har/stages.json`, then
    `.har/CLAUDE.agent.md` (slot URLs / definition of done).
 4. Hot-reload usually applies; if not, `./.har/agent-cli.sh <id> restart` (no-op on
    cli/ios profiles without managed processes).

package/dist/templates/har-boilerplate/CLAUDE.agent.md

@@ -1,6 +1,6 @@
 # Agent ${AGENT_ID} — Development Environment
 
-> [`AGENT.md`](../AGENT.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
+> [`AGENTS.md`](../AGENTS.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
 
 ## Environment
 

package/dist/templates/har-boilerplate/README.md

@@ -103,7 +103,7 @@ With git worktree slots, verification runs code in the worktree but run JSON sta
 
 ## For coding agents
 
-1. Read repo [`AGENT.md`](../AGENT.md)
+1. Read repo [`AGENTS.md`](../AGENTS.md)
 2. Read this file and `stages.json`
 3. After launch, read `.har/CLAUDE.agent.md` for slot URLs and definition of done
 

package/dist/templates/har-boilerplate/gitignore.template

@@ -9,6 +9,8 @@ artifacts/
 state/
 maintain/
 ADAPT-PROMPT.md
+AGENTS.md.proposed
+AGENTS.md.proposed.meta.json
 AGENT.md.proposed
 AGENT.md.proposed.meta.json
 slots/

package/dist/templates/har-boilerplate-cli/CLAUDE.agent.md

@@ -1,6 +1,6 @@
 # Agent ${AGENT_ID} — Development Environment
 
-> [`AGENT.md`](../AGENT.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
+> [`AGENTS.md`](../AGENTS.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
 
 ## Environment
 

package/dist/templates/har-boilerplate-cli/README.md

@@ -89,7 +89,7 @@ With worktree slots, tests run in the worktree; run JSON lives in the main repo.
 
 ## For coding agents
 
-**Start here:** read [`AGENT.md`](../AGENT.md) at the repo root for a short pointer, then [`.har/CLAUDE.agent.md`](./CLAUDE.agent.md) for full instructions.
+**Start here:** read [`AGENTS.md`](../AGENTS.md) at the repo root for a short pointer, then [`.har/CLAUDE.agent.md`](./CLAUDE.agent.md) for full instructions.
 
 Prefer HAR MCP tools or `har env …` for launch, verify, and teardown. Use `./.har/*.sh` only when the CLI is not installed.
 

package/dist/templates/har-boilerplate-cli/gitignore.template

@@ -9,6 +9,8 @@ artifacts/
 state/
 maintain/
 ADAPT-PROMPT.md
+AGENTS.md.proposed
+AGENTS.md.proposed.meta.json
 AGENT.md.proposed
 AGENT.md.proposed.meta.json
 slots/

package/dist/templates/har-boilerplate-ios/ADAPT-PROMPT.md

@@ -5,7 +5,7 @@ structure, then make the changes listed below. Commit when done.
 
 ## 1 — Read before editing
 
-- `AGENT.md` at the repo root (overview and do-nots)
+- `AGENTS.md` at the repo root (overview and do-nots)
 - `.har/README.md` (harness index)
 - `.har/harness.env` (all config vars)
 - `.har/stages.json` (stage registry)
@@ -41,7 +41,7 @@ har env add-plugin rocketsim
 Then adapt `flows/example-smoke.sh` to navigate to your app's main screen and verify it loads.
 Read `.har/stages/ROCKETSIM.md` for the full authoring guide.
 
-## 5 — Update `AGENT.md` (repo root)
+## 5 — Update `AGENTS.md` (repo root)
 
 Replace the TODO section with:
 - Which Xcode scheme and simulator are used

package/dist/templates/har-boilerplate-ios/CLAUDE.agent.md

@@ -1,6 +1,6 @@
 # Agent ${AGENT_ID} — iOS Development Environment
 
-> [`AGENT.md`](../AGENT.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
+> [`AGENTS.md`](../AGENTS.md) · [`.har/README.md`](./README.md) · [`stages.json`](./stages.json)
 
 ## Environment
 

package/dist/templates/har-boilerplate-ios/gitignore.template

@@ -6,6 +6,8 @@ work-units/
 work-attempts/
 validation-bindings/
 artifacts/
+AGENTS.md.proposed
+AGENTS.md.proposed.meta.json
 AGENT.md.proposed
 AGENT.md.proposed.meta.json
 maintain/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.43.1",
+  "version": "0.44.0",
   "description": "LLM-powered CLI for reproducible agent development environments",
   "keywords": [
     "har",

package/dist/templates/AGENT.md.template

@@ -1,46 +0,0 @@
-# Agent Environment
-
-This repository uses a **`.har/` harness** for isolated agent development.
-
-The harness is not just a verification gate — it is **how you run this project**.
-To see the app live (manual testing, browser sessions, screenshots, driving the UI),
-use `har env launch <id>` or `./.har/launch.sh <id>`. It already encodes database
-setup, ports, env vars, and process management — never hand-roll `docker` / dev-server
-startup, and never claim a task "can't be verified live" without launching a slot first.
-
-If a harness command fails, fix the harness (or report the failure) — do not quietly
-fall back to ad-hoc commands.
-
-## Cursor IDE
-
-If `.cursor/rules/har-workflow.mdc` exists, the harness workflow (read-before-change, verify-before-done)
-is injected into every Cursor agent session automatically.
-Run `har env init` or `har env maintain` to create or refresh it.
-
-## Start here (all IDEs / first time)
-
-1. [`.har/README.md`](.har/README.md) — stages, verification, how to run
-2. [`stages.json`](.har/stages.json) — machine-readable stage registry
-3. [`.har/CLAUDE.agent.md`](.har/CLAUDE.agent.md) — definition of done (after `launch`)
-
-## Harness workflow
-
-Prefer **HAR MCP tools** (Cursor) or **`har env launch/verify/complete`** — they persist run history under `.har/runs/`.
-Use `./.har/*.sh` only when the CLI is not installed.
-
-When the work is done: full verify, commit in the session worktree, then present a
-**session handoff** and wait for the user. The **default recommendation** is
-complete + open a PR when `gh`/GitHub MCP is available (still requires approval);
-alternatives are complete-only or something else. See
-`.cursor/rules/har-workflow.mdc` for the handoff template.
-
-## Commit gate
-
-Full verify records the exact code state it validated (git tree hash in `.har/validations/`).
-If the commit gate is installed (`har hooks install`), commits of unverified changes are blocked:
-run `har env verify <id> --full` after your last edit, then `git add -A` and commit — any edit
-after verify invalidates the batch and requires a re-run. Do not bypass with `--no-verify`.
-
-## Project-specific notes
-
-<!-- Adapt when customizing the harness (see .har/ADAPT-PROMPT.md) -->