# Audit Memory

> Audit agent memory files (ISSUES, BACKLOG, DECISIONS, COMMANDS, CONTEXT) for structure, staleness, placement, consistency, and DECISIONS.md bloat; fix accepted findings.

- Skill: `conn-castle/audit-memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add conn-castle/audit-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/conn-castle/audit-memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: conn-castle (https://skillmd.com/u/conn-castle)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/conn-castle/audit-memory

---


# audit-memory

Audit memory files and fix evidence-backed problems.

## Scope

- Default scope is ISSUES.md, BACKLOG.md, DECISIONS.md,
  COMMANDS.md, and CONTEXT.md.
- Accept a subset, audit-only mode, documentation cross-checks, and a report
  limit that does not reduce coverage.
- Do not create a missing memory file. Report it and follow repository policy.
- Do not modify source code, tests, or repository documentation.

Write `.agent-layer/tmp/audit-memory.<run-id>.report.md`, using
`YYYYMMDD-HHMMSS-<short-rand>` for `run-id`.

## Contract

- Read each file's purpose, format, and insertion-marker rules before editing.
- Validate staleness against current evidence; do not remove or complete entries
  by inference.
- Fix clear format, duplication, placement, staleness, and supersession issues.
- Preserve uncertain entries and name missing evidence or decisions without
  blocking independent work.
- Preserve future-guiding constraints and tradeoffs. Historical completeness is
  not a reason to retain an entry.

## Workflow

Inspect scope as one coherent set, optionally with a read-only investigator. The
owning agent validates evidence and edits. Check:

- required sections, markers, and entry formats
- stale, completed, duplicate, or misplaced ISSUES.md and BACKLOG.md entries
- COMMANDS.md commands against current evidence
- CONTEXT.md facts and cross-file contradictions or duplication
- DECISIONS.md entries that are superseded, duplicated, now self-evident, or no
  longer constrain future work

Consolidate superseded decision chains while retaining future-guiding rationale.
Remove proven stale/completed entries and move entries only when both files are
in scope. Audit-only mode
records the same outcomes without edits.

The report contains:

1. `# Memory Audit Summary` — files and verdict
2. `## Fixes Applied` — grouped by file
3. `## Material Findings` — evidence and affected file
4. `## Decisions Needed` — the smallest unresolved questions
5. `## Residual Risk`

Use `None` for empty sections. Do not inventory unaffected entries or log the
audit in memory. Finish after structural, content, and cross-file coverage, with
every finding fixed, preserved with a reason, or recorded in audit-only mode.