---
description: Read lessons when relevant; lift durable ones into rules/skills
alwaysApply: true
---

# Lessons Convention

## Rules

1. **Read when relevant** — skim `.agents/lessons.md` when the task touches an area with past corrections; not a mandatory full read every session.
2. **Append only durable, non-obvious corrections** — not session trivia already in a rule, skill, or reference doc.
3. **Prefer lifting** — when a lesson becomes policy, move it to `.agents/rules/` or the relevant skill and remove the bullet here (or supersede with one line pointing at the rule).
4. **Keep entries atomic** — one lesson per bullet. One sentence.
5. **No duplicates** — merge or supersede instead of appending near-duplicates.
6. **Supersede, don't accumulate** — outdated lesson → one replacement bullet; don't leave both.
