From b4a9bcffaca6f341112ca037e3de31fbb90ca66e Mon Sep 17 00:00:00 2001
From: JoshuaVSherman <joshua.v.sherman@gmail.com>
Date: Fri, 3 Jul 2026 15:32:27 -0400
Subject: [PATCH] docs(agents): add AGENTS.md with branch & memory hygiene
 rules

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 AGENTS.md    | 36 ++++++++++++++++++++++++++++++++++++
 package.json |  2 +-
 2 files changed, 37 insertions(+), 1 deletion(-)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..3aa9ff9
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,36 @@
+# AGENTS.md — AppersonAuto
+
+Guidance for AI coding agents (agy/Antigravity, etc.) working in this repo.
+
+## What this is
+A React + TypeScript + Vite front-end for Apperson Auto.
+
+## Commands (get green before declaring done)
+- `npm test` — the gate: stylelint + eslint + typecheck + unit tests.
+- `npm run test:lint` / `npm run typecheck` for quicker partial checks.
+
+## Workflow
+- Always work on a feature branch off the latest `dev`. Never merge to `dev` or
+  `main` — Josh is the mandatory human reviewer.
+- Open PRs with the shared script
+  (`~/WebJamApps/web-jam-tools/scripts/create-draft-pr.sh`), never
+  `gh pr create` directly. It opens a **draft** PR based on **`dev`**.
+- Bump the semver `version` in `package.json` **once per PR** on the feature
+  branch (not once per push).
+- Do not add, upgrade, or remove dependencies — ask first.
+
+## Branch & memory hygiene
+- One branch per task: never create or push any branch other than the one
+  created for the current task.
+- Once your PR is merged or closed, its branch is DEAD — never commit to it or
+  push it again. Follow-up work (including afterthoughts like docs or lessons
+  learned) starts on a NEW branch off the latest `dev`, with its own PR.
+- Save lessons BEFORE the merge, not after: anything you learned during the task
+  worth keeping (build quirks, selector gotchas, testing patterns — e.g. the
+  output of a `/learn`-style memory pass) gets committed to this file's Memory
+  section on the SAME task branch while the PR is still open, so it ships inside
+  the PR. A post-merge push to the old branch strands the lesson and forces
+  manual cleanup.
+
+## Memory
+(Add lessons learned here, one bullet each.)
diff --git a/package.json b/package.json
index 4aa52c8..a34268c 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "appersonautomotive.com",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "description": "appersonautomotive.com",
   "main": "dist/index.html",
   "repository": {