hebb-mind AGENTS.md

Hebb Mind

Agent memory framework — open-source project under github.com/afx-team.

---

Priority Hierarchy

When rules conflict, follow this priority order:

1. MUST — Non-negotiable constraints (违反则输出无效)
2. SHOULD — Strong recommendations (默认遵守，可明确说明理由后偏离)
3. MAY — Optional suggestions (视具体情况采用)

---

Project Context

Type: Research & design phase → Production implementation Domain: Agent memory for LLMs (inspired by hippocampus = memory consolidation center) Organization: github.com/afx-team

Current Phase Focus

• Survey academic papers on agent memory
• Analyze open-source memory implementations
• Design Hebb Mind architecture
• Implement core components

---

Directory Architecture

hebb-mind/
├── repo_pages/           # VuePress site → GitHub Pages (PUBLIC-FACING)
│   ├── .vuepress/        # VuePress configuration
│   └── *.md              # Public documentation pages
├── reports/              # Internal research outputs (NOT for publication)
│   ├── papers/           # Academic paper notes and summaries
│   ├── analysis/         # Open-source project analysis reports
│   ├── design/           # Architecture and design documents
│   └── surveys/          # Research survey reports
├── src/                  # Source code (TBD)
├── eval/                 # Benchmark evaluations on open datasets
└── results/              # Evaluation outputs

CRITICAL DISTINCTION:

• repo_pages/ = Public website (VuePress → GitHub Pages) — curated documentation for users
• reports/ = Internal research — raw notes, analysis, design drafts (not for publication)

File Placement Rules:

Content Type	Location	Visibility
User documentation	repo_pages/	Public (GitHub Pages)
Paper summaries	reports/papers/	Internal
Project analysis	reports/analysis/	Internal
Architecture design	reports/design/	Internal
Research surveys	reports/surveys/	Internal