Per-task workflow
Full canonical version lives in _docs/WORKFLOW.md; the shape is:
- Pick the next unblocked task.
- Read the chunk's "Done when:" criteria in the milestone doc.
- Mark in_progress (one task at a time).
- Implement the smallest change that satisfies the contract.
- Test — unit / snapshot / integration / property as appropriate.
- CHECK —
just gatemust be green before close. - UPDATE — append to
PROGRESS.md; file new issues inISSUES.md. - Mark completed and confirm next task is unblocked.
- Commit at natural boundaries (typically one chunk = one commit).
If the chunk is renderable, also:
- Add a story to the appropriate storybook (
wisp-storybookorui-storybook). - Run
just snapshotsto regenerate the asset under_docs/book/src/assets/<crate>/<id>.{png,html}. - Reference the asset from the chunk's mdBook page.
If the chunk introduces public API:
- Add
///doc to every new public item (missing_docsenforces it). - Update the crate's
//!header if the architecture changed. - At least one
# Examplesdoctest on each new public function.