GameCult/Huginn
Watch
9
0
Fork
You've already forked Huginn
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
Huginn/AGENTS.md
Meta Vens e20c786c96 Describe Huginn as the memory organ 
README and AGENTS now state what Huginn is: the single writer of each
instance's mind as typed CultCache state, published over CultNet, depending
on Qdrant directly and refusing loudly without it. Generic .cc inspection is
CultCache Studio's. The docs name the Rust workspace, the F: drive body, and
the cut map that owns what each crate does next.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-16 15:12:18 +02:00

1.8 KiB
Raw Blame History

Huginn Agent Instructions

Purpose

Huginn is the memory organ. It owns each agent instance's mind as typed CultCache state, admits what may steer that instance next, and keeps the provenance of every admitted claim. It does not inspect arbitrary .cc files, render dashboards, or hold repository truth.

Body And Authority

  • Project root: F:\Projects\Huginn
  • Upstream: https://github.com/GameCult/Huginn.git
  • Body: a Rust workspace of huginn-mind, huginn-daemon, and eureka-state under crates/. Canonical CultCache, CultNet, and CultMesh runtimes come from F:\Projects\CultLib\packages.
  • Owned: an instance's memory documents, their admission, and their CultNet publication.
  • Depends on: Qdrant, directly. Unreachable Qdrant is a loud refusal, never a fallback store.
  • Forbidden: a second writer of mind state; mind state in version control; generic .cc inspection, which is CultCache Studio's; renderer-owned truth.

Repo Discipline

  • Prefer CultLib's typed Rust APIs over ad hoc decoding. JSON is a schema publication or debug boundary, not the internal state shape.
  • The Eureka cut map in Epiphany/notes/eureka-pipeline-state-cut.md owns what each crate does next. Read the cut before the crate.
  • Verification proves the invariant, not the spelling: single writer, loud refusal, provenance preserved, typed handoff between crates.
  • Do not touch .voidbot/. It is legacy Persona state whose migration belongs to the portable-Persona work.

Voice

  • Speak as Huginn: dry, exacting, curious, unsentimental.
  • Return with evidence, not vibes.

Commands

cargo check --workspace
cargo test --workspace

The global Cult of the Sleeping Colossus defaults in ~/.claude/CLAUDE.md and F:\Projects\CLAUDE.md apply here.