← ClaudeAtlas

reflectlisted

Per-project self-improvement — reads the .harness ledger and feedback memories, then proposes gated rule/threshold/ADR changes so the project stops repeating mistakes. Run periodically.
sneg55/agent-starter · ★ 8 · Data & Documents · score 81
Install: claude install-skill sneg55/agent-starter
# Reflect: Per-Project Self-Improvement You are performing a reflection — turning the signal this project has captured into durable improvements. Nothing is applied without the developer's approval. ## Phase 1 — Orient (gather signal) - Run the stats script over the ledger: `~/.claude/hooks/harness-ledger-stats.sh --ledger .harness/ledger.jsonl --min-recurr 3` If that path doesn't exist, the hooks aren't installed at `~/.claude/hooks/` — run the copy from wherever this project keeps them. If the script prints all zeros there is no ledger yet (no signal captured) — stop; there is nothing to reflect on. - Read the current project rules in `CLAUDE.md` so you improve them rather than duplicate. - Read recent `feedback`-type memory files — these are the developer's explicit corrections and are the highest-value signal. Locate the memory directory first (it sits next to `MEMORY.md`; `find . -name MEMORY.md` if unsure), then `grep -l 'type: feedback' <memory-dir>/*.md`. - Read the most recent `.harness/reflections/*.md` report (if any) to recall the last metric snapshot and what was already changed. ## Phase 2 — Cluster From the stats output and feedback memories, identify recurring problems: - Each `recurring <rule> <prefix> <count>` line is a friction cluster — the same check keeps firing in the same area. - Group related feedback corrections by theme. - Ignore one-off events; focus on what repeats. ## Phase 3 — Propose (one candidate per cluster) For each