Files
Claude-Code-Workflow/docs/features/memory.md
catlog22 4a89f626fc Refactor documentation for code commands and workflows
- Updated command syntax formatting to use code blocks for clarity in `prep.md`, `review.md`, and `spec.md`.
- Enhanced architectural diagrams in `ch01-what-is-claude-dms3.md` and core concepts in `ch03-core-concepts.md` using mermaid syntax for better visualization.
- Improved workflow diagrams in `ch04-workflow-basics.md` and `4-level.md` to provide clearer representations of processes.
- Added troubleshooting section in `installation.md` to address common installation issues and provide quick start examples.
- Revised skill documentation in `claude-meta.md` and `claude-workflow.md` to standardize command triggers and output structures.
- Updated best practices and workflow index documentation to enhance readability and understanding of workflow levels and practices.
2026-02-28 19:53:24 +08:00

2.1 KiB

Memory System

One-Liner

The Memory System is a cross-session knowledge persistence mechanism — Stores project context, decisions, and learnings so AI remembers across sessions without re-explanation.


Pain Points Solved

Pain Point Current State Memory System Solution
Cross-session amnesia New session requires re-explaining project Persistent memory across sessions
Lost decisions Architecture decisions forgotten Decision log persists
Repeated explanations Same context explained multiple times Memory auto-injection
Knowledge silos Each developer maintains own context Shared team memory

vs Traditional Methods

Dimension CLAUDE.md Notes Memory System
Persistence Static file Manual Auto-extracted from sessions
Search Text search Folder search Semantic vector search
Updates Manual edit Manual note Auto-capture from conversations
Sharing Git Manual Auto-sync via workflow

Core Concepts

Concept Description Location
Core Memory Persistent project knowledge ~/.claude/memory/
Session Memory Current session context .workflow/.memory/
Memory Entry Individual knowledge item JSONL format
Memory Index Searchable index Embedding-based

Usage

Viewing Memory

ccw memory list
ccw memory search "authentication"

Memory Categories

  • Project Context: Architecture, tech stack, patterns
  • Decisions: ADRs, design choices
  • Learnings: What worked, what didn't
  • Conventions: Coding standards, naming

Configuration

// ~/.claude/settings.json
{
  "memory": {
    "enabled": true,
    "maxEntries": 1000,
    "autoCapture": true,
    "embeddingModel": "text-embedding-3-small"
  }
}