lessonsCapture and curate durable lessons in `.agent/lessons/` — one file per lesson, indexed in its README, surfaced by tier (enforced hook / routed doc / indexed). Use whenever the user corrects a repeatable mistake ('don't do that anymore', 'I already told you', 'remember this'), asks to save a lesson,
retroHarvest durable learnings from this session into the instruction system — with provenance, dedup, and pruning. Use at the end of a significant session, after a user correction worth keeping, when a convention drifted or a footgun was hit, or when the user says "retro", "wrap up", "save learnings", "