apply-agent-evolution

name	apply-agent-evolution
description	Apply phase of an agent evolution — diff the winner workspace against the live repo, get explicit user confirmation, copy files in, optionally re-run gates against the live tree. Writes `applied`. Requires `winner` set by `/run-agent-evolution`.
metadata	{"author":"fmind","url":"https://github.com/fmind/agent-evolutions/tree/main/skills/apply-agent-evolution"}

apply-agent-evolution

Land the winner of <id-or-slug> into the live repo. Read-only until the user confirms.

0. Dispatch

Resolve the argument:

• Pure integer → match the leading <id> under .agents/evolutions/<id>-*/.
• String → match a slug fragment; on multi-match pick the lowest <id> and note in chat.

Read evolution.yaml (validated against evolution.schema.json). Branch:

• Directory missing → "No evolution found for <arg>. Run /new-agent-evolution <title> to capture one." Stop.
• applied already set → terminal. "Evolution <id> already applied (winner: <variant_id>)." Stop.
• winner not set → "No winner picked yet. Run /run-agent-evolution <id> first." Stop.

1. Pre-flight

Confirm winner.variant_id references a variant with status: evaluated and every gate passing — otherwise stop. Confirm git status --porcelain is clean over scope.include paths; on overlap, list conflicts and stop (commit, stash, or revert first).

2. Compute the diff

Branch on scope.kind:

• worktree — git -C <workspace> diff --no-index --stat HEAD <live> if the workspace shares git history; otherwise plain diff -r. Restrict to scope.include, exclude scope.exclude.
• files — for each scope.include path, diff workspace copy against live file. Treat missing-on-one-side as add/delete.

Surface git diff --stat summary plus per-file diff body. If > 400 lines combined, show the stat and offer the full diff on request.

Reject paths under scope.exclude — list offenders and stop.

3. Confirm and apply

Wait for explicit confirmation ("looks good", "apply", "go"). On abort, leave the evolution as-is.

Copy each changed file (create parent dirs); rm deleted ones. Don't run formatters — gates already enforced quality. Capture git status --porcelain; write to evolution.yaml:

applied:
  at: "<now>"
  files_changed: [...]

Bump updated_at. Refresh §TL;DR in EVOLUTION.md (Applied, files changed).

4. Verify (recommended)

Run each gates[].cmd against the live repo. Report results in chat (not persisted). If any fail, name the gates and the relevant output. The user investigates.

Variant workspaces stay as audit trail — the user removes them with git worktree remove (kind: worktree) or rm -rf (kind: files) when ready.

5. Hand off

End with one sentence: files changed, gate re-verification result, next pointer (commit and PR).

Invariants. Writes happen only after explicit confirmation; the diff displayed equals the diff applied; applied.files_changed is exactly the set of paths whose live content changed.