Summary

Triggered on workflow exit. Reads the workflow trace and docs/issues-filed.json. Scans for four signal types: encountered or invented vocabulary term, non-obvious architectural decision (ADR), mistake to avoid (anti-pattern), or reusable solution pattern. Also checks for recurring deferral categories across issues-filed.json. Writes 0–4 entries via substrate-write. If nothing meaningful surfaced, writes zero entries and reports the explicit no-signal decision. On failed-gate traces, writes the rejection reason as an ADR or anti-pattern so the failure becomes a future lesson.

Procedure

Step 1 — Verify the workflow trace exists

Check that docs/harvest/<workflow_id>.md exists.

If the file does not exist, stop immediately and output:

Cannot start harvest: no workflow trace found at docs/harvest/<workflow_id>.md.
The workflow trace must be written before invoking harvest.

Do not proceed.