Skip to content

Onboard HQ context management#1

Open
hq-anarock[bot] wants to merge 4 commits into
devfrom
hq/onboard-context-management
Open

Onboard HQ context management#1
hq-anarock[bot] wants to merge 4 commits into
devfrom
hq/onboard-context-management

Conversation

@hq-anarock

@hq-anarock hq-anarock Bot commented Jul 15, 2026

Copy link
Copy Markdown

What this PR changes

  • AGENTS.md: No authored context present — created AGENTS.md from template.
  • CLAUDE.md + .cursor/rules/agents.md: pointer stubs that redirect to AGENTS.md, so Claude Code, Codex, and Cursor all read one canonical source.
  • .gitignore: updated to ignore .hq/ and *.local.md overrides
  • .hq/ tracked files: 0 removed (indices now live in HQ's S3 cache)

Why

AGENTS.md is the cross-tool convention read by Codex and Claude Code. HQ keeps the authored context there and serves all generated context (symbol index, graph, skeletons, feature/stage state) from a tenant-scoped S3 cache + DB at agent run-time. Tracking generated files in git produced unmergeable conflicts on every PR. Nothing generated lives in git after this PR merges.

After merge

  • Open PRs against this repo will need a one-time rebase, accepting the incoming version of these files.
  • HQ will re-index the default branch automatically on the next push.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants