name: harvest description: 'Promote .agents knowledge.' skill_api_version: 1 user-invocable: true context: window: fork intent: mode: task metadata: tier: knowledge dependencies: [] output_contract: ".agents/learnings/*.md (consolidated)"
Harvest — Cross-Rig Knowledge Consolidation
Nightly usage (2026-04-09):
/dream startnow runs harvest as part of its bounded compounding loop. Use/harvestfor manual sweeps, CI runs, or when Dream is disabled. Dream holds.agents/overnight/run.lockwhile running — manualao harvestwill refuse until the lock releases.
Sweep all .agents/ directories across the workspace, extract learnings, patterns,
and research, deduplicate cross-rig, and promote high-value items to the global
knowledge hub (~/.agents/learnings/).
Naming gotcha.
$harvestpromotes into~/.agents/learnings/, not~/.agents/. Users often say "harvest all to~/.agents" and mean the promotion hub. If you really want every raw artifact (not just the promotion set) mirrored verbatim, you wantrsync, not$harvest.
Which skill do I need?
See docs/skills-decision-tree.md for the full "which skill next?" decision table covering harvest, compile, dream, knowledge-activation, and quickstart.
What This Skill Does
The knowledge flywheel captures learnings per-rig, but they stay siloed. Harvest
closes the loop by walking all rigs, extracting artifacts, deduplicating by content
hash, and promoting high-confidence items to the global hub where every rig can
access them via ao inject.
When to use: Before an evolve cycle, after a burst of development across multiple rigs, or weekly as part of knowledge governance.
Output: .agents/harvest/latest.json (catalog) + promoted files in ~/.agents/learnings/
Execution Steps
Step 1: Preview Scope (Dry Run)
ao harvest --dry-run --quiet
Read .agents/harvest/latest.json and report:
- Rigs discovered
- Total artifacts extracted
- Unique vs duplicate count
- Promotion candidates (artifacts >= min confidence)
Step 2: Confirm Execution
Skip if --auto is set. Otherwise, show the dry-run summary and ask:
Harvest will promote N artifacts from M rigs to ~/.agents/learnings/.
Proceed? [Approve / Adjust threshold / Abort]
Step 3: Execute Harvest
ao harvest --roots ~/gt/ --promote-to ~/.agents/learnings --min-confidence 0.5
Step 4: Post-Harvest Cleanup
Run dedup on the promotion target to clean up any remaining duplicates:
ao dedup --merge ~/.agents/learnings/ 2>/dev/null || true
Step 5: Report Results
Report to user:
- Rigs scanned
- Artifacts extracted and unique count
- Duplicates found (with top duplicate groups)
- Artifacts promoted (with provenance)
- Top discoveries (highest-confidence cross-rig patterns)
Flags
| Flag | Default | Description |
|---|---|---|
--auto | off | Skip confirmation gate |
--roots | ~/gt/ | Override root directories to scan |
--min-confidence | 0.5 | Minimum confidence for promotion |
--include | learnings,patterns,research | Artifact types to extract |
Quick Start
/harvest # Full sweep with confirmation
/harvest --auto # Hands-free sweep
/harvest --min-confidence 0.7 # Only promote high-confidence items
/harvest --roots ~/gt/,~/projects/ # Scan additional directories
Governance
See references/governance.md for ongoing governance model: size budgets, sweep frequency, staleness thresholds, and cross-rig synthesis triggers.
See Also
- skills/compile/SKILL.md — Single-rig Mine/Grow/Defrag
- skills/flywheel/SKILL.md — Flywheel health monitoring
- skills/inject/SKILL.md — Knowledge injection into sessions
- skills/forge/SKILL.md — Transcript knowledge extraction
Reference Documents
- references/governance.md — Governance model for ongoing knowledge consolidation