docs: accept ADR-0004, lessons and overlays arrive as Skills

Accepted by the owner on 2026-10-08 with its six decisions as written:
a person approves every lesson; a lesson must be shown to help by
evaluation; lessons are per Cloud provider; overlay Skills come only from
configured directories; each Execution records the Skills it loaded; and
lesson candidates are client data kept out of the repository.

- CONTEXT.md gains Lesson candidate, Lesson and Overlay Skill.
- Iteration 4 step 9 is complete; steps 10 and 12 name the decisions they
  must meet and are unblocked. Neither is built.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-08 15:05:03 +01:00
parent 4e7a16cedd
commit c9f59be274
5 changed files with 36 additions and 6 deletions

View File

@@ -1,5 +1,5 @@
---
status: proposed
status: accepted
---
# Lessons and overlays arrive as Skills
@@ -11,9 +11,9 @@ An Execution starts clean ([CONTEXT.md](../../CONTEXT.md)) unless it is a Change
Vendored Skills stay unmodified ([ADR-0002](0002-skills-are-the-portable-unit-of-behaviour.md)); lessons and overlays sit beside them.
## Decisions to confirm
## Decisions
This ADR is proposed. Accepting it means agreeing to each of these:
Accepted by the owner on 2026-10-08, agreeing to each of these:
1. **No lesson takes effect without a person's approval.** The curator proposes; it never edits a Skill that agents load. We prefer slower learning to an agent that rewrites its own instructions.
2. **A lesson must be shown to help.** It is kept only if the evaluation, run with and without it, holds quality and lowers Revisions, time or tokens.
@@ -33,5 +33,5 @@ This ADR is proposed. Accepting it means agreeing to each of these:
- Learning is slow by design: a lesson reaches agents only after capture, proposal, review and an evaluation run.
- The evaluation must be able to see a difference a Skill makes. Its structural checks cannot, so the judged checks and the thresholds on Revisions, time and tokens become part of the loop.
- The glossary gains **Lesson candidate**, **Lesson** and **Overlay Skill** once this is accepted.
- The glossary gains **Lesson candidate**, **Lesson** and **Overlay Skill**.
- Skills can no longer be loaded once at start-up for all Executions: the runtime must resolve a role's Skills per Execution.