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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user