# Swarm brief — {{TASK}}

## Goal
{{One paragraph. What must exist when the swarm is done.}}

## Success criteria
- [ ] {{Criterion}} — verified by {{check, command, artifact or citation}}
- [ ] {{Criterion}} — verified by {{check, command, artifact or citation}}

Scope is checked by the lead with the skill's `scripts/audit-scope.mjs`; workers do not run it.

## Non-goals
- {{What must not change or be attempted.}}

## Domain profile
- Domain: {{software / research / content / data / design / operations}}
- Primary artifacts: {{paths, sections, datasets, renders, services}}
- Evidence type: {{command / artifact / citation / metric / render}}
- Evidence commands or sources: {{commands, URLs, access notes}}
- Approval boundaries: {{what needs human confirmation}}

## Stack and commands (when applicable)
| Action | Command |
|---|---|
| build | `{{command or n/a}}` |
| test | `{{command or n/a}}` |
| lint | `{{command or n/a}}` |
| run | `{{command or n/a}}` |
| evidence | `{{screenshot/citation/metric command}}` |

## Artifact / source map
| Path, source or artifact | Role |
|---|---|
| `{{path/url/artifact}}` | {{one line}} |

## Conventions and invariants
- {{Naming, error handling, test style, formatting.}}
- {{Data or API invariants that must not break.}}

## Hazards
- {{Generated files, migrations, flaky tests, shared ports, secrets, caches.}}
- {{Generated or vendored paths that must not be edited.}}

## Frozen contracts
See `.swarm/contracts.md`. Do not change an interface without returning `blocked`.

## Global forbidden actions
- No installs, repo-wide format/lint/codegen, migrations, deployments, external publishes, dev servers, or git writes without explicit scope.
- No edits outside your task's write scope.
- Do not edit `.swarm/brief.md`, `plan.*`, `contracts.md`, or another task's files or reports.

## Reporting
Write `.swarm/reports/{{ID}}.json` and return the same object. Use `.swarm/report.schema.json`.