harness:evolve

Orchestrate propose-evaluate-iterate loops with LangSmith and Git worktrees.

43|5|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/raphaelchristi/harness-evolver --skill harness-evolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness:evolve
Source: https://github.com/raphaelchristi/harness-evolver/tree/main/skills/evolve
Command: npx skills add https://github.com/raphaelchristi/harness-evolver --skill harness-evolve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end agent optimization by orchestrating propose-evaluate-iterate loops with LangSmith as the evaluation backend and Git worktrees for isolation.

Core Features & Use Cases

  • Orchestrates multi-stage iterations (propose, evaluate, merge) for evolving agent performance.
  • Supports configurable modes (light, balanced, heavy), interactive prompts, baseline scoring, and automated evaluation workflows.
  • Ideal for teams building adaptive agents and optimizing tool use, prompts, and architecture across experiments.

Quick Start

Run harness:setup to generate the required configuration and then run harness:evolve to start iterations.

Frequently Asked Questions about harness:evolve

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

FAQPage Schema
How do I automate agent optimization with iterative evaluation loops?

Agent optimization is automated by orchestrating propose-evaluate-iterate loops that use LangSmith for evaluation and Git worktrees for isolation. This structured iteration enables teams to systematically evolve agent performance across experiments.

What is the best way to structure iterations when evolving agent performance?

Evolving agent performance is structured through configurable modes like light, balanced, or heavy iterations. These modes coordinate multi-stage propose, evaluate, and merge cycles with baseline scoring and traceability for artifact management.

Does automated agent evaluation work with Git worktrees for experiment isolation?

Yes, automated agent evaluation works with Git worktrees to provide isolation during iteration loops. This ensures that each proposed change is evaluated independently without interfering with the main codebase or parallel experiments.

How do I set up the configuration required to start evolving agents?

To start evolving agents, run the setup harness to generate the required .evolver.json configuration file. This enforces the necessary environment setup and provides parameters for iterations, interactive prompts, and preflight checks.

Can I run preflight checks and baseline scoring before starting agent iterations?

Yes, you can run preflight checks and baseline scoring before starting automated agent iterations. The workflow validates the environment and establishes baseline metrics to measure subsequent performance improvements accurately.

What are the limitations of using automated iteration loops for agent optimization?

Automated agent iteration loops require a .evolver.json configuration file and LangSmith evaluation backend integration. Teams must manage Git worktree artifacts and coordinate multi-stage cycles, which may increase infrastructure complexity at scale.