"""The lessons loop (ADR-0004): what Executions got wrong becomes reviewed Skill changes. capture each Execution records lesson candidates app/states/lessons.py distil recurring candidates are grouped, and a curator proposes a lesson for each group worth one evidence.py, curator.py review each proposal is an issue file a person decides proposals.py publish an approved lesson is written into the lessons Skill the provider bundle assigns to roles skill.py prove the evaluation runs with and without lessons retire a lesson that did not help, or that the upstream Skills now cover, is removed skill.py Nothing here runs inside an Execution, and no lesson reaches an agent without a person's approval. Lesson candidates are client data: they are read from the Executions' records and never copied into the repository; a lesson and its issue file carry counts and a general description only. """