28 lines
1.4 KiB
Markdown
28 lines
1.4 KiB
Markdown
# Memory and Retention Rules
|
|
|
|
## Hard Rules
|
|
|
|
1. You MUST store learned operational memory in `~/.config/mosaic/memory`.
|
|
2. You MUST NOT store durable memory in runtime-native memory silos.
|
|
3. You MUST write concise, reusable learnings that help future agents.
|
|
4. 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 |
|