59 lines
2.1 KiB
Cheetah
59 lines
2.1 KiB
Cheetah
# 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.}}
|
||
|
||
## Token / effort budget
|
||
- Hard budget: {{tokens or n/a}}; reserve {{20–30%}} for verification and integration.
|
||
- Prefer vertical slices and files under ~800 lines.
|
||
- Workers read the listed inputs/ranges, not the whole repository.
|
||
|
||
## 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`.
|