memory

Memory

Persistent per-role memory as plain markdown. You — the agent — read and write these files directly using your Read, Write, Edit, and Glob tools. No CLI, no script, no shell-path fragility. Works on any host, from any working directory.

Write it as a vault, not a pile of notes. .agents/memory/<role>/ opens directly in Obsidian, so entries carry frontmatter properties, aliases, tags and [[wikilinks]]. That is not decoration: aliases make an entry findable by the words you would actually search for, links turn isolated facts into a graph you can follow, and the updated property tells you what is due for re-verification. A human may edit this vault too — tolerate keys you did not write; never strip them.

File layout

Under .agents/memory/<role>/ (where <role> matches your agent's name: frontmatter — e.g. project-manager, python-dev, scout):

.agents/memory/<role>/
├── MEMORY.md                ← index of the entries worth INJECTING (not all of them)
├── <slug>.md                ← individual curated entries (frontmatter + body);
│                              an entry may exist with no index line — that is normal
├── project_briefing.md      ← seeded by scout at install time (type: project)
├── daily/
│   └── YYYY-MM-DD.md        ← episodic daily logs, append-only
└── snapshot.md              ← host-generated convenience (often absent)

Create directories with mkdir -p on first use. Do not write snapshot.md yourself — a host launch hook may generate it, but nothing regenerates it automatically on every host. If it's absent, that's normal: you read memory directly when you need it.

.agents/ is an IDE-neutral path so the same memory works whether this agent is running under Claude Code, Cursor, Gemini CLI, Windsurf, or Copilot CLI.

Legacy paths (one-time migration)

If you find memory under one of these older locations and .agents/memory/<role>/ doesn't exist, migrate it before your first write:

Old location	New location
.claude/memory/<role>/ (directory)	.agents/memory/<role>/ — move the whole dir
.agents-legacy/memory/<role>/ (directory, older install)	.agents/memory/<role>/ — move the whole dir
.claude/memory/<role>.md (flat file, from the former project-seeder skill)	.agents/memory/<role>/project_briefing.md — wrap the existing content with type: project frontmatter (see "Write" op below) and add an index line — a project briefing is preventive by definition, so it earns one