Work order

A work order (WO) is the contract for one piece of work. If it is not in the WO, it is not in scope.

File location

{{WORK_ORDERS_DIR}}/WO-YYYYMMDD-short-slug.md

Story points (Fibonacci only)

SP	Effort	Use when
1	< 1 hr	Config tweak, copy fix, single field
2	~2 hrs	One file, one function, one test
3	~4 hrs	One feature slice (model + service, or page + hook)
5	~1 day	Full feature (model + service + route + tests, or a full page)
8	~2 days	Cross-module or multi-phase
13	~3–4 days	Epic slice: break it up before starting
21	> 1 week	Too big: decompose; no estimate is valid

Want to write 4, 6 or 7? Round up.

Template

# WO-YYYYMMDD-short-slug

**Status:** draft | ready | in_progress | blocked | in_review | done | cancelled
**Priority:** P0 | P1 | P2 | P3
**Story points:** 1 | 2 | 3 | 5 | 8 | 13 | 21
**Sprint:** YYYY-Wxx | backlog
**Style:** directive | collaborative | delegated | review-gate
**Primary owner:** <role>
**Reviewers:** <optional>
**Modules touched:** <list>
**Created:** YYYY-MM-DD

## Goal
One sentence.

## Background
Why now. Link docs instead of pasting them.

## Acceptance criteria
- [ ] ...
- [ ] All verify commands pass

## Out of scope
- Item — why excluded

## Phases
| Phase | Deliverable | SP | Gate |
|---|---|---|---|
| 1 — name | what ships | n | check command |
| N — Docs + handoff | docs updated | 1 | verify sign-off |

## Touch list
- `path/to/file` — reason

## Dependencies
- WO-… must land first / runs in parallel

## Verify commands
| Module | Command |
|---|---|
| {{MODULE}} | `{{VERIFY_COMMAND}}` |

## Handoff log
_(append entries — see the handoff skill)_

Management styles

Style	Use when
directive	Hotfix; zero ambiguity; exact steps listed
collaborative	Cross-module; tech lead and implementer plan together
delegated	Single module; outcome only; implementer owns the approach
review-gate	UI redesign; cannot close until design review passes

State rules

• Only the primary owner or the manager changes status.
• blocked names the blocker and who must act.
• done needs a verify PASS in the handoff log.
• Never put secrets, tokens or customer data in a WO.

Customize for your project

• {{WORK_ORDERS_DIR}}, {{MODULE}}, {{VERIFY_COMMAND}}.
• Your sprint length and capacity (e.g. 20 SP per person-week).
• Standing out-of-scope items your product never does.