# AGENTS.md

You are building **Workshop Handover Log — Draft** (software). Read `PACKAGE.md` first; it is the complete product definition. Do not widen the scope beyond it.

Frozen specification revision 1 · Needs review. Downloading this archive did not approve it. Resolve every item marked unresolved or awaiting review instead of treating it as verified.

## Order of work

1. Wave 1 — Records and UI (sequential): prd/m1.md, prd/m2.md — After the paper gate, implement and check m1, then m2.
2. Wave 2 — Export (sequential): prd/m3.md — After Wave 1, implement m3 and check the integrated prototype.

## Concurrency

At most 1 builder(s) at once. Serialize edits to: src/store.js, src/app.js, src/export.js.

- One builder at a time.
- Complete Wave 1 before Wave 2.
- Review changes to the record contract before dependent UI or export changes.

## Definition of done

- Paper gate: Determine whether the structured paper checklist yields complete fields and unambiguous owners and next actions. (Proposed supervised paper pilot; agree measures, duration and pass criteria before collecting outcomes.)
- Later value comparison: Determine whether software improves on the validated paper baseline. (After the paper gate and prototype, pre-agree comparable measures and evaluate both processes separately.)
- Persistence and origin: Items survive browser restart and device power cycle at http://localhost:4173. (Proposed manual check on the selected device and browser; record origin and compare stored items before and after.)
- Ordering and receipt: Unresolved items lead; acknowledgement changes receipt metadata only. (Proposed mixed-status UI check and before/after IndexedDB record comparison.)
- Export and network: JSON parses, CSV columns and escaping are correct, and normal use makes no external requests. (Proposed fixture checks and browser network inspection; allow initial loopback asset requests.)

Every story in `prd/` must meet its acceptance criteria before the wave is complete. Ask a human when an open question in `PACKAGE.md` blocks a decision; do not guess.