Emil_Shanaty/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Make agent-swarm domain-neutral and adaptive

Browse Source
This commit is contained in:
Emil Shanaty
2026-10-27 19:27:11 +03:00
parent 464b610bf1
commit 20497d9c0c
11 changed files with 191 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files
agent-swarm/assets/brief.md.tmpl
+19 -11
View File
@@ -4,26 +4,34 @@
{{One paragraph. What must exist when the swarm is done.}}
## Success criteria
- [ ] {{Criterion}} — verified by {{check or command}}
- [ ] {{Criterion}} — verified by {{check or command}}
- [ ] {{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.}}
## Stack and commands
## 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}}` |
| test | `{{command}}` |
| lint | `{{command}}` |
| run | `{{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}}` |
## Repository map
| Path | Role |
## Artifact / source map
| Path, source or artifact | Role |
|---|---|
| `{{path}}` | {{one line}} |
| `{{path/url/artifact}}` | {{one line}} |
## Conventions and invariants
- {{Naming, error handling, test style, formatting.}}
@@ -37,7 +45,7 @@ Scope is checked by the lead with the skill's `scripts/audit-scope.mjs`; workers
See `.swarm/contracts.md`. Do not change an interface without returning `blocked`.
## Global forbidden actions
- No installs, repo-wide format/lint/codegen, migrations, dev servers, or git writes.
- 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.
agent-swarm/assets/task.md.tmpl
+7 -6
View File
@@ -11,11 +11,11 @@ Role: worker | Wave: {{n}} | Depends on: {{ids or —}} | Effort: {{S/M/L}}
## Inputs (read first)
- `.swarm/brief.md`
- `.swarm/contracts.md` §{{section}}
- `{{path}}:{{start}}-{{end}}`
- `{{artifact/source}}`: {{path:start-end, URL, dataset, design file}}
## Deliverables
- `{{new or changed path}}` — {{what}}
- `{{test path}}` — {{what it covers}}
- `{{new or changed path/artifact}}` — {{what}}
- `{{test/evidence artifact}}` — {{what it proves}}
## Write scope (only these)
- `{{glob or exact path}}`
@@ -29,9 +29,10 @@ Role: worker | Wave: {{n}} | Depends on: {{ids or —}} | Effort: {{S/M/L}}
## Constraints
- {{No new dependencies, style, performance, compatibility.}}
## Acceptance (run these)
1. `{{command}}` → {{expected result}}
2. `{{command}}` → {{expected result}}
## 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.
## Report
`.swarm/reports/{{ID}}.json` per `.swarm/report.schema.json`; status `done|partial|blocked|failed`.
agent-swarm/assets/verifier.md.tmpl
+8 -4
View File
@@ -4,13 +4,17 @@ You did not write this work. Do not fix it. Do not trust worker summaries.
## Inputs
- Task cards: {{paths}}
- Changed files or diff: {{paths or command}}
- Acceptance checks: {{commands}}
- Changed files/artifacts or diff: {{paths or command}}
- Acceptance checks: {{commands, artifact paths, citations, metrics}}
## For each criterion
| Criterion | Command | Observed | Pass/Fail |
| Criterion | Evidence (command/artifact/citation/metric) | Observed | Pass/Fail |
|---|---|---|---|
| {{criterion}} | `{{command}}` | {{observed}} | {{pass/fail}} |
| {{criterion}} | {{command, path, URL or check}} | {{observed}} | {{pass/fail}} |
For research/content, cite the exact source and date. For data, record input hash, row count and
metric. For design, record the rendered artifact and sizes. For software, record the command and
output. Evidence must be reproducible by a fresh verifier.
## Also check
- Scope: every changed file is owned by the task.