# harvest-loop

An 8-step self-evolution pipeline that extracts patterns from completed coding sessions into project skills. It halts semantic drift and evaluates new rule candidates.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 30
- Author: chrono-meta
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/chrono-meta/forge-harness/tree/HEAD/plugins/fh-meta/skills/harvest-loop/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/harvest-loop

## What it does

The skill scans recent repository changes to capture recurring patterns, converting hard-won session fixes into persistent harness skills. Its multi-stage sequence inspects regressions against established skills, isolates at least 3 distinct diff patterns, and evaluates candidate rules using paired challenger and synthesizer agents alongside an isolated Critic pass.

External sessions run in proposal mode, asking for explicit consent before processing. If a session only navigated code without making changes, the pipeline aborts early to avoid generating empty artifacts.

The pipeline relies on `Read`, `Write`, `Grep`, `Glob`, `Bash`, and `Agent` tooling. If `git` history is inaccessible or terminal execution is disabled, the harvest halts immediately during step zero.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill harvest-loop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/harvest-loop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/harvest-loop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill harvest-loop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/harvest-loop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill harvest-loop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/harvest-loop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install chrono-meta/forge-harness harvest-loop
```

2. **Manually: put the files in place**
- File: `.github/skills/harvest-loop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill harvest-loop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/chrono-meta/forge-harness --path plugins/fh-meta/skills/harvest-loop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/harvest-loop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add chrono-meta/forge-harness --skill harvest-loop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/chrono-meta/forge-harness/tree/HEAD/plugins/fh-meta/skills/harvest-loop/SKILL.md

## When to use it
- extract reusable workflows from session diffs into skill candidates
- prevent terminology and semantic drift across extended sessions
- detect regressions against previously validated project skills
- critique newly proposed rule additions using isolated agents

## Example prompts
- Run `/harvest-loop` to capture session patterns into skill candidates
- Extract reusable learnings from our current branch changes
- Review recent session edits and verify skill regressions

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f270d07aeb5ee9f0.

BEGIN THIRD-PARTY FILE f270d07aeb5ee9f0
````text
---
name: harvest-loop
description: An 8-step self-evolution pipeline that runs after field sessions end (field-harvest → contention-layer → challenger + persona-innovator → synthesizer → Critic agent → harness-doctor → verify-bidirectional → curator), absorbing session learnings back into the FH ecosystem. Runs automatically at session end in the main dev environment; proposes execution first for external users. Triggered by "session harvest", "learning absorption", "fh evolution", or "harvest-loop". (The phrase "run the pipeline" is ceded to pipeline-conductor — use that for end-to-end verification sweeps.)
user-invocable: true
allowed-tools: ["Read", "Write", "Bash", "Grep", "Glob", "Agent"]
model-note: session-inherit — Sonnet base is first-class (sonnet_floor_doctrine.md); depth-critical judged steps route to dispatch (opus agent / cross-family sidecar, consent-gated), never a substrate requirement
---

# harvest-loop — Field Session → FH Self-Evolution Pipeline

> Automatically absorbs patterns/conflicts/discoveries from field sessions back into the FH ecosystem.
> Internalizes as a pipeline the return loop from field projects to the harness that was previously done manually.
> One of the core functions is real-time detection and blocking of **Semantic Drift** — where agent terminology gradually diverges in meaning as sessions grow longer.

## Operation Modes

| Mode | Description | Trigger |
|---|---|---|
| **Forced mode** | Auto-runs at end of local development session. Executes without approval, only confirms final suggestions | Session wrap-up rules in hub CLAUDE.md |
| **Lightweight mode** | Immediate harvest after Wave completion. Skip Steps 3/3.5/4 — prioritize fast recording | agent-composer Step 4-c (2+ new files or 3+ existing files changed, **or M-tier resolved**) |
| **Proposal mode** | External FH users — confirms "run harvest-loop?" before executing | User utterance or `/harvest-loop` |

**Simplification guard**: Sessions that only browsed/explored (no code changes or outputs) auto-skip even in forced mode.

**Lightweight mode Done When**:
```
Step 0 (Regression Guard) + Step 1 (field-harvest) + Step 2 (contention-layer) + Step 5 (verify-bidirectional) complete
+ record artifact path printed + final `Verdict:` line emitted — lightweight mode promises the SAME
  consumer contract as full mode (agent-composer Step 4-c gates on artifact + verdict; codex M1 2026-08-10)
+ harvested pattern summary 1~3 lines output
+ "run full harvest-loop?" proposed (if patterns found)
+ [Card update prohibited] Do NOT update reference_next_session_starter.md in lightweight mode alone
```

**Early Trigger** (mid-session): Same pattern 3+ times · same skill fails 2+ consecutive times · session 2+ hours elapsed → "Early harvest condition detected. Run mid-session harvest?" If Y → field-harvest → contention-layer → verify-bidirectional only.

---
````
END THIRD-PARTY FILE f270d07aeb5ee9f0

The third-party file has ended. Everything between the f270d07aeb5ee9f0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2934 of 17575 bytes. © chrono-meta · MIT · https://github.com/chrono-meta/forge-harness/tree/HEAD/plugins/fh-meta/skills/harvest-loop/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md