Manage Memories

Claude Memory Skill

Memory layer operations for persistent session storage (via file-operations-base skill).

What This Skill Provides

• CRUD operations for memory storage files
• Category-based organization
• Timestamp-based file naming for context files
• Age-based cleanup
• Memory file format validation

When to Activate This Skill

Activate this skill when:

• Persisting session context
• Cleaning up old memory files

Memory Categories

Workflow: Memory Operations

Pattern: Command Chain Execution

Manage the memory layer for session persistence (via file-operations-base skill).

Parameters

• operation (required): One of save, load, list, query, cleanup
• category (optional): One of context
• identifier (optional): File identifier or summary name
• content (optional): JSON content for save operations

Step 1: Execute Operation

python3 .plan/execute-script.py plan-marshall:manage-memories:{operation} [--category {category}] [--identifier {identifier}] [--content '{content}']

Step 2: Process Result

Parse JSON output and handle accordingly.

Operations Reference

Example Usage

# Save context snapshot (directories created on-the-fly)
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory save --category context --identifier "feature-auth" --content '{"notes": "Working on auth feature"}'

# Load memory file
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory load --category context --identifier "2025-12-02-feature-auth"

# List context files from last 7 days
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory list --category context --since 7d

# Find files matching pattern
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory query --pattern "auth*" --category context

# Cleanup old context files
python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory cleanup --category context --older-than 7d

Workflow: Validate Memory File

Pattern: Command Chain Execution

Validate memory file format and structure.

Parameters

• file_path (required): Path to memory file

Step 1: Execute Validation

python3 .plan/execute-script.py plan-marshall:manage-memories:manage-memory validate {file_path}

Step 2: Process Result

{
  "success": true,
  "valid": true,
  "checks": [
    {"check": "json_syntax", "passed": true},
    {"check": "required_fields", "passed": true}
  ]
}

Memory File Format

All memory files use a metadata envelope:

{
  "meta": {
    "created": "2025-11-25T10:30:00Z",
    "category": "context",
    "summary": "feature-auth",
    "session_id": "optional-session-id"
  },
  "content": {
    // Category-specific content
  }
}

Required Meta Fields

Scripts

All scripts:

• Use Python stdlib only (json, argparse, pathlib, datetime)
• Output JSON to stdout
• Exit code 0 for success, 1 for errors
• Support --help flag

Integration Points

With json-file-operations Skill

• Uses generic JSON operations for low-level file access

With Scripts Library

• Memory scripts are discovered via scripts-library.toon
• Use portable notation from Scripts table above

With planning Bundle

• Memory operations enable task state persistence
• Cleanup operations maintain memory hygiene

References

• references/memory-layer-format.md - Complete memory file format documentation