# HARVEST — <feature, reader-facing name> {#root}

@status:spec/done

- [p01] @fact:CARD-ONE-PROMISE One card = one promise worth telling a reader about. @status:spec/done
- @fact:CARD-WRITTEN-HOT Written in the minute the knowledge is hot (verification or fix just
  done); polished later, in the documentation stage — never now. @status:spec/done

- [p02] @fact:FIELD-UNIT **Unit:** `spec://…#anchor` @status:spec/done
- @fact:FIELD-AUDIENCE **Audience:** user | author (CSV allowed) @status:spec/done
- @fact:FIELD-PROMISE **Promise (reader's register, one sentence):** what the reader can do,
  not what the system must. E.g. "You can pin a dependency to a local
  checkout with one manifest line." @status:spec/done
- @fact:FIELD-PROVEN-EXAMPLE **Proven example:** command + real output, captured from the verification
  run (this is the doc fixture — it was actually executed): @status:spec/done

[p03]
```
  $ vibe <…>
  <real output>
```

- [p04] @fact:FIELD-GOTCHAS **Gotchas / edge cases:** what surprised us; what the reader will trip on. @status:spec/done
- @fact:FIELD-STABILITY **Stability:** freeze-candidate | still-moving (`still-moving` cards wait;
  a chapter is written only from stable cards). @status:spec/done
- @fact:FIELD-VERDICT-REF **Source verdict ref:** <cache/baseline pointer> @status:spec/done