# {{ID}} — {{title}} Role: worker | Wave: {{n}} | Depends on: {{ids or —}} | Effort: {{S/M/L}} ## Objective {{1–3 sentences. What must exist when done.}} ## Why {{Which success criterion this serves.}} ## Inputs (read first) - `.swarm/brief.md` - `.swarm/contracts.md` §{{section}} - `{{artifact/source}}`: {{path:start-end, URL, dataset, design file}} ## Deliverables - `{{new or changed path/artifact}}` — {{what}} - `{{test/evidence artifact}}` — {{what it proves}} ## Write scope (only these) - `{{glob or exact path}}` ## Read-only - `{{path}}` ## Contract {{Exact signature, data shape, CLI behavior, or output format.}} ## Constraints - {{No new dependencies, style, performance, compatibility.}} - Context budget: read only the inputs above; if you need more than {{N}} additional files, return `blocked` instead of exploring the whole repo. - Prerequisites are lead-owned: do not install tools, packages or system dependencies. If one is missing, return `blocked` with the exact check and error. - Do not run the full test suite unless the card explicitly asks; run targeted checks. ## Acceptance (re-runnable) 1. `{{command or artifact path}}` → {{expected result/state}} 2. `{{citation check / metric / render at sizes}}` → {{expected result}} 3. Every criterion must have evidence a fresh verifier can reproduce. If the quality profile is `product` and this task touches UI/interaction, also record: - release-build p95 frame time and input latency at the target size; - the 3–5 step user scenario; - baseline comparison (new must not be worse). ## Report `.swarm/reports/{{ID}}.json` per `.swarm/report.schema.json`; status `done|partial|blocked|failed`. Keep the report to summary + evidence lines; raw logs go to `.swarm/tmp/{{ID}}/`. ## Stop conditions - Time box: 25 minutes for S/M, 45–60 minutes for L, or 3 failed attempts at the same step. - A load-bearing unknown, a needed file outside scope, or a broken contract → `blocked` with the exact question. Do not guess. - If a sibling task's in-flight file causes a compile/test failure outside your scope, wait briefly and report `partial` with the exact external error; never edit that file.