director

Evolving Agents — the director

The director remembers how your team works — and makes every agent session work that way.

Your decisions, conventions and hard-won methods become a small memory of linked rules. Before an agent plans, the director finds the rules that apply and puts them in front of it. Private work goes only to machines you have cleared. When you correct it, it drafts a lesson that you accept or reject. It runs inside Claude Code today.

Contents — What it does · Who it is for · What to expect · Get started · What comes next · How it works, and what we measured · Earlier work

What it does

Who it is for

• Teams that work with coding agents and keep a CLAUDE.md, an AGENTS.md or Claude Code's memory that the agent still forgets under pressure.
• Any work that runs on house conventions — how a lab defines a measurement, a firm's review checklist, a team's release rules — where two good answers that follow different conventions are still a disagreement.
• People with confidential material who want a strong model to plan the work while the files themselves are processed only on machines they control.

What to expect

The director does not make a strong model smarter. With today's best models, an agent already follows general good practice on its own — we measured that, and say so. Where the director pays is what the model cannot know: your team's own decisions and conventions, your privacy rules, the methods you learned the hard way, and a record of every lesson that you can audit. Every claim on this page has a measurement behind it, including the ones that came back flat: how it works, and what we measured.

Get started

Inside Claude Code:

/plugin install director --marketplace EvolvingAgentsLabs/evolving-agents
/director:compile        # your CLAUDE.md, AGENTS.md and memory → linked rules (asks first; ~US$5 for ~60 files)
/director:reflect        # after a task: your correction becomes a proposed lesson, kept only on your yes

From the next session on, every plan walks your memory and cites what it follows. A band above the prompt shows each proposed lesson with Diff, Accept and Reject, and each delegated task until its result is back. The memory stays on your machine as plain Markdown. Requirements, the two-lane local interface, running without a person present, and costs: packages/director/.

What comes next

Three questions, in order, each judged by a measurement named before it runs (ROADMAP.md): does an agent get better from one session to the next on the work you repeat, without the memory ever making it worse (director-bench); can the director improve its own components, not only its memory — the promise of the name Evolving Agents; and can the same memory run on other agent platforms (Anthropic's Managed Agents, Google's Antigravity agent).

Built with, from the same lab: lora-kernel — small specialist models that run on your own machine · agentvcs — every lesson the director keeps is a versioned change you can compare and undo · gene-evidence — reports in which every sentence cites its evidence. All projects: evolvingagentslabs.github.io.

Earlier work in this repository

What the 2025 toolkit taught us — three flat results

EAT was not a product that failed; it was an architecture written down and never pinned to anything that could contradict it. 10,165 of its lines were deleted where the Agent SDK does the same better — docs/WHAT-WAS-DELETED.md lists each one and what replaced it. Rebuilt and measured since:

• The dual-embedding resolver does not help. EAT indexed every component twice — what it is, and what it is for. 80% acc@1 either way; the second axis is distinct (cosine = 0.753) and buys nothing on a modern encoder.
• Retrieving past experience buys nothing on the task. The premise of SmartMemory and ContextBuilderTool, measured three times: −4, +0 (p = 1.0000) and −6 against retrievers up to an oracle. What did move was a compact statement of a rule induced from the same trajectories: +21 over the oracle — which is what the director's memory is made of.
• The memory hierarchy loses to lexical search. Four levels, as EAT's smart memory argued: exact search 3/3 at every corpus size, hierarchical navigation 1–2/3.

It was right about where to look and wrong about what would be there. That is why it is in legacy/, not deleted.

Breaking change: pip install no longer installs evolving_agents

This is a monorepo now; install what you want by name. The 2025 package sits at legacy/eat/ with its original setup.py, unchanged. agentvcs was never published to PyPI; the frozen copy installs from source:

pip install "git+https://github.com/EvolvingAgentsLabs/evolving-agents#subdirectory=packages/agentvcs"

The maintained agentvcs is EvolvingAgentsLabs/agentvcs.

By Matias Molinas and Ismael Faro · Apache 2.0