skillopt-sleep

1# SkillOpt-Sleep: usage-driven self-evolution for a local Codex agent
2 
3SkillOpt-Sleep gives the user's Codex agent a sleep cycle. On demand or on a
4nightly schedule, it reviews past local sessions, re-runs recurring tasks
5through the selected backend, and proposes changes to a configured skill and to
6the project's `CLAUDE.md`. With the default validation gate enabled, it keeps
7only changes that improve a held-out score. Live files change only through
8explicit adoption or a user-requested `--auto-adopt`. There is no model-weight
9training.
10 
11The current shared engine does **not** write `AGENTS.md`. For a Codex-visible
12result, always select a Codex skill explicitly with `--target-skill-path` (for
13example `.agents/skills/<name>/SKILL.md`). If project `CLAUDE.md` is not a
14desired secondary target, set `"evolve_memory": false` in
15`~/.skillopt-sleep/config.json` before running.
16 
17## When to use
18 
19Trigger when the user wants any of:
20 
21- Codex to learn from past sessions or get better the more they use it;
22- a nightly/scheduled or on-demand sleep/dream/offline self-improvement run;
23- to review past sessions and distill recurring tasks;
24- to consolidate feedback into memory or managed skills;
25- to run `status`, `harvest`, `dry-run`, `run`, or `adopt` for SkillOpt-Sleep.
26 
27## The cycle
28 
291. **Harvest** - read local session transcripts according to the engine
30   configuration and normalize them into session digests.
312. **Mine** - turn digests into recurring `TaskRecord`s with outcomes and
32…