---

name: memory-summarize description: Compress memories into structured summaries using low-cost AI models (Claude Haiku, GPT-4o-mini). Triggers when memory count exceeds 50 or token estimate exceeds 40000. Outputs structured JSON with compression metrics. license: Apache-2.0 compatibility: Requires BrAIny API at localhost:3000, Bun runtime metadata: author: brainy version: "1.1" category: memory-management subagent: summarizer allowed-tools: Bash(bun:*)

Memory Summarization

Compresses multiple memories into structured summaries. Reduces context size while preserving critical information.

Execution Path

Copy┌─────────────────────────────────────────────────────────┐
│                   EXECUTION DECISION                    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────┐     ┌───────────────────┐                │
│  │  START   │────▶│ SUBAGENT AVAILABLE?│                │
│  └──────────┘     └─────────┬─────────┘                │
│                             │                           │
│              ┌──────────────┴──────────────┐           │
│              ▼                             ▼           │
│       ┌────────────┐                ┌────────────┐     │
│       │    YES     │                │     NO     │     │
│       └─────┬──────┘                └─────┬──────┘     │
│             │                             │            │
│             ▼                             ▼            │
│  ┌─────────────────────┐      ┌─────────────────────┐  │
│  │ Task(summarizer,    │      │ Bash(bun scripts/   │  │
│  │   prompt: "...")    │      │   create-summary.ts)│  │
│  └─────────────────────┘      └─────────────────────┘  │
│                                                         │
└─────────────────────────────────────────────────────────┘

Path A: Subagent Available (Preferred)

Use the summarizer subagent for lower token cost:

CopyTask(
  subagent_type: "summarizer",
  description: "Summarize memories",
  prompt: "Check stats and create coding_session summary for project 3afb861a-b783-45a6-bba2-4b6d96468aeb"
)

Path B: Script Fallback

If subagent unavailable, execute scripts directly:

Copybun .opencode/skills/memory-summarize/scripts/check-memory-stats.ts PROJECT_ID
bun .opencode/skills/memory-summarize/scripts/create-summary.ts PROJECT_ID TYPE

---

State Machine

Copy┌─────────────────────────────────────────────────────────────────────┐
│                     SUMMARIZATION WORKFLOW                          │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  ┌──────────┐     ┌──────────────┐     ┌─────────────────────────┐ │
│  │  START   │────▶│ CHECK_STATS  │────▶│ EVALUATE_THRESHOLDS     │ │
│  └──────────┘     └──────────────┘     └─────────────────────────┘ │
│                                                   │                 │
│                          ┌────────────────────────┼────────────┐   │
│                          ▼                        ▼            │   │
│                   ┌────────────┐          ┌────────────┐       │   │
│                   │ SKIP       │          │ SUMMARIZE  │       │   │
│                   │ (below     │          │ (above     │       │   │
│                   │ threshold) │          │ threshold) │       │   │
│                   └────────────┘          └─────┬──────┘       │   │
│                          │                      │              │   │
│                          │               ┌──────▼──────┐       │   │
│                          │               │ SELECT_TYPE │       │   │
│                          │               └──────┬──────┘       │   │
│                          │                      │              │   │
│                          │    ┌─────────────────┼─────────────┐│   │
│                          │    ▼                 ▼             ▼│   │
│                          │ ┌────────┐    ┌────────────┐ ┌──────┴┐  │
│                          │ │coding_ │    │conversation│ │custom │  │
│                          │ │session │    │            │ │       │  │
│                          │ └───┬────┘    └─────┬──────┘ └───┬───┘  │
│                          │     └───────────────┼────────────┘      │
│                          │                     ▼                   │
│                          │              ┌─────────────┐            │
│                          │              │ CREATE_     │            │
│                          │              │ SUMMARY     │            │
│                          │              └──────┬──────┘            │
│                          │                     │                   │
│                          │              ┌──────▼──────┐            │
│                          │              │ VERIFY_     │            │
│                          │              │ COMPRESSION │            │
│                          │              └──────┬──────┘            │
│                          │                     │                   │
│                          │         ┌───────────┴───────────┐       │
│                          │         ▼                       ▼       │
│                          │  ┌────────────┐         ┌────────────┐  │
│                          │  │ SUCCESS    │         │ FAILURE    │  │
│                          │  │ ratio > 2.0│         │ ratio < 2.0│  │
│                          │  └─────┬──────┘         └─────┬──────┘  │
│                          │        │                      │         │
│                          │        ▼                      ▼         │
│                          │  ┌──────────┐          ┌──────────┐     │
│                          └─▶│   END    │◀─────────│  RETRY   │     │
│                             └──────────┘          └──────────┘     │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

States

Thresholds

Summary Types

coding_session

Input: Development memories (file changes, errors, debugging)

Output sections:

• objective: string (one sentence)
• progress: string[] (action → result)
• filesTouched: {path, operation, changes}[]
• currentState: string
• criticalDetails: string[]

conversation

Input: Dialogue memories (discussions, decisions)

Output sections:

• topics: string[]
• decisions: string[]
• actionItems: string[]
• context: string[]
• openQuestions: string[]

custom

Input: Any memories with custom prompt

Output sections:

• prompt: string
• content: string
• keyPoints: string[]

Commands

Check Statistics

Copybun .opencode/skills/memory-summarize/scripts/check-memory-stats.ts PROJECT_ID [--show-compression]

Output:

CopyMemory Count: 150
Estimated Tokens: 60000
⚠️  Memory count exceeds threshold (50)
Recommendation: Run summarization

Create Summary

Copybun .opencode/skills/memory-summarize/scripts/create-summary.ts PROJECT_ID TYPE [CUSTOM_PROMPT]

Parameters:

• PROJECT_ID: UUID (required)
• TYPE: coding_session | conversation | custom (default: coding_session)
• CUSTOM_PROMPT: string (required if TYPE=custom)

Output:

CopySummary ID: abc-123
Compression Ratio: 6.25x
Token Reduction: 84%
  Original: 5000 tokens
  Compressed: 800 tokens
Memories:
  Summarized: 44
  Retained: 6

Get Hybrid Context

Copybun .opencode/skills/memory-summarize/scripts/get-context.ts PROJECT_ID [QUERY]

Output:

Copy{
  "summaries": [...],
  "recentMemories": [...],
  "relevantMemories": [...]
}

Configuration

Error Codes

Decision Tree

CopyIs memory count >= 50?
├── YES → Summarize
└── NO → Is token estimate >= 40000?
         ├── YES → Summarize
         └── NO → Skip (no action needed)

If Summarize:
├── Contains file changes, errors, code? → coding_session
├── Contains discussion, decisions? → conversation
└── User specified prompt? → custom