54 lines
1.9 KiB
Cheetah
54 lines
1.9 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.}}
|
|
|
|
## 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`.
|