---
name: Harvest
slug: harvest
category: AI Engineering
description: Harvest captures session corrections, stable facts, process lessons, and skill gaps for later human review. Use it at the end of a session or from a staging hook when you want to propose durable knowledge without writing it automatically.
github: "https://github.com/huytieu/COG-second-brain/tree/main/skills/harvest"
language: HTML
stars: 930
forks: 110
install: "npx degit https://github.com/huytieu/COG-second-brain/tree/main/skills/harvest ~/.claude/skills/harvest"
installs_to: ~/.claude/skills/harvest
source_path: skills/harvest/SKILL.md
collection_size: 25
category_size: 2451
collection_url: "https://dirskills.com/collections/huytieu/COG-second-brain"
added: 2026-08-22T05:20:35.787Z
last_synced: 2026-08-22T05:20:35.787Z
canonical_url: "https://dirskills.com/skills/harvest"
---

# Harvest

Harvest captures session corrections, stable facts, process lessons, and skill gaps for later human review. Use it at the end of a session or from a staging hook when you want to propose durable knowledge without writing it automatically.

**Install:**

```bash
npx degit https://github.com/huytieu/COG-second-brain/tree/main/skills/harvest ~/.claude/skills/harvest
```

## README

# /harvest — session learning capture

Adapted from dwarves-kit `harvest` hook + vault lizard pipeline. Prevents tacit knowledge dying in the transcript.

## Triggers

- `/harvest` — manual end-of-session
- `/harvest promote` — curate staging → lizard drafts (uses harvest-curator)
- Staging file written by `stop` hook (`.cursor/hooks/harvest-stager.sh`)

## Phase 1 — Collect (automatic or manual)

Scan the current session for:

1. **Corrections you made** ("no, actually X", rejected deliverables)
2. **New stable facts** (IDs, URLs, decisions) not yet in 05-knowledge
3. **Process lessons** (what worked, what failed, friction)
4. **Skill gaps** (something that should be a Verify step or CLAUDE.md rule)

Append to `04-projects/harness/harvest/staging-<YYYY-MM-DD>.md`:

```markdown
## <HH:MM> — <trigger>
- type: correction|fact|process|skill-gap
- source: <file or "session">
- text: <one paragraph max>
- proposed_home: <path or "new lizard note">
```

Dedup: skip if same fact already in staging today or in 05-knowledge.

## Phase 2 — Curate (`/harvest promote`)

Spawn `harvest-curator` (Sonnet). It writes `/tmp/harvest-curate-<date>.md`.

Lead (Opus) presents to the user:

- **Promote** list → approve which become `05-knowledge/lizard/YYYY-MM-DD-<slug>.md`
- **Fold** list → approve inline edits to existing notes
- **Skill patches** → approve CLAUDE.md / SKILL.md diffs

Only after approval: write durable files. Update `05-knowledge/lizard/index.md`.

## Phase 3 — Retro line

One line to `01-daily/journal/<today>.md`:

```
Harvest: <n> staged, <m> promoted, <k> folded
```

## Rules

- Harvest is **advisory**. It never auto-writes 05-knowledge.
- Contradictions with existing knowledge → flag both, ask the user.
- Pair with `/memory-hygiene` monthly for environment-dependent facts in `~/.claude/.../memory/`.

## Nightly enhance (optional launchd)

```bash
# 04-projects/harness/scripts/nightly-enhance.sh
bash .claude/lib/install-harness.sh --check  # hooks alive
# /memory-hygiene (skill)
# /harvest promote if staging non-empty
# content-factory if scheduled
```