learn · diff
git:20260909.db1a057 to git:20260909.e1fae0d
29 added, 69 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".'
+ description: 'Optionally mine bounded episodes, verdicts and corrections after the critical path. Triggers: "learn from verdicts", "mine validation history".'
practices:
- continuous-learning
- evidence-based-engineering
hexagonal_role: supporting
consumes:
- - verdict.v2
+ - authorized-episode-evidence
produces:
- learning-observations
context_rel:
- kind: customer-of
with: validate
skill_api_version: 1
user-invocable: true
disable-model-invocation: true
metadata:
graph_root: false
tier: execution
dependencies: []
- capabilities: [analyze_verdict_collections]
+ capabilities: [analyze_bounded_evidence]
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 is an optional, off-path consumer of bounded native episodes, verdicts,
+ checks, BD handoff facts, Git changes and user corrections. It is the compatible
+ entrypoint for [Memory's mine/learn operation](../memory/references/mine-learn.md).
+ Read that reference when invoked; do not require Learn to finish ordinary work.
+ Resolve the caller-selected source set, access, question, consumer and separate
+ budget. Include failures, corrections, harmful and null outcomes. Return narrow
+ supported observations or no-change; one incident is not a general rule. Search
+ existing topic pages and prefer a qualified update or removal over a file per
+ session. Missing provenance remains a disclosed gap; do not delete unique proof.
+
+ Use only public or already-cleared inputs in this lean path. It does not enforce
+ native restricted-source access or authorize automatic transcript reads. Drafts
+ stay in caller-selected protected external non-Git storage. Exact fresh factual
+ support and destination-disclosure review precede any Git object/index/stash or
+ import under [curation](../memory/references/curate.md). Learn alone does not
+ admit a rule or change a product verdict. Preserve legacy `.agents/` evidence;
+ no blind TTL or deletion. The optional [OKF profile](references/okf-page-profile.md)
+ checks structure only.
+
## Prompt
```text
- Mine .agents/ao/verdicts/ for recurring patterns across the last 20
- verdict.v2 records in agentops-wt/train2-c. I want candidate deterministic
- checks for anything that shows up as a repeated NOT_PROVEN or FAIL cause,
- with digests cited so I can trace each observation back.
+ Use Learn on these already-cleared episodes and corrections within this separate
+ budget. Find a narrow supported improvement to the existing parser topic page,
+ or return no-change. Preserve failures and limits; no new policy or benefit claim.
```
## It's working if
- Observable in the trace, without reading the prose:
-
- - Every observation binds a `verdict.v2` digest and a finding id from
- `.agents/ao/verdicts/`.
- - A `NOT_PROVEN` or `FAIL` verdict pair is harvested before a `PASS`-only
- pattern.
- - A citation that no longer resolves under `.agents/ao/verdicts/` is
- pruned rather than paraphrased.
- - Output written to `.agents/scratch/learn/` is labeled advisory and
- TTL'd, not a source of record.
-
- ## Contract
-
- 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.
-
- Inspect informative failures first, but verdict color alone establishes neither
- learning value nor a missing rule. Cite the live hypothesis falsified or the
- uncertainty resolved, distinguish pre-existing discovery from introduced
- regression, and retain unknown causes as unknown. Repetition may justify causal
- examination; it does not prove that the design was wrong or require a new gate.
- The mutating-check quarantine in `skills/validate/SKILL.md` is an example grounded
- in a specific subject-mutation incident and a NOT_PROVEN-then-PASS pair.
-
- Knowledge is revisable. Preserve evidence and provenance when retracting an
- unsupported or stale belief; artifact accumulation is not a monotonic increase
- in truth or utility. Negative, null, and contradictory results remain visible.
-
- When the caller selects an OKF page for an observation or maintained reference,
- follow the [pinned page profile](references/okf-page-profile.md) and run
- `ao provenance check-okf --file <concept.md>` before exact-content review.
- The command checks structure only: it cannot establish factual support,
- permission to disclose to the destination, independent review or usefulness,
- and it neither
- admits pages nor promotes rules. This optional representation does not broaden
- Learn's verdict-only input or authorize a new storage destination.
-
- A repeated finding class may support a check proposal only when causal evidence
- identifies a preventable defect and a concrete consumer needs that check. Name
- the exact behavior the check would refuse and why existing checks missed it;
- two sightings alone do not justify a gate. The proposal is advisory text for a
- human or caller to weigh; Learn never edits a gate, registry, or check script,
- and learning never changes a completed verdict or selects another experiment.
-
- Prune for provenance decay: every cited artifact must still resolve — the
- 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.
+ An observation cites evidence and its coverage, names applicability, action,
+ support, limits and invalidation, and survives a counterexample check. A single
+ incident stays narrow; curation may simplify or remove a rule. Saved pages are
+ not benefit: only later work can demonstrate useful reuse.