Timmy_Foundation/hermes-agent
15
0
Fork 0
Code Issues 64 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity

[Memory P5] Documentation — Memory Architecture Guide #258

New Issue
Open
opened 2026-04-09 00:42:46 +00:00 by Rockachopa · 0 comments
Rockachopa commented 2026-04-09 00:42:46 +00:00
Owner
Copy Link

Context

The memory system spans multiple files, plugins, cron jobs, and data stores. A new developer (or future Timmy session) needs to understand the full picture.

Task

  1. Document the four tiers: purpose, store, injection method, lifecycle
  2. Document data flows: what writes where, what reads where
  3. Document how to add facts, how prefetch works, how operational data flows
  4. Document hygiene procedures (contradiction detection, pruning, trust calibration)
  5. Add architectural diagram
  6. Add to AGENTS.md or as standalone ~/.hermes/docs/memory-architecture.md

Acceptance Criteria

  • New developer can understand memory architecture from docs alone
  • All four tiers documented with examples
  • Data flow diagram included
  • Hygiene procedures documented
  • Linked from AGENTS.md

Part of: [EPIC] Unified Memory Architecture

## Context The memory system spans multiple files, plugins, cron jobs, and data stores. A new developer (or future Timmy session) needs to understand the full picture. ## Task 1. Document the four tiers: purpose, store, injection method, lifecycle 2. Document data flows: what writes where, what reads where 3. Document how to add facts, how prefetch works, how operational data flows 4. Document hygiene procedures (contradiction detection, pruning, trust calibration) 5. Add architectural diagram 6. Add to AGENTS.md or as standalone ~/.hermes/docs/memory-architecture.md ## Acceptance Criteria - New developer can understand memory architecture from docs alone - All four tiers documented with examples - Data flow diagram included - Hygiene procedures documented - Linked from AGENTS.md Part of: [EPIC] Unified Memory Architecture
Rockachopa added this to the Unified Memory Architecture milestone 2026-04-09 00:42:46 +00:00
Rockachopa added the phase:5-integrationepic:memory labels 2026-04-09 00:42:46 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
CI
Continuous integration, runners, workflow issues
 QA
Quality assurance, testing, production audit
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Task assigned to KimiClaw for processing
 blocked
Blocked by external dependency or merge conflict
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 duplicate
Duplicate of another issue
 epic
Epic - large feature with multiple sub-tasks
 epic:memory
Unified Memory Architecture epic
 gaming
Gaming agent capabilities
 infra
Infrastructure, VPS, DNS, deployment
 kimi-done
KimiClaw has completed this task
 kimi-in-progress
KimiClaw is actively working on this
 mcp
MCP (Model Context Protocol) tools & servers
 morrowind
Morrowind Agent gameplay & MCP integration
 needs-review
PR or issue requires reviewer sign-off before merge/close
 p0-critical
p1-important
phase:1-activate
Phase 1: Activate existing systems
 phase:2-operational
Phase 2: Operational memory bridge
 phase:3-episodic
Phase 3: Proactive episodic recall
 phase:4-hygiene
Phase 4: Memory hygiene and quality
 phase:5-integration
Phase 5: Integration and testing
 security
Security hardening, vulnerability fixes
 stale
No activity, pending triage or closure
 velocity-engine
Auto-generated by velocity engine
 wont-fix
Closed as intentionally not fixing — explicit descope
No Label epic:memory phase:5-integration
Milestone
No items
No Milestone Unified Memory Architecture
Projects
Clear projects
No project
Assignees
Clear assignees
Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/hermes-agent#258
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?