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:
32
memory/skill-reflect.md
Normal file
32
memory/skill-reflect.md
Normal 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
|
||||
Reference in New Issue
Block a user