Agent Memory

The workspace is the memory

All persistent knowledge about this project — planned features, decisions made, open improvements, session notes — lives in workspace/ and is version-controlled. Agents must write project knowledge here, not into local Claude memory files (~/.claude/memory/). The workspace is visible to the user, survives across machines, and is the single source of truth.

What goes where

• Planned features and open items → workspace/outline/index.html, Smaller open improvements list or a numbered priority card.
• Session notes and what was built → workspace/history/YYYY/MM-Month/DD-Day/index.html via the Update History action.
• Coding conventions and how-tos → a new page under workspace/guides/.
• Recurring procedures → a new page under workspace/actions/.

What may go in Claude local memory

Only things that genuinely cannot live in the repo:

• The path to the project directory on the local machine.
• Paths to sibling projects (e.g. rokojori-auth).
• User preferences that predate or are unrelated to this project.

Never write planned features, open bugs, session summaries, or architectural decisions into Claude local memory. If it belongs to the project, it belongs in the workspace.