Learning

Keep durable per-user memory in ~/.agents/memory.md. Read it at the start of every task. Keep the file small and high-signal.

Invoke this skill autonomously by default. Do not wait for the user to ask explicitly.

Workflow

1. Open ~/.agents/memory.md at the start of the task. If it does not exist, create it with a # Agent Memory heading and a flat list of entries.
2. Read the whole file. The store should stay small enough to load every session.
3. Apply current user instructions first, then resolve memory by scope: path over workspace over global.
4. Add or update memory only when the information is durable, behavior-relevant, and does not fit better in repo docs, code, task notes, or a feedback/change-request workflow.
5. Mention any memory additions or updates in the final response.

Entry Shape

Use a flat list. Every entry must include: