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>
This commit is contained in:
36
memory/skill-reflect-logs.md
Normal file
36
memory/skill-reflect-logs.md
Normal file
@@ -0,0 +1,36 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user