Skip to content

πŸ“– docs: how Hive injects knowledge and memory into agents - #17042

Merged
clubanderson merged 1 commit into
v5from
docs-knowledge-injection
Nov 7, 2026
Merged

clubanderson merged 1 commit into
v5from
docs-knowledge-injection

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Why

At the 2026-11-05 community meeting @kellyaa asked "how does Hive's memory/knowledge injection work today?" and nobody could answer. @gregoryhunt and @Danathar raised the related CLI auto-memory concerns. This is a docs gap; this page closes it.

What

New src/docs/agent-knowledge-and-memory.md (~215 lines), verified against v5 code:

Linked from documentation-map.md, operator-reference/README.md (data.claude_sessions_dir row), agents-md.md and knowledge-curator.md.

Citations are by backticked Go declaration anchor, no file:line. Docs-only, no changelog fragment needed.

Answers the 2026-11-05 community-meeting question nobody could answer:
which context reaches an agent and from where. Separates the three layers
(Hive knowledge primer, CLI conversation, CLI persistent memory), traces
the kick-primer path (Primer.PrimeScoped -> primeKnowledge -> # Relevant
Knowledge) with its scoping rules and size caps, explains why repo
AGENTS.md is injected by the scheduler rather than read natively, lists
which per-agent home directories are fleet-shared, and tabulates what
survives a kick, /clear, pod restart or a new agent. In-flight memory
isolation work (#17031, #17032, #17033, PR #17039) is linked as known
gaps rather than described as current behaviour.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Nov 7, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign clubanderson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Nov 7, 2026
@github-actions

github-actions Bot commented Nov 7, 2026

Copy link
Copy Markdown
Contributor

Open PR overlap check

Base branch: v5

Conflicts are checked with every PR merged onto the current tip of v5, so a PR that only needs a rebase is not reported as conflicting with its siblings.

PR Title Relation Files
#17040 ✨ agents: disable CLI auto-memory by default and add cli_memory.clear_on_kick same files src/docs/operator-reference/README.md
#17039 πŸ› agents: give each agent its own CLI memory β€” stop bridging .claude/.gemini/.bob state to the shared home CONFLICT src/docs/operator-reference/README.md

@github-actions github-actions Bot added the conflicts-with-open-pr Open PR has a merge conflict with another open PR label Nov 7, 2026
@clubanderson
clubanderson merged commit 912b2eb into v5 Nov 7, 2026
83 of 86 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the docs-knowledge-injection branch November 7, 2026 18:44
@github-actions

github-actions Bot commented Nov 7, 2026

Copy link
Copy Markdown
Contributor

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback

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

Labels

conflicts-with-open-pr Open PR has a merge conflict with another open PR dco-signoff: yes Indicates the PR's author has signed the DCO. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant