From 508b964c5d2438ac6d7a279eae35a8ee8e8d5d2f Mon Sep 17 00:00:00 2001 From: Eduardo Chiarotti Date: Mon, 10 Aug 2026 11:29:38 -0300 Subject: [PATCH] docs: document evolve CLI in README --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 54036c8..cdbb65d 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,11 @@ Everything below is **deterministic software around the model** (OpenRouter toda | **Runtime graph** | Done | `AgentFactory`, `spawn_agent`, depth/child budgets, async `execute_many` | [`orchestration/`](src/ai_agent/orchestration/) · [`harness/registry.py`](src/ai_agent/harness/registry.py) | | **Self-Evolving Engineer** | Done | `evolve` → plan/patch/checks → scoped commit → push → PR (optional `--approve` HITL) | [`features/evolve`](src/ai_agent/features/evolve/) · [`config/agents/engineer.yaml`](config/agents/engineer.yaml) | - Evolve artifacts live under `.ai_agent/evolve//`. + +### Evolve CLI + +Run the engineer workflow with `uv run evolve`: it surveys the repository, plans and applies one scoped change, runs checks, then commits and opens a pull request. Add `--approve` to enable human approval for publishing; each run records its plan and result under `.ai_agent/evolve//`. + | **HarnessBank Gene Bank** | Done (v1) | `(where)×(why)` cells + gated screening stubs; evolver ≠ task agent | [`features/harness_bank`](src/ai_agent/features/harness_bank/) | | **Organism worker (Phase 2)** | Done | Goal queue + backlog → `run_evolve` on wake → opt-in `--auto-merge` + CI + STOP | [`features/evolve/organism.py`](src/ai_agent/features/evolve/organism.py) · [`config/evolve_backlog.yaml`](config/evolve_backlog.yaml) | | **Ops metrics** | Done (log) | JSONL `OpsEvent`, replay/compare hooks | [`harness/ops_metrics.py`](src/ai_agent/harness/ops_metrics.py) |