1.4 KiB
1.4 KiB
Memory and Retention Rules
Hard Rules
- You MUST store learned operational memory in
~/.config/mosaic/memory. - You MUST NOT store durable memory in runtime-native memory silos.
- You MUST write concise, reusable learnings that help future agents.
- You MUST track active execution state in project documentation, not ad-hoc text files.
Runtime-Native Memory Silos (FORBIDDEN for Durable Memory)
| Runtime | Native silo (forbidden for durable memory) | Required durable location |
|---|---|---|
| Claude Code | ~/.claude/projects/*/memory/ |
~/.config/mosaic/memory/ + project docs/ |
| Codex | Runtime session/native memory under ~/.codex/ |
~/.config/mosaic/memory/ + project docs/ |
| OpenCode | Runtime session/native memory under ~/.config/opencode/ |
~/.config/mosaic/memory/ + project docs/ |
Treat runtime-native memory as volatile implementation detail. Do not rely on it for long-term project continuity.
Project Continuity Files (MANDATORY)
| File | Purpose | Location |
|---|---|---|
docs/PRD.md or docs/PRD.json |
Source of requirements for planning, coding, testing, and review | Project docs/ |
docs/TASKS.md |
Canonical tracking for tasks, milestones, issues, status, and blockers | Project docs/ |
docs/scratchpads/<task>.md |
Task-specific working memory and verification evidence | Project docs/scratchpads/ |
AGENTS.md |
Reusable local patterns and gotchas | Any working directory |