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

@@ -0,0 +1,16 @@
# Step 9 — Implementation Detail
`docs/adr/0004-lessons-and-overlays-arrive-as-skills.md` was accepted by the owner on 2026-10-08, with its six decisions as written:
1. No lesson takes effect without a person's approval.
2. A lesson is kept only if the evaluation, run with and without it, holds quality and lowers Revisions, time or tokens.
3. Lessons are per Cloud provider, listed in that provider's bundle.
4. Overlay Skills come only from directories the deployment configures; a caller names one and cannot upload one; an unknown name refuses the Execution at the start.
5. Every Execution records the Skills it loaded and a content hash of each.
6. Lesson candidates are client data: stored with the Execution's records, never in the repository, and a lesson carries no client detail.
`CONTEXT.md` gained **Lesson candidate**, **Lesson** and **Overlay Skill**. Steps 10 and 12 in `DETAIL.md` were updated to name the decisions they must meet.
Already in place from earlier steps: lesson candidates are captured per Execution (step 7) under a gitignored folder, and each Execution records the version of every Skill it loaded.
Not built: the curator and the lessons Skill (step 10), and overlay Skills chosen per Execution (step 12).