skill-distillation

Skill Distillation — Turn Repeated Wins Into Reusable Instincts

Law 7 says learn from every session. The friction harvester already learns from failures. This skill learns from the other side: when the same tool sequence keeps ending in a passing verification, that is a recipe worth keeping — not a coincidence to forget.

When to Activate

• At end of session, after a successful multi-step task — check whether the pattern is worth keeping.
• When you notice you have solved a similar problem the same way more than once.
• During a retrospective, to mine the observation log for patterns that have proven themselves.

Core Concept

Distillation walks the observation log, groups it into contiguous trajectories (split on session change or a long time gap), and keeps only the trajectories that ended in success:

verify-exit-0   — a Bash test/build/verify command with a non-failing output
reflection-pass — an observation containing "verified" / "phase 4" / "verify:all green"

It then mines the tool-name sequences of successful trajectories for n-grams (length 3–5) that recurred across multiple distinct sessions. A pattern repeated only within a single session is rejected — that is repetition, not a reusable skill.

The Promotion Ladder

Drafts never affect behavior until you promote them. Three explicit steps, no auto-promotion:

1. ci_distill_candidates           — list patterns that qualify (read-only)
2. ci_distill_propose id=<id>      — write a DRAFT to ~/.claude/instincts/<hash>/drafts/
                                      (placeholder body — you fill in the real recipe)
3. <edit the draft body by hand>   — the tool sequence is evidence, not a recipe
4. ci_distill_promote id=<id>      — promote to a live instinct at 0.5 confidence (SUGGEST)

The draft starts at 0.4 confidence and lives in a drafts/ subdirectory that the instinct loader ignores. Only ci_distill_promote writes a live instinct, at 0.5 (SUGGEST tier) — it suggests, it does not auto-apply, until the normal reinforcement loop earns it more confidence.