mcpField
H
harvest

harvest

github.com/huytieuAgent workflows1.3k116 installsUpdated 6d ago
Repository

About harvest

harvest is a session-learning capture skill for recording corrections, stable facts, process lessons, and skill gaps. It stages findings and requires approval before promoting them into durable knowledge files.

Key features

  1. 01Collect session corrections and facts
  2. 02Record process lessons and skill gaps
  3. 03Deduplicate against existing notes
  4. 04Curate staged entries for approval
  5. 05Update knowledge index after promotion

Use cases

  1. 01Capture project decisions at session end
  2. 02Review staged notes before saving durable knowledge
  3. 03Turn recurring lessons into skill or rule patches

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/huytieu/cog-second-brain --skill harvest

After installing, type/harvestin Claude Code to confirm it loaded.

Details

From the project 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:

## <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)

If you want harvest to run unattended, schedule a job that invokes the skills in this order. There is nothing to install first, since COG ships no hooks.

/memory-hygiene
/harvest promote     # only if the staging file is non-empty
/content-factory     # only if scheduled

Comments

Markdown supported