Codex

debug-memory

Query and manage the executable feedback debug memory

104 stars

Best use case

debug-memory is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

It is a strong fit for teams already working in Codex.

Query and manage the executable feedback debug memory

Teams using debug-memory should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/debug-memory/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/debug-memory/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/debug-memory/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How debug-memory Compares

Feature / Agentdebug-memoryStandard Approach
Platform SupportCodexLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Query and manage the executable feedback debug memory

Which AI agents support this skill?

This skill is designed for Codex.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

Related Skills

ralph-memory

104
from jmagly/aiwg

Manage Al semantic memory entries — list, query, and clear lessons learned across loop iterations

Codex

memory-query-capture

104
from jmagly/aiwg

Capture query synthesis as durable pages in semantic memory

Codex

memory-log-render

104
from jmagly/aiwg

Generate a human-readable Markdown view from a consumer's JSON Lines event log

Codex

memory-log-append

104
from jmagly/aiwg

Append a structured event to a consumer's semantic memory log

Codex

memory-ingest

104
from jmagly/aiwg

Ingest a source into any consumer's semantic memory by reading the topology contract

Codex

memory-forensics

104
from jmagly/aiwg

Volatility 3 memory forensics workflows covering acquisition with LiME and WinPmem, and structured analysis using Volatility 3 plugin reference

Codex

aiwg-orchestrate

104
from jmagly/aiwg

Route structured artifact work to AIWG workflows via MCP with zero parent context cost

venv-manager

104
from jmagly/aiwg

Create, manage, and validate Python virtual environments. Use for project isolation and dependency management.

pytest-runner

104
from jmagly/aiwg

Execute Python tests with pytest, supporting fixtures, markers, coverage, and parallel execution. Use for Python test automation.

vitest-runner

104
from jmagly/aiwg

Execute JavaScript/TypeScript tests with Vitest, supporting coverage, watch mode, and parallel execution. Use for JS/TS test automation.

eslint-checker

104
from jmagly/aiwg

Run ESLint for JavaScript/TypeScript code quality and style enforcement. Use for static analysis and auto-fixing.

repo-analyzer

104
from jmagly/aiwg

Analyze GitHub repositories for structure, documentation, dependencies, and contribution patterns. Use for codebase understanding and health assessment.