# 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