session-learn

Session Learn

<skill_contract> Completed session objective, actions, artifacts, verification receipts, errors, decisions, and destination paths. Deduplicated durable deltas for concepts, entities, corrections, patterns, ideas, decisions, and gaps. Each retained delta is formatted, linked, logged, provenance-preserving, and paired with a traceable next action when unresolved. <non_goals>Automatic-capture claims without a hook, raw transcript storage, conversational filler, or immutable-source edits.</non_goals>

Close a session by extracting only reusable deltas. Invocation must be explicit or performed by a verified external hook; this skill never claims it ran automatically.

Usage Template

Provide: session objective, actions, outputs, verification receipts, errors, decisions, and destination paths. Optional: existing notes for deduplication.

Workflow

Establish the session boundary and compare intended versus observed result. Ignore conversational filler and separate execution evidence from retrospective interpretation.

<unknowns_gate>

If the session outcome or evidence is unavailable, return INSUFFICIENT_EVIDENCE. Ask for a missing artifact only when it determines whether a lesson is valid; otherwise preserve it as an unresolved gap.

</unknowns_gate>

Scan for seven signal types:

1. Concept — a stable mechanism worth linking.
2. Entity — a person, system, project, or tool requiring durable context.
3. Correction — a prior belief or procedure disproved by evidence.
4. Pattern — a reusable Trigger -> Execute -> Verify -> State sequence.
5. Idea — an untested possibility, explicitly provisional.
6. Decision — choice, rationale, alternatives, owner, and review condition.
7. Gap — an unknown with a probe or escalation path.

Apply Closure Protocol: Format the smallest durable note, Link it to source/project/concepts, and Log the write plus verification. Merge semantic duplicates; preserve source immutability and provenance.