hivelore AGENTS.md

A set of repository instructions for Hivelore, a system that stores shared project context, memories, and decisions for AI agents. It defines required context checks, safety rules, and finishing steps for work in the hivelore repository.

In plain words
What is it for?
Use it when working in that repository to load relevant context before edits, record failed approaches, capture session learnings, and run the required final checks.
Why use it?
It prevents agents from missing team knowledge or acting on changes that require developer confirmation.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/doucs91/hivelore/agents-md
Clone the repo
git clone --depth 1 https://github.com/Doucs91/hivelore

Made for: Codex, OpenCode.

Per session 1,309 This file is loaded in full into every session.
When invoked 1,309 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01309 $0.01309
Opus 5 $0.00655 $0.00655
Sonnet 5 $0.00262 $0.00262
Haiku 4.5 $0.00131 $0.00131

Measured yesterday against content hash 3605e0c3748b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

hivelore AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

- **2026-06-07-convention-vscode-cli-calls-through-runhaive** _(applies to: packages/vscode/src/extension.ts, packages/vscode/src/briefingPanel.ts, packages/vscode/src/observabilityProvider.ts)_: Raw child_process in the
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 64 lines

How it starts

The opening of the file, as written. The whole thing — 64 lines — stays where its author put it; the contents beside it link to each section on GitHub.

This repo uses Hivelore for shared context. The map:

  • .ai/project-context.md — project overview, architecture, conventions.
  • .ai/memories/ — decisions, gotchas, conventions, failed attempts (personal/team/module).
  • The breadcrumbs injected below (if any) are the top current memories.

Working through Hivelore

  1. Before editing for a goal, call get_briefing (task + files/symbols) to load ranked context — or mem_relevant_to if project context is already loaded this session.
  2. When an approach fails, call mem_tried right away so the next agent skips the dead end.
  3. Before closing a substantive session, run the post_task prompt to capture what was learned.
  4. Before final response, run hivelore enforce finish. If it blocks, commit/push, bump/tag shippable releases, wait for GitHub Actions to pass when applicable, then rerun it.

If the haive MCP server is not available, tell the developer rather than silently skipping it.

Safety

  • If get_briefing returns action_required, surface each item to the developer (use its developer_message) and wait for confirmation before changing code.
  • Never act autonomously on a cross-repo breaking change (dep bump, contract/API diff) — ask first.
  • 2026-04-25-architecture-embedderlike-interface (team/architecture) — Architecture Embedderlike Interface (applies to: packages/embeddings/src/embedder.ts)
  • 2026-04-25-architecture-pure-tool-handlers (team/architecture) — Architecture Pure Tool Handlers (applies to: packages/mcp/src/tools)
  • 2026-04-25-convention-always-run-tests-before-commit (team/convention) — Hivelore Release Verification Chain (applies to: .github/workflows/ci.yml, package.json, scripts/verify-build-artifacts.mjs)
  • 2026-04-25-convention-use-pnpm-workspaces (team/convention) — Hivelore Uses Pinned pnpm Workspaces (applies to: package.json, pnpm-workspace.yaml)
  • 2026-04-25-decision-esm-only (team/decision) — Decision Esm Only (applies to: tsconfig.base.json)
  • 2026-04-25-gotcha-tsup-externals-required (team/gotcha) — Gotcha Tsup Externals Required (applies to: packages/cli/tsup.config.ts, packages/mcp/tsup.config.ts)
  • 2026-04-27-decision-zod-error-formatting-no-direct-import (team/decision) — Decision Zod Error Formatting No Direct Import (applies to: packages/cli/src/index.ts)
  • 2026-04-27-gotcha-embeddings-load-error-double-print (team/gotcha) — Gotcha Embeddings Load Error Double Print (applies to: packages/cli/src/commands/embeddings.ts)

Read the full file on GitHub · 64 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 64 lines · 1,309 tokens per session scan A 3605e0c3748b

Subscribe to this mod's changes

hivelore AGENTS.md is an instructions file published in the GitHub repository Doucs91/hivelore (1 stars, last pushed 4d ago), licensed Apache-2.0. It adds 1,309 tokens to every session, about $0.0065 per session on Opus 5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

gortex CLAUDE.md

Claude Code instructions for zzet/gortex, covering gortex, build & test, codebase overview, discovery (read once, then keep using) and llm provider (powers ask and searchsymbols assist: modes).

zzet/gortex · 5,172 tokens

mcp-unity AGENTS.md

Instructions for CoderGamester/mcp-unity, covering mcp unity — ai agent guide (mcp package), purpose (what this repo is), how it works (high-level data flow), key defaults & invariants and repo layout (where to change what).

CoderGamester/mcp-unity · 2,498 tokens

mcp-server-azure-devops AGENTS.md

Instructions for Tiberriver256/mcp-server-azure-devops: /home/tiberriver256/repos/mcp-server-azure-devops/docs/important-knowledge/azure-devops-rest-api-research.md Researching Azure DevOps REST APIs, selecting api-version, or handling Azure DevOps Server (on-prem) endpoints.

Tiberriver256/mcp-server-azure-devops · 178 tokens

rosetta AGENTS.md

Instructions for griddynamics/rosetta: Main goal: cover E2E AI PDLC engineering workflows at foundation level for AI-First SDLC in enterprise. Top-level or orchestrator agents MUST READ docs/ARCHITECTURE.md contains technical details and guidance, and docs/CONTEXT.md - business context. Subagents - when needed.…

griddynamics/rosetta · 270 tokens

rails-ai-context AGENTS.md

Instructions for crisnahine/rails-ai-context, covering rails-ai-context, agent skills, issue tracker, triage labels and domain docs.

crisnahine/rails-ai-context · 134 tokens

inspecto CLAUDE.md

Instructions for inspecto-dev/inspecto, covering inspecto — claude code development guide, project overview, monorepo structure, development phases (load each file as needed) and key architectural decisions.

inspecto-dev/inspecto · 1,014 tokens