SuperAPI AI Directory

harvest

General & other

View repository

Updated 10-15 20:34

About this skill

Harvest

The routed entry point for the end-of-unit harvest — the sweep of what the unit produced, learned, and left open into their durable sinks. The procedure, the three legs, and the sink table are owned by lib:reference/harvest.md; consult it and follow it. Do not re-derive the routing here — point there.

During execution, working notes belong in the active runtime phase sheet (state/.../phases/phase-NN.md) — disposable working context. The harvest is the wrap-up sweep that moves what matters into durable homes; the slice's notes.md (doctrine slice notes <ID> scaffolds it on demand) carries the durable prose. Honour the storage rule: live progress lives in the state tree, never in authored files.

If you don't know which slice owns the work, find it with doctrine slice list. No governing slice (an RFC, spec, or review close)? The harvest still happens — the legs route to their sinks per lib:reference/harvest.md §5; there is just no ## Harvest manifest to maintain.

The three legs

  • produced — the work delta. Be concise, but record:
    • what's done
    • any:
      • surprises encountered or adaptations required
      • potential rough edges, omissions, or refactorings for later
      • follow-up actions advisable
      • open questions relating to completed or upcoming work
      • durable facts, patterns, or gotchas that should become a memory
      • relevant commit hash(es), or: uncommitted work
      • whether .doctrine changes were committed promptly per repo doctrine, or are still pending and why
      • if committed, whether they went out with code or separately when that matters for the next agent
    • whether the verification gate (doctrine check gate) has run successfully since code was last modified, or: outstanding errors
  • learned — reusable guidance and citable epistemic observations, routed to their sinks per lib:reference/harvest.md.
  • open — the decisions, questions, assumptions, and constraints the unit carries forward. This is the leg a produced-only sweep silently drops: route it via /knowledge (→ DEC / QUE / ASM / CON).

Each leg's sink is owned by lib:reference/harvest.md's §2 table — cite it, don't restate it.

## Harvest maintenance

Update the ## Harvest section per lib:reference/harvest.md § Canonical output.