From 7b69e36661a7946bf0aa5a2f177faa4ec94edb15 Mon Sep 17 00:00:00 2001
From: "hq-anarock[bot]" <288549211+hq-anarock[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 09:03:12 +0000
Subject: [PATCH 1/4] chore: write authored AGENTS.md (canonical agent context)

---
 AGENTS.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000000..05a7763673f8
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,26 @@
+# Project
+
+<!-- Authored by humans. Generated content (commit SHAs, feature state) is
+served from HQ's S3 cache + DB at agent run-time, never written here. -->
+
+## Commands
+- Build:
+- Test:
+- Dev:
+
+## Structure
+- Top-level dirs and what lives in each.
+
+## Conventions
+- Project-specific rules an agent wouldn't guess.
+
+## Gotchas
+- Project-specific traps.
+
+## Workflow
+- Never commit without explicit user request.
+- Never write tests unless explicitly asked.
+
+## Reference
+- Branch/feature runtime context: read live from HQ's DB by the server-side agent.
+- Repo indices (symbols, graph, skeletons): pulled from S3 by the HQ backend at agent run-time.

From 91510b3943e43720d270e1dda6e3cd6badeb753a Mon Sep 17 00:00:00 2001
From: "hq-anarock[bot]" <288549211+hq-anarock[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 09:03:13 +0000
Subject: [PATCH 2/4] chore: point CLAUDE.md at canonical AGENTS.md

---
 CLAUDE.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000000..99e1a578276a
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,7 @@
+<!-- HQ pointer stub — do not edit. Canonical context lives in AGENTS.md. -->
+
+# Project
+
+This repository's agent context is maintained in [AGENTS.md](./AGENTS.md).
+
+Claude Code reads `AGENTS.md` natively — see that file for commands, structure, conventions, and workflow.

From f2f324ea006cabe5507e0e325a8ce3db5d702d5f Mon Sep 17 00:00:00 2001
From: "hq-anarock[bot]" <288549211+hq-anarock[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 09:03:15 +0000
Subject: [PATCH 3/4] chore: add Cursor rule pointing at AGENTS.md

---
 .cursor/rules/agents.md | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 .cursor/rules/agents.md

diff --git a/.cursor/rules/agents.md b/.cursor/rules/agents.md
new file mode 100644
index 000000000000..caf010359708
--- /dev/null
+++ b/.cursor/rules/agents.md
@@ -0,0 +1,6 @@
+---
+description: Project agent context (canonical source)
+alwaysApply: true
+---
+
+The canonical agent context for this repository lives in `AGENTS.md` at the repo root. Read it for commands, structure, conventions, and workflow before making changes.

From 14c5e7ad630ba93ce85f5caa72b6e2774f310d9d Mon Sep 17 00:00:00 2001
From: "hq-anarock[bot]" <288549211+hq-anarock[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 09:03:17 +0000
Subject: [PATCH 4/4] chore: gitignore HQ context cache

---
 .gitignore | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 03eed15562da..3a5ff600ce22 100644
--- a/.gitignore
+++ b/.gitignore
@@ -265,4 +265,8 @@ chroma*/*
 stuff/*
 src/frontend/playwright-report/index.html
 *.bak
-prof/*
\ No newline at end of file
+prof/*
+# HQ context — generated indices and per-developer overrides
+.hq/
+AGENTS.local.md
+CLAUDE.local.md