c3a151a87b
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>
33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# 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
|