evolve

Automate goal-driven development cycles by building, evaluating, and iterating on features.

1|1|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/yuyuxinli/moodcoco --skill evolve-yuyuxinli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolve
Source: https://github.com/yuyuxinli/moodcoco/tree/main/.claude/skills/evolve
Command: npx skills add https://github.com/yuyuxinli/moodcoco --skill evolve-yuyuxinli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Help teams and agents turn an ambiguous goal into an executable program and then autonomously build, evaluate, and iterate on features until the goal's evaluation thresholds are met, reducing manual orchestration and follow-up.

Core Features & Use Cases

  • Goal-driven orchestration: Guide the user through goal definition, automated program generation (program.md), and adapter creation for project-specific runtime steps.
  • Automated build-evaluate loop: Alternate Builder and Critic agents to implement features, run deterministic checks, call independent LLM evaluators, and record structured progress in .evolve/results.tsv.
  • Safety & recovery: Concurrency lock, stop conditions, trajectory analysis, and strict file-write rules (append-only logs, read-only program contracts) to prevent runaway changes.
  • Use Case: Initialize on a repository, generate a testable program spec, create a project adapter, then run continuous /loop 1m /evolve to automatically iterate until acceptance criteria are met.

Quick Start

Start an autonomous improvement run by issuing '/evolve' to initialize and then run '/loop 1m /evolve' to let the agents auto-build and evaluate repeatedly.

Frequently Asked Questions about evolve

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

FAQPage Schema
How do I automate goal-driven software development cycles with build and test evaluation?

To automate build-evaluate loops, initialize with '/evolve' to generate a program spec and adapter, then run '/loop 1m /evolve' to let Builder and Critic agents auto-build, run tests, and iterate until evaluation thresholds are met.

What is an autonomous build-evaluate loop for code projects?

An autonomous build-evaluate loop alternates Builder and Critic agents to implement features, run deterministic checks, and call independent LLM evaluators. It records structured progress in .evolve/results.tsv and iterates until acceptance criteria are met.

Do I need Git and Python to run autonomous agent testing loops?

Yes, you need Git and Python 3.8+ to run autonomous agent testing loops. You also need a project-specific adapter implementing setup, run_checks, and teardown methods, plus an independent evaluator CLI such as codex or claude.

How does an autonomous agent prevent runaway changes during continuous iteration?

Autonomous agents prevent runaway changes using concurrency locks, stop conditions, trajectory analysis, and strict file-write rules like append-only logs and read-only program contracts. This ensures safe recovery and controlled iterations.

Can I use independent LLM evaluators like codex or claude to evaluate code iterations?

Yes, you can use independent LLM evaluator CLIs such as codex or claude to evaluate code iterations. The autonomous loop calls these external evaluators to assess features against goals and record structured progress in .evolve/results.tsv.

What is the best way to turn an ambiguous software goal into an executable program autonomously?

The best way is to initialize with '/evolve' to guide goal definition, generate a testable program.md spec, and create a project adapter. Then run '/loop 1m /evolve' to let agents autonomously build, evaluate, and iterate until acceptance criteria are met.