evolvelisted
Install: claude install-skill ichabodcognate315/recursive-improve
# /evolve — Evolutionary Agent Improvement
Parallel improvement search. Multiple islands (git worktrees) explore different
improvement strategies independently. After each generation, the best island's
ideas cross-pollinate to others.
---
## Step 1: Configure (MANDATORY — do not skip)
### If `program.md` exists
Read it. If no `## Evolution` section, add defaults:
```markdown
## Evolution
- n_islands: 4
- n_generations: 10
```
Present to user and confirm. Update `program.md` with any changes.
### If `program.md` does not exist
Follow the same flow as `/ratchet` Step 1, plus ask for evolution params.
**Do NOT proceed until the user confirms.**
---
## Step 2: Initialize
```bash
recursive-improve evolve init --config program.md
```
Parse JSON output. Note `session_id`, `base_ref`, and island paths.
Store the **repo root** as an absolute path — you'll need it for config paths.
---
## Step 3: Evolution Loop
Track `generation` starting at 1.
### 3a. Improve each island
For each island 0 to N-1:
1. **cd into the island's worktree:**
```bash
cd .ri-islands/island-{id}
```
2. **Cross-pollination (generation > 1 only):**
**Diversity island:** If `island_id == generation % n_islands`, skip
cross-pollination entirely. Improve independently to preserve diversity.
**All other islands:** Read ALL other islands' diffs with their scores:
```bash
# For each other island i (skip your own):
echo "=== Island {i} (score: {score_i}) ==="
git -C {r