Files

Paul O'Reilly c3a151a87b 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>

2026-03-13 12:10:47 +13:00

1.3 KiB

Raw Blame History

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

Reviews the entire conversation history for the milestone
Analyses git log to quantify: total commits, fix vs. forward progress ratio, longest debugging detour
Drafts reflection covering: process improvements, key knowledge for reproduction, scripts/automation opportunities, future improvement ideas
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

1.3 KiB Raw Blame History