Menu
Inspect and manage agent memory directories. Lists all sr-* agent memory stores, shows per-agent stats (file count, size, last modified), displays recent entries, and detects stale or orphaned files.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Run the implement pipeline over multiple backlog tickets in one session. Per ticket: spawn architect โ spawn developer โ spawn reviewer (the same three-phase pipeline $implement runs), then move to the next. Sequential by default; parallel only when the user explicitly opts in AND the tickets are independent. Reports an aggregated verdict at the end. Use when the user invokes `$batch-implement #N #M #K` or `$batch-implement --status todo`.
Implement a single backlog ticket through a multi-phase pipeline: architect plans (OpenSpec proposal+design+tasks+specs), sr-developer codes in TDD order, sr-reviewer validates (correctness, tests, security, performance). A profile may add custom-* rails. Reads .specrails/local-tickets.json, closes the ticket in place, reports concisely. Use when the user invokes `$implement #N` or `$implement <free-form>`.
Architect role for the specrails implement pipeline. Reads a backlog ticket, surveys the repo, produces (a) an OpenSpec change package under openspec/changes/<slug>/ and (b) a plan artefact under .specrails/agent-memory/explanations/. Does NOT write production code. Invoked by the implement orchestrator via $sr-architect after a spawn_agent / send_message handoff.
Developer role for the specrails implement pipeline. Reads the architect's design + tasks.md and implements them in TDD order: for each task, write a failing test first, run it to confirm it fails, then write the minimum production code to make it pass, then re-run. Reports the files changed. Does NOT review its own work beyond the per-task test cycle. Invoked by the implement orchestrator via $sr-developer.
Reviewer role for the specrails implement pipeline. Validates the entire implementation: the OpenSpec change package (proposal/design/tasks/specs) is well-formed, the developer's code matches the design's public API and invariants, every tasks.md box is ticked, the tests cover every spec scenario, and the project's full test/build suite passes. Writes a confidence-score.json artefact. Does NOT modify the developer's code. Invoked via $sr-reviewer.
sr:batch-implement โ Batch implementation orchestrator. Accepts multiple feature references, computes dependency-aware execution waves, invokes sr:implement per wave.
| name | memory-inspect |
| description | Inspect and manage agent memory directories. Lists all sr-* agent memory stores, shows per-agent stats (file count, size, last modified), displays recent entries, and detects stale or orphaned files. |
| license | MIT |
| compatibility | Requires git. |
| metadata | {"author":"specrails","version":"1.0"} |
Inspect agent memory directories under .claude/agent-memory/sr-*/ for this project (read name from CLAUDE.md or package.json). Show per-agent stats, recent entries, and actionable recommendations.
Input: $ARGUMENTS โ optional:
<agent-name> โ inspect a specific agent's memory (e.g. sr-developer, sr-reviewer)--stale <days> โ flag files not modified in more than N days as stale (default: 30)--prune โ delete stale files after confirmation (prints the list first, then asks)Parse $ARGUMENTS to set runtime variables.
Variables to set:
AGENT_FILTER โ string or empty string. Default: "" (inspect all agents).STALE_DAYS โ integer. Default: 30.PRUNE_MODE โ boolean. Default: false.Parsing rules:
$ARGUMENTS for --stale <N>. If found, set STALE_DAYS=<N>. Validate that <N> is a positive integer; if not, print Error: --stale requires a positive integer (e.g. --stale 14) and stop. Strip from arguments.--prune. If found, set PRUNE_MODE=true. Strip from arguments.AGENT_FILTER. Strip leading/trailing whitespace.Print active configuration:
Scanning: <all agents | agent: AGENT_FILTER> | Stale threshold: STALE_DAYS days | Prune: yes/no
Glob all directories matching .claude/agent-memory/sr-*/.
If no directories are found:
No agent memory directories found under .claude/agent-memory/.
Agent memory is written by sr-* agents during the /specrails:implement pipeline.
Run /specrails:implement on a feature to generate your first memory entries.
Then stop.
If AGENT_FILTER is set, filter to only the directory .claude/agent-memory/<AGENT_FILTER>/. If that directory does not exist:
No memory directory found for agent: <AGENT_FILTER>
Available agents:
<list of discovered sr-* directory names>
Then stop.
Set AGENT_DIRS = list of matching directories (full paths), sorted alphabetically.
For each directory in AGENT_DIRS, collect:
AGENT_NAME โ directory name (e.g. sr-developer)FILE_COUNT โ total number of files (recursive, all types)TOTAL_SIZE โ total size in bytes; display as human-readable (KB, MB)LAST_MODIFIED โ ISO date of the most recently modified fileOLDEST_MODIFIED โ ISO date of the least recently modified fileSTALE_FILES โ list of files not modified in more than STALE_DAYS days (full paths)STALE_COUNT โ count of stale filesUse the current date to compute stale age. A file is stale if (today - last_modified) > STALE_DAYS.
Print a summary table after collecting all stats:
## Agent Memory Overview
| Agent | Files | Size | Last Modified | Stale (>STALE_DAYS days) |
|-------|-------|------|---------------|--------------------------|
| sr-developer | N | N KB | YYYY-MM-DD | N files |
| sr-reviewer | N | N KB | YYYY-MM-DD | N files |
| ... | ... | ... | ... | ... |
Total: N agents | N files | N KB
For each agent in AGENT_DIRS, show the 5 most recently modified files.
Print per agent:
### <agent-name>
Recent entries (5 most recent):
| File | Size | Last Modified |
|------|------|---------------|
| common-fixes.md | 2.1 KB | 2026-03-18 |
| ... | ... | ... |
If the agent directory has fewer than 5 files, show all of them.
If AGENT_FILTER is set (single-agent mode), show the full content of each file up to 50 lines. For files exceeding 50 lines, print the first 50 lines followed by:
... (N more lines โ view full file at <relative-path>)
An orphaned memory directory is one whose agent name does not correspond to a known sr-agent persona.
Known sr-agent names (check for exact match):
sr-architect, sr-developer, sr-test-writer, sr-reviewer, sr-frontend-reviewer, sr-backend-reviewer, sr-security-reviewer, sr-doc-sync, sr-product-manager
For each directory in AGENT_DIRS, check whether its AGENT_NAME is in the known list. Collect non-matching directories as ORPHANED_DIRS.
If ORPHANED_DIRS is non-empty, print:
### Orphaned Memory Directories
The following directories do not match any known sr-agent name and may be leftover from renamed or removed agents:
| Directory | Files | Size | Recommendation |
|-----------|-------|------|----------------|
| sr-old-agent | N | N KB | Review and delete if no longer needed |
If ORPHANED_DIRS is empty: skip this section entirely.
Collect all stale files across all agents (from Phase 2 STALE_FILES lists).
If no stale files exist:
No stale files found (threshold: STALE_DAYS days). Memory is up to date.
Skip the rest of Phase 5.
Otherwise, print:
### Stale Files (not modified in >STALE_DAYS days)
| Agent | File | Size | Last Modified | Age (days) |
|-------|------|------|---------------|------------|
| sr-developer | common-fixes.md | 1.2 KB | 2026-01-10 | 69 |
| ... | ... | ... | ... | ... |
N stale files total (N KB).
Skip this phase if PRUNE_MODE=false.
If PRUNE_MODE=true and there are no stale files and no orphaned directories:
Nothing to prune. All memory files are within the STALE_DAYS-day threshold.
Then stop.
Otherwise, print the full list of files and directories that will be deleted:
## Files to Delete
The following N files will be permanently deleted:
Stale files:
- .claude/agent-memory/sr-developer/common-fixes.md (69 days old)
- ...
Orphaned directories:
- .claude/agent-memory/sr-old-agent/ (N files, N KB)
Proceed? [y/N]:
Wait for user input.
y or Y:
Deleted: <path>Pruned N files (N KB freed).
Prune cancelled. No files were deleted.Print a final recommendations section based on findings:
## Recommendations
<one or more of the following, based on findings>
Recommendation rules (print only applicable ones):
Prune stale data โ if STALE_COUNT > 0 across any agent and PRUNE_MODE=false:
- N stale files detected. Run `/specrails:memory-inspect --prune` to remove them and free N KB.
Investigate large memory โ if any single agent's TOTAL_SIZE > 1 MB:
- <agent-name> memory exceeds 1 MB (TOTAL_SIZE). Consider reviewing large files:
<list files over 100 KB>
Orphaned directories โ if ORPHANED_DIRS is non-empty:
- N orphaned director(y|ies) found. Review and delete manually if no longer needed.
Empty memory directories โ if any agent directory has FILE_COUNT = 0:
- <agent-name> memory directory is empty. It may be safe to delete:
rm -rf .claude/agent-memory/<agent-name>/
Gitignore advisory โ check whether .claude/agent-memory appears in .gitignore. If not:
- Agent memory is local runtime state. Add to .gitignore:
echo '.claude/agent-memory/' >> .gitignore
If no recommendations apply, print:
All agent memory looks healthy. No action required.