memory-reflect
Installation
SKILL.md
Memory reflect
Requires a local filesystem. Otherwise stop and say so.
Read references/practices.md and references/layout.md (generated copies of the init skill references).
Procedure
- Gather candidates from
SCRATCHPAD.md,HANDOFF.md, and the conversation. - Answer the three reflection questions from block
reflectionin practices.md. Do not rewrite them. - Filter using block
write-rulesand the trust rules: drop secrets, activity logs, derivable facts, and any item whose only origin is external content (or flag it for confirmation; never silently save). - Route each survivor: friction or roadblock →
memory/gotchas.md; topic detail →memory/<topic>.md; a choice →docs/decisions/; current belief →knowledge/. - Search existing memory for the topic. Update in place, or supersede (set old file
status: supersededandsuperseded_by, write the new file). Never leave two contradictory active entries. - Show a table: target file, create / update / supersede, one-line content,
origin. Wait for confirmation. Never write silently. - Apply. Add or refresh frontmatter (
updated= today). In the same change, update the matching index line, and add the decision record or aknowledge/log.mdentry when the item is a decision. - Clear
SCRATCHPAD.mdwhen the task is done. Fold into memory or deleteHANDOFF.mdif the next session no longer needs it. - If
memory-auditis installed, runnode <memory-audit>/scripts/audit.mjs --checkand report the result.
Running reflect twice on the same input must not create duplicate entries.