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:
Paul O'Reilly
2026-03-13 12:10:47 +13:00
parent a5c6373f63
commit c3a151a87b
11 changed files with 333 additions and 0 deletions

32
memory/skill-reflect.md Normal file
View File

@@ -0,0 +1,32 @@
# skill: /reflect
**Location:** `custom-claude-skills/skills/reflect/SKILL.md`
## Purpose
Runs a milestone reflection after completing a milestone. Reviews the full conversation history, git log, and current project docs to produce structured reflection artifacts.
## Usage
```
/reflect M8
```
Takes the milestone identifier as an argument (e.g., `M8`, `M3`).
## How it works
1. Reviews the entire conversation history for the milestone
2. Analyses git log to quantify: total commits, fix vs. forward progress ratio, longest debugging detour
3. Drafts reflection covering: process improvements, key knowledge for reproduction, scripts/automation opportunities, future improvement ideas
4. Updates files in order:
- `MEMORY.md` — Adds milestone reflection section and updates gotchas/process lessons
- `FUTURE.md` — Adds new improvement ideas
- `README.md` — Updates milestone table and scripts section
- `CLAUDE.md` — Updates repo structure and conventions
## Gotchas
- Must be run while the conversation still has the full milestone context (before compaction)
- Quality checks enforce: actionable bullets, symptom+fix for gotchas, rule format for process lessons, all four fields for FUTURE items
- The verify script for the milestone (`scripts/verify-m<N>.sh`) should be read manually as part of the reflection