debug-memory ยท diff
git:20260913.7be8bcf to git:20261028.1b612a5
9 added, 0 removed. Audit A to A.
---
namespace: aiwg
name: debug-memory
platforms: [all]
description: Query and manage the executable feedback debug memory
commandHint:
category: code-quality
---
# Debug Memory Command
Query, analyze, and manage the debug memory from executable feedback loops.
+ ## HITL authorization checkpoints
+
+ Before any confirmation below, read and apply
+ [agent-loop authorization checkpoints](../../docs/hitl-authorization.md).
+ Call `aiwg config authorization check --action-file "$ACTION_FILE" --target "$TARGET_REPO"`
+ for host-classified effects. Only `auto-authorized` with a signed receipt skips
+ that workflow prompt; retain existing prompts/refusals otherwise. Platform
+ prompts are never bypassed. Limits, regression and threat overrides still require review.
+
## 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/agent-loop/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/agent-loop/docs/executable-feedback-guide.md - Guide