memory-forget
Delete, redact, or archive project and global memories when the user says forget this, delete memory, remove that preference, do not remember, redact sensitive information, or retire stale memory.
SKILL.md.agents/skills/memory-forget/SKILL.md
GitHubMemory Forget
You remove memory deliberately and traceably. Forgetting is a first-class memory capability, especially for global memory.
Workflow
- Identify exact target memory and scope: project, global, or both.
- Confirm ambiguity if multiple entries match.
- Classify action: delete, redact, archive, mark superseded, or add do-not-store rule.
- For secrets or sensitive data, redact immediately and report the affected files.
- Update index and routing files so forgotten memory is not recalled.
- If archiving, move entry to
archived/with reason and date. - If global memory shrinks, update
global-index.md. - Log project file changes in
docs/skill-outputs/SKILL-OUTPUTS.md.
Forget Actions
| Request | Action |
|---|---|
| "forget this preference" | delete or mark retired in global memory |
| "do not remember X" | add a do-not-store rule if useful |
| "remove old decision" | mark superseded or archive, do not erase rationale unless requested |
| "this contains a secret" | redact and invoke security review |
Hard Rules
- User deletion requests override convenience.
- Do not keep active index references to forgotten entries.
- Do not silently delete decision rationale when archival is safer.
- Do not archive secrets; redact them.
Output Format
Forget complete
Target: <memory>
Scope: <project/global/both>
Action: delete | redact | archive | retire
Files changed: <paths>
Residual references removed: yes/no
Example
User: "Forget that global preference; it is no longer true."
Output: remove or retire the matching entry in ~/.agent-loom/memories/user-preferences.md and update global-index.md.
Common Rationalizations
| Excuse | Reality |
|---|---|
| Skip memory — just code | Next agent loses decisions, blockers, and approved scope. |
| Load every memory file | Read indexes and handoff tail only — bounded context. |
| Global memory for everything | Project memory default; global only when stable and cross-project. |
| External paste → memory | Run secure-* first; transform to agent-authored notes. |
Verification
- Correct sub-skill routed with reason
- No secrets or raw transcripts persisted
- Files changed listed in Impact Report
- Security gate noted when external content involved
Red Flags
- User deletion request overridden for convenience
- Index still references forgotten entry paths
- Decision rationale deleted when archival was safer
- Forget run without checking downstream handoff refs
Prune Log
Last pruned: 2026-07-04
- No changes — citation audit passed; content current (improve-skills full pass 2026-07-04)
Impact Report
After completing, report:
Memory forgotten: <target>
Action: <delete/redact/archive/retire>
Scope: <scope>
Indexes updated: yes/no
Security issue: yes/no