evolve

Coordinate evolutionary code optimization across isolated branches into a final pull request.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/kyleyhw/agent-evolve --skill evolve-kyleyhw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolve
Source: https://github.com/kyleyhw/agent-evolve/tree/main/.claude/skills/evolve
Command: npx skills add https://github.com/kyleyhw/agent-evolve --skill evolve-kyleyhw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates automated evolutionary optimization of a code target, enabling teams to discover and implement improvements by running a supervisor/explorer/reviewer loop on isolated branches and opening a final pull request to main without merging.

Core Features & Use Cases

  • Orchestrates the three-role evolution loop (supervisor, explorer, reviewer) on isolated evolve/<problem>/candidate-<n> branches.
  • Supports module-scoped runs, runtime-mode equivalence testing, and visual evolution graphs across local and cloud backends.
  • Enforces safety and governance: candidates never merge into main; scope-based pruning; final PR remains open for human review.

Quick Start

Provide a natural-language goal or an agent-evolve manifest path to start the evolution with /evolve.

Frequently Asked Questions about evolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code optimization to generate a pull request?

Automated code optimization generates a pull request by running an evolutionary supervisor, explorer, and reviewer loop on isolated candidate branches, finalizing improvements without merging into main. You provide a natural-language goal or manifest path to start the process.

What is evolutionary code optimization and how does the supervisor loop work?

Evolutionary code optimization iteratively improves a code target through a multi-phase lifecycle: problem specification, baseline measurement, scoring, and reviewer gating. A supervisor orchestrates explorer agents to generate candidates and a reviewer gates their approval on isolated branches.

How do I start an evolutionary optimization run on isolated branches?

Start an evolutionary optimization run by providing a natural-language goal or an agent-evolve manifest path. The orchestration creates isolated evolve branches to test candidates, measures baselines, scores results, and opens a final PR for human review.

Can I run automated code evolution on cloud backends and scope it to specific modules?

Automated code evolution supports both local and cloud backends for execution. You can restrict runs to specific module scopes, apply runtime-mode equivalence testing, and visualize the process using evolution graphs.

Are there safety boundaries to prevent automated evolutionary optimization from merging into main?

Safety boundaries in evolutionary optimization enforce scope-based pruning and ensure candidate branches never merge into main. The process finalizes by opening a pull request that remains open for mandatory human review before any integration.

What is the best way to orchestrate code improvements without risking the main branch?

The best way to orchestrate code improvements without risking the main branch is using an evolutionary loop on isolated candidate branches. This approach applies scope rules and reviewer gating to finalize a safe, human-reviewed pull request.