evolve

evolve is a skill for Claude Code from revfactory/harness. It costs 184 tokens per session (1,769 once invoked), scanned A, original, Apache-2.0.

A workflow for improving an existing setup that guides coding agents. It collects results and feedback, compares the current setup with its starting version, and records useful changes.

In plain words
What is it for?
Use it to review agent runs, find where an agent or workflow went wrong, update the setup, and keep a history of those changes.
Why use it?
It helps turn repeated failures, workarounds, and user feedback into documented improvements instead of fixing the same problem each time.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: reads .claude/ paths; mentions CLAUDE.md.

Part of the harness plugin — 2 skills shipped together

Good fit Use it to review agent runs, find where an agent or workflow went wrong, update the setup, and keep a history of those changes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/revfactory/harness/evolve
About the project

Harness is a Claude Code plugin that creates specialized agent teams and the skills those agents use from a description of a project or domain. It helps users organize complex work into coordinated teams based on predefined team-architecture patterns. The catalogue contains the plugin and skill that implement this team-generation workflow.

revfactory/harness · 9,184 stars · on GitHub · revfactory.github.io

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add revfactory/harness --skill evolve
Clone the repo
git clone --depth 1 https://github.com/revfactory/harness

Made for: Claude Code.

Or install harness, the plugin that ships this one along with the rest of its 2 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for evolve

README.md
[![agentmods](https://agentmods.dev/badge/skills/revfactory/harness/evolve/github.svg)](https://agentmods.dev/skills/revfactory/harness/evolve)
Your own site
<a href="https://agentmods.dev/skills/revfactory/harness/evolve"><img src="https://agentmods.dev/badge/skills/revfactory/harness/evolve/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for evolve

Your own site · 80×15
<a href="https://agentmods.dev/skills/revfactory/harness/evolve"><img src="https://agentmods.dev/badge/skills/revfactory/harness/evolve.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 184 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,769 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00184 $0.01769
Opus 5.5 $0.00074 $0.00708
Sonnet 5.5 $0.00037 $0.00354
Haiku 4.5 $0.00018 $0.00177

Measured 20d ago against content hash c7873546dec0, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

evolve scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 20d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/evolve/SKILL.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Harness Evolve — 하네스 진화 메커니즘

하네스는 고정물이 아니라 진화하는 시스템이다. 이 스킬은 "무엇이 먹혔고 무엇이 안 먹혔는가"의 델타를 포착해 하네스에 되먹여, 다음 실행이 측정 가능하게 더 나아지도록 한다.

초기 하네스 ──▶ 실 프로젝트 사용 ──▶ 현재 하네스
                                        │
                                        ▼ (evolve로 델타 포착)
                                  피드백 일반화 → 에이전트·스킬·오케스트레이터 반영
                                        │
                                        ▼
                                  변경 이력 갱신 → 다음 실행은 더 나은 초안에서 시작

워크플로우

Phase 1: 델타 수집

  1. .claude/agents/, .claude/skills/, CLAUDE.md(변경 이력 테이블)를 읽는다
  2. git 저장소라면 하네스 파일들의 변경 이력을 조회한다 (git log --oneline -- .claude/ CLAUDE.md) — 초기 구성 대비 무엇이 언제 왜 바뀌었는지 파악
  3. _workspace/가 있으면 최근 실행의 중간 산출물을 훑어 실제 실행 흔적을 확인한다:
    • 오케스트레이터가 정의한 경로에 산출물이 실제로 있는가 (없으면 워크플로우가 우회되었거나 죽은 코드)
    • 산출물 품질이 스킬이 명시한 형식/기준을 따르는가
  4. 사용자에게 피드백을 요청한다 (이미 피드백을 제공했다면 생략):
    • "결과에서 개선할 부분이 있나요?"
    • "에이전트 구성이나 워크플로우에 바꾸고 싶은 점이 있나요?"
    • 피드백이 없으면 강요하지 않는다. 단, 아래 관찰 신호가 있으면 선제적으로 개선을 제안한다

관찰 기반 진화 신호 (피드백이 없어도 제안):

  • 같은 유형의 수정 요청이 2회 이상 반복된 흔적
  • 에이전트가 반복적으로 실패/재시도한 패턴
  • 사용자가 오케스트레이터를 우회해 수동으로 작업한 흔적 (오케스트레이터 트리거 실패 의심 → description 확장 후보)
  • 오케스트레이터에 v1 유물(TeamCreate/TeamDelete/실험 플래그)이 남아 있음 → harness 스킬의 마이그레이션 절차 안내

Phase 2: 피드백 유형 분류 및 수정 대상 매핑

피드백 유형 수정 대상 예시
결과물 품질 해당 에이전트의 스킬 "분석이 너무 피상적" → 스킬에 깊이 기준 추가
에이전트 역할 에이전트 정의 .md "보안 검토도 필요" → harness 스킬로 에이전트 추가 안내
워크플로우 순서 오케스트레이터 스킬 "검증을 먼저 해야" → Phase 순서 변경
팀 구성 오케스트레이터 + 에이전트 "이 둘은 합쳐도 될 듯" → 에이전트 병합
트리거 누락 스킬 description "이 표현으로 하면 작동 안 함" → description 확장
실행 모드 부적합 오케스트레이터 "매번 같은 팬아웃인데 느려" → 워크플로우 모드 전환
규모/비용 오케스트레이터 "토큰을 너무 써" → 기본 규모 축소, 버짓 연동 추가

범위 판단: 에이전트 신규 추가/삭제나 아키텍처 재설계가 필요하면 이 스킬에서 직접 하지 않고 harness 스킬(0단계의 기존 구성 확장 절차)로 안내한다. evolve는 기존 구성의 조정에 집중한다.

Phase 3: 일반화 및 반영

  1. 피드백을 일반화한다 — 특정 사례에만 맞는 좁은 수정은 오버피팅이다. "이번 보고서에 서론이 길었다" → "서론은 전체의 10% 이내로"가 아니라, 왜 길어졌는지(스킬에 분량 배분 기준 부재)를 찾아 원리 수준으로 수정한다
  2. Why를 함께 기록한다 — 수정된 지시에는 이유를 병기한다. 이유를 알면 에이전트가 엣지 케이스에서도 올바르게 판단한다
  3. 변경은 한 번에 하나씩 적용하고, 각 변경 직후 Phase 4를 실행한다
  4. 퇴행 방지: 수정이 기존 변경 이력의 이전 수정을 되돌리는 방향이면, 사용자에게 상충을 알리고 확인받는다 (과거에 "너무 길다"로 줄였는데 이번에 "너무 짧다"면 — 둘 다 만족하는 기준을 찾는 것이 정답이다)
  5. 기존 파일의 언어를 유지한다 — 에이전트·스킬·오케스트레이터·CLAUDE.md에 반영하는 문장은 수정 대상 파일에 이미 쓰인 언어로 쓴다. 이 스킬 문서가 한국어라는 이유로 다른 언어로 된 하네스에 한국어 문장을 섞지 않는다

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 20d ago First seen · 90 lines · 184 tokens per session scan A c7873546dec0

Subscribe to this mod's changes

evolve is a skill published in the GitHub repository revfactory/harness (9,184 stars, last pushed 18d ago), licensed Apache-2.0. It adds 184 tokens to every session and 1,769 once invoked, about $0.0007 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-27.

Related

Other skills, from other repositories

release

Release a new version of the mumei repository. Invoke when the user gives an explicit release instruction ("release it", "/release", "patch release", "ship 0.2.0"). Takes no argument or "patch" / "minor" / "major" for a SemVer bump, or a direct version such as "0.2.0". Wraps any uncommitted changes into a single…

iroha924/mumei · 144 tokens

glean

This skill should be used BEFORE any feature design. It runs structured gleaning with the user — asking 5 high-leverage questions per round, up to 3 rounds, to extract Goal / Scope / Constraints / Edges / Done. Output is saved to .mumei/scratch/ .md and used as input for /mumei:compose. Triggers include "I want to add…

iroha924/mumei · 107 tokens

cc-whatsnew

Use when a new Claude Code version is published, when checking the changelog, or when asked "what was added recently?", "what's new in v2.1.x?", or "fetch the official new features". Reports from the official release notes / changelog in two views - an exhaustive feature summary and an applicability verdict for mumei.…

iroha924/mumei · 124 tokens

evaluator-write-qa-parallel

Internal Auto-Harness evaluator skill for parallel sprint QA and QA report writing. Use only inside the Evaluator subagent during evaluatorqaparallel.

redker56/auto-harness · 37 tokens

evaluator-write-qa

Internal Auto-Harness evaluator skill for sprint QA and QA report writing. Use only inside the Evaluator subagent during qa mode.

redker56/auto-harness · 32 tokens

evaluator-write-retest-parallel

Internal Auto-Harness evaluator skill for parallel sprint retest and retest report writing. Use only inside the Evaluator subagent during evaluatorretestparallel.

redker56/auto-harness · 39 tokens