---
name: Debug Memory
slug: debug-memory
category: Quality
description: Debug Memory queries and manages executable feedback session history. Use it to find past failures, inspect learned patterns, review stats, or archive the memory store.
github: "https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/debug-memory"
language: TypeScript
stars: 209
forks: 32
install: "npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/debug-memory ~/.claude/skills/debug-memory"
installs_to: ~/.claude/skills/debug-memory
source_path: agentic/code/addons/agent-loop/skills/debug-memory/SKILL.md
collection_size: 25
category_size: 1557
collection_url: "https://dirskills.com/collections/jmagly/aiwg"
added: 2026-09-04T05:26:55.689Z
last_synced: 2026-09-04T05:26:55.689Z
canonical_url: "https://dirskills.com/skills/debug-memory"
---

# Debug Memory

Debug Memory queries and manages executable feedback session history. Use it to find past failures, inspect learned patterns, review stats, or archive the memory store.

**Install:**

```bash
npx degit https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/agent-loop/skills/debug-memory ~/.claude/skills/debug-memory
```

## README

# Debug Memory Command

Query, analyze, and manage the debug memory from executable feedback loops.

## Instructions

Manage the debug memory stored in `.aiwg/ralph/debug-memory/`:

### Subcommand: query

Search debug memory for relevant past execution sessions.

1. Search `.aiwg/ralph/debug-memory/sessions/` for matching entries
2. Match by file path, error type, test name, or keyword
3. Display relevant sessions with fix attempts and outcomes
4. Highlight reusable patterns

### Subcommand: patterns

Display learned patterns from past debug sessions.

1. Load `.aiwg/ralph/debug-memory/patterns/learned-patterns.yaml`
2. Show pattern frequency, success rate, and applicability
3. Suggest patterns applicable to current context

### Subcommand: stats

Show aggregate statistics from debug memory.

1. Total sessions, pass rate, average attempts
2. Most common error types
3. Most effective fix patterns
4. Files with highest failure frequency

### Subcommand: clear

Clear debug memory (with confirmation).

1. Prompt for confirmation
2. Archive current memory to `.aiwg/ralph/debug-memory/archive/`
3. Reset sessions and patterns

## Arguments

- `query [keyword]` - Search debug memory
- `patterns` - Show learned patterns
- `stats` - Show aggregate statistics
- `clear` - Clear and archive debug memory
- `--file [path]` - Filter by source file
- `--error [type]` - Filter by error type
- `--since [date]` - Filter by date

## References

- @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/executable-feedback.md - Executable feedback rules
- @$AIWG_ROOT/agentic/code/addons/ralph/docs/executable-feedback-guide.md - Guide
