rojects/workspace/guides/agent-memory/index.html

71 lines
2.7 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Agent Memory — Roject</title>
<link rel="stylesheet" href="../../_assets_/styles.css">
<link rel="stylesheet" href="../../_assets_/nav.css">
</head>
<body>
<div class="page">
<header>
<h1>Agent Memory</h1>
<p class="subtitle">How Claude agents should store and recall information about this project.</p>
</header>
<section>
<h2>The rule</h2>
<div class="card">
<h3>The workspace is the memory</h3>
<p>
All persistent knowledge about this project — planned features, decisions made,
open improvements, session notes — lives in <code>workspace/</code> and is
version-controlled. Agents must write project knowledge here, not into local
Claude memory files (<code>~/.claude/memory/</code>). The workspace is visible
to the user, survives across machines, and is the single source of truth.
</p>
</div>
<div class="card">
<h3>What goes where</h3>
<ul style="line-height:1.9">
<li><strong>Planned features and open items</strong><code>workspace/outline/index.html</code>, Smaller open improvements list or a numbered priority card.</li>
<li><strong>Session notes and what was built</strong><code>workspace/history/YYYY/MM-Month/DD-Day/index.html</code> via the Update History action.</li>
<li><strong>Coding conventions and how-tos</strong> → a new page under <code>workspace/guides/</code>.</li>
<li><strong>Recurring procedures</strong> → a new page under <code>workspace/actions/</code>.</li>
</ul>
</div>
<div class="card">
<h3>What may go in Claude local memory</h3>
<p>
Only things that genuinely cannot live in the repo:
</p>
<ul style="line-height:1.9">
<li>The path to the project directory on the local machine.</li>
<li>Paths to sibling projects (e.g. <code>rokojori-auth</code>).</li>
<li>User preferences that predate or are unrelated to this project.</li>
</ul>
<p style="margin-top:0.75rem">
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.
</p>
</div>
</section>
<footer>
Roject &mdash; guides
</footer>
</div>
<script>var NAV_ROOT = '../../';</script>
<script src="../../_assets_/nav-data.js"></script>
<script src="../../_assets_/nav.js"></script>
</body>
</html>