Creates MEMORY.md index and 10 memory files documenting: - Scripts: context-load, start-claude, install-hooks, setup-formatters, git-status-report - Skills: /log, /reflect-logs, /reflect, /distill-best-practices, /linter Each file covers purpose, usage, how it works, and gotchas. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
skill: /reflect-logs
Location: custom-claude-skills/skills/reflect-logs/SKILL.md
Purpose
Processes unprocessed session logs from memory/log/ into structured, topic-based memory files. Routes gotchas, decisions, and process lessons to the appropriate memory/*.md files. Run periodically or after several sessions.
Usage
/reflect-logs
No arguments. Automatically identifies unprocessed logs via .reflection-state.json.
How it works
- Compares
memory/log/against.reflection-state.jsonto find new/changed logs (by md5 hash) - Reads each unprocessed log and categorises entries by destination:
[topic]gotchas →memory/gotchas-<topic>.md- Decisions →
memory/decisions.md - Process Notes →
memory/process-lessons.md
- Deduplicates by substance (semantic, not string match) against existing entries
- Runs staleness detection: flags version-specific bugs that have been fixed, manual processes that have been automated
- Updates
MEMORY.mdindex if new topic files were created - Updates
.reflection-state.jsonwith processed hashes
Part of the knowledge pipeline
/log → /reflect-logs → /distill-best-practices
Gotchas
- Respects
max_logs_per_runfrom settings (default 10), processes oldest first - Creates new
gotchas-<topic>.mdfiles automatically if a[topic]tag doesn't match existing files