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

@@ -66,6 +66,18 @@ _Avoid_: prompt template, instructions, playbook
The hyperscaler a solution architecture targets, such as Google Cloud. Each Cloud provider brings its own Skills, plus the MCP servers it hosts for discovering a user's current environment and grounding recommendations in its documentation.
_Avoid_: hyperscaler, cloud, platform, target
**Lesson candidate**:
Something an Execution got wrong or was corrected on, recorded as it happened: a Revision and its reason, a tool refusal, a user's request for changes. It is raw material and changes nothing by itself.
_Avoid_: learning, memory, feedback record
**Lesson**:
A rule distilled from Lesson candidates across Executions, approved by a person and shown by evaluation to help, then published in a Skill. It carries no client detail.
_Avoid_: memory, fine-tuning, learned behaviour
**Overlay Skill**:
A Skill that adds an organisation's standards or one engagement's constraints to what the Cloud provider's Skills say. It is named when an Execution starts and comes only from a place the deployment has configured.
_Avoid_: custom prompt, override, plugin
### Outputs
**Deliverable**: