lesson-refreshlisted

# Lesson Refresh ## Core Rule Decide keep / update / promote / encode / archive per lesson based on relevance and recency. Never delete a lesson without recording why. ## Kit Context Before starting this skill, ensure you have completed session boot: 1. Read `CODEBASE_MAP.md` for project understanding 2. Read `CLAUDE.project.md` if it exists for project-specific rules 3. Read `tasks/lessons/_index.md` for accumulated corrections (Top Rules + index) If any of these haven't been read in this session, read them now before proceeding. ## When to Use Invoke with `/lesson-refresh` when: - It's been ≥2 weeks since the last refresh (or never) - The Top Rules index has grown beyond ~10 items - You've shipped a major refactor that may have invalidated old lessons - The session-boot context feels noisy (compaction kicking in too often) - You want to promote a recurring lesson into a hook or CLAUDE.md rule Not for: - Adding new lessons — those come from user corrections during regular sessions - Editing a single lesson — just open the file - Project-wide cleanup — that's the broader "Spa Day" ritual in `agent_docs/skills.md` ## Scope Rules - Operates only on files in `tasks/lessons/` - Reads CLAUDE.md, CLAUDE.project.md, `.claude/hooks/`, and code surface as evidence — never modifies them - Modifies lesson frontmatter (`status`, `updated`, `top_rule`) and `_index.md` Top Rules - Moves archived lessons to `tasks/lessons/_archive/` (creates if missing) - Never deletes lesson fi