# hyperhive reference docs

The hyperhive reference docs are mounted read-only in this directory
(the harness exposes the path as `$HIVE_DOCS_DIR`). They are the
canonical reference for how this swarm actually works - the turn loop,
the tool surface, persistence, conventions, runbooks, and the
approval/CI/forge/matrix workflows.

- On a fresh deploy, or any time you are unsure how a hyperhive
  mechanism behaves, read `setup.md` first, then the topic file for the
  area you are touching (e.g. `turn-loop.md`, `persistence.md`,
  `tools/`, `conventions.md`, `gotchas.md`).
- Prefer these docs over guessing: they describe the live system, not a
  generic one.

This pointer is additive. It does not replace your own memory or project
instructions - your `~/.claude/CLAUDE.md` and any harness/project memory
still apply in full. Nothing here overrides what you already know about
yourself; it only tells you where the shared reference material lives.