diff --git a/workspace/_assets_/nav-data.js b/workspace/_assets_/nav-data.js index 0695fa8..622f158 100644 --- a/workspace/_assets_/nav-data.js +++ b/workspace/_assets_/nav-data.js @@ -17,6 +17,7 @@ var NAV_DATA = { { title: 'Writing Editor Panels', path: 'guides/writing-editor-panels/index.html' }, { title: 'Writing Backend Routes', path: 'guides/writing-backend-routes/index.html' }, { title: 'Locales', path: 'guides/locales/index.html' }, + { title: 'Agent Memory', path: 'guides/agent-memory/index.html' }, ] }, { diff --git a/workspace/guides/agent-memory/index.html b/workspace/guides/agent-memory/index.html new file mode 100644 index 0000000..c030518 --- /dev/null +++ b/workspace/guides/agent-memory/index.html @@ -0,0 +1,70 @@ + + + + + + Agent Memory — Roject + + + + +
+ +
+

Agent Memory

+

How Claude agents should store and recall information about this project.

+
+ +
+

The rule

+ +
+

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. +

+
+ +
+ + + +
+ + + + + diff --git a/workspace/guides/index.html b/workspace/guides/index.html index 31267df..01a8f4c 100644 --- a/workspace/guides/index.html +++ b/workspace/guides/index.html @@ -65,6 +65,18 @@

+
+

Agent Memory

+

+ Where agents should store and recall project knowledge — the rule that the + workspace is the memory, what goes in the outline vs. history vs. guides, + and what (little) may go in Claude local memory files. +

+

+ Read the guide +

+
+