Files
claude-foundations/memory/skill-reflect-logs.md
Paul O'Reilly c3a151a87b Backfill memory files for all existing scripts and skills
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>
2026-03-13 12:10:47 +13:00

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

  1. Compares memory/log/ against .reflection-state.json to find new/changed logs (by md5 hash)
  2. 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
  3. Deduplicates by substance (semantic, not string match) against existing entries
  4. Runs staleness detection: flags version-specific bugs that have been fixed, manual processes that have been automated
  5. Updates MEMORY.md index if new topic files were created
  6. Updates .reflection-state.json with processed hashes

Part of the knowledge pipeline

/log/reflect-logs/distill-best-practices

Gotchas

  • Respects max_logs_per_run from settings (default 10), processes oldest first
  • Creates new gotchas-<topic>.md files automatically if a [topic] tag doesn't match existing files