memory-system
Store and retrieve long-term project context, architectural decisions, and learnings.
When & Why to Use This Skill
The Memory System skill empowers Claude agents to maintain long-term project persistence by storing and retrieving critical context, architectural decisions, and key learnings. It effectively bridges the gap between individual sessions, ensuring that vital technical insights and project history are preserved for consistent, informed decision-making throughout the software development lifecycle.
Use Cases
- Architectural Decision Tracking: Record and recall the rationale behind major design choices (ADRs) to ensure future development remains aligned with the original project vision.
- Persistent Learning Repository: Capture 'lessons learned' from complex debugging sessions or refactoring tasks to prevent recurring issues and streamline future troubleshooting.
- Project Context Continuity: Maintain a searchable database of project-specific setup instructions, coding standards, and business logic that persists across multiple AI interactions and sessions.
| name | Memory System |
|---|---|
| description | Store and retrieve long-term project context, architectural decisions, and learnings. |
Memory System Skill
This skill allows you to interact with the project's long-term memory system using scripts/memory.py. Use this to store information that should persist beyond the current session or task.
Core Commands
List Memories
List all stored memories, optionally filtering by tag.
python3 scripts/memory.py list [--tag TAG] [--limit N]
Create Memory
Create a new memory entry. Use this for architectural decisions, important learnings, or project context.
python3 scripts/memory.py create "Title" "Content" [--tags "tag1, tag2"]
Read Memory
Read the full content of a specific memory.
python3 scripts/memory.py read [FILENAME_OR_SLUG]
Usage Guidelines
- Check Memory before starting complex tasks to see if there are relevant past learnings or decisions.
- Create Memory when you make a significant architectural decision or learn something that will be useful for future developers (human or AI).
- Tags help categorize memories (e.g.,
architecture,setup,bugfix).