learn · diff
git:20260728.5ed0cb2 to git:20260728.15206c6
12 added, 7 removed. Audit A to A.
---
name: learn
description: 'Optionally analyze collections of durable verdicts for recurring evidence after the critical path. Triggers: "learn from verdicts", "mine validation history".'
practices:
- continuous-learning
- evidence-based-engineering
hexagonal_role: supporting
consumes:
- verdict.v2
produces:
- learning-observations
context_rel:
- kind: customer-of
with: validate
skill_api_version: 1
user-invocable: true
metadata:
graph_root: false
tier: execution
dependencies: []
capabilities: [analyze_verdict_collections]
effects: [write_advisory_observations]
canonical_status: canonical
disposition: keep_off_path
output_contract: advisory learning observations
---
# Learn
Learn is an optional, off-path consumer of durable `verdict.v2` collections.
It may summarize recurring evidence and propose a candidate deterministic check
for later human or caller evaluation.
Learn does not run during RPI, validate a subject, alter a verdict, mutate a
plan, promote a rule, choose continuation, or mint lifecycle artifacts. Missing
Learn output never changes whether a candidate is valid.
When invoked, bind every observation to verdict and finding digests, distinguish
repeated objectives from repeated reviews of one objective, disclose the sample
size, and stop at advisory evidence.
Overweight failures: a `NOT_PROVEN` or `FAIL` verdict carries more teaching
value than a PASS, because it names a rule the loop lacked. Harvest kernels
- from failed lanes first — the 2026-07-15 `NOT_PROVEN`
- (`.agents/ao/verdicts/sha256/b6e759dd...cb6a`, a subject destroyed by a
- mutating check mid-validation) produced more durable rules than the PASS
- (`e9b6cdb8...37b9`) that followed it.
+ from failed lanes first — the canonical example is the mutating-check
+ quarantine in `skills/validate/SKILL.md`, a durable rule minted from a
+ `NOT_PROVEN`-then-`PASS` verdict pair.
Prune for provenance decay: every cited artifact must still resolve — the
- file exists or the verdict digest is present in `.agents/ao/verdicts/`. Dead
- citations get pruned rather than paraphrased, and confidence in a lesson that
- has not been reproduced since its source decayed goes down, not sideways.
+ file exists or the verdict digest is present under `.agents/ao/verdicts/`. A
+ citation that no longer resolves gets pruned rather than paraphrased, and
+ confidence in a lesson that has not been reproduced since its source decayed
+ goes down, not sideways.
+
+ When the caller asks for a durable artifact, write the observations under
+ `.agents/scratch/learn/` and return the path; otherwise return them inline.
+ The write is advisory and TTL'd — it is never a source of record, and its
+ absence never changes whether a candidate is valid.