zed-agents/.agents/skills/agent-memory/SKILL.md

name, description

name	description
agent-memory	Maintain concise, repository-based handoff notes for work that spans multiple Zed agent conversations. Use when a project has a persistent memory file or runbooks.

Agent memory

Start a new conversation

Zed agent threads do not share conversation history. When the project provides persistent handoff files, read them before working:

1. the applicable project instructions (AGENTS.md or equivalent);
2. this skill;
3. the project's memory or handoff file (commonly .agents/MEMORY.md);
4. all skills relevant to the task; and
5. any relevant domain RUNBOOK.md files.

Treat handoff notes as context, not as unquestionable fact. Verify the current state from the code, tests, and Git history.

Maintain durable handoffs

After significant work, update the project's handoff file when it exists and is intended for agent memory. Record only information useful to the next thread:

• Current focus — a one-line summary.
• Completed — concrete outcomes, affected paths, and commits where relevant.
• Open issues / blockers — unresolved work and dependencies.
• Decisions & conventions — choices future work must preserve.
• Files that matter now — the next files to read first.

Update a domain runbook only for reusable operational knowledge, such as non-obvious mappings, reliable validation steps, or commands/workarounds that future work should repeat.

Do not create, modify, or commit memory files unless the project workflow allows it and the user’s request permits the change.