swarm-engine 1.3.0 → 1.41.0

package/skills/swarm-output-style/SKILL.md

@@ -15,24 +15,24 @@ All orchestration output follows this guide. The goal: the user should always kn
 
 Show this BEFORE creating any team or spawning any agent. The user must approve before tokens are spent.
 
-```
-## Orchestration Plan
+Use `swarm-box.py` for the header, then markdown tables for the detail:
 
-**Task**: [1-line description]
-**Pattern**: [pattern name] | **Phases**: [N] | **Agents**: [N] | **Est. cost**: ~$[amount] | **Est. time**: ~[duration]
+```bash
+python3 ~/.claude/scripts/swarm-box.py <<'BOX'
+title: SWARM ORCHESTRATION — [Task Name]
+title: Pattern: [name]  │  Repo: [repo]
+title: [scope summary]
+BOX
+```
 
-### Phase 1: [Name] -- [parallel/sequential] (~[time], ~$[cost])
-| Agent | Model | Focus |
-|-------|-------|-------|
-| `agent-name` | [model] | [what this agent will do] |
+Then show phase details as markdown tables:
 
-### Phase 2: [Name] -- [parallel/sequential] (~[time], ~$[cost])
+```
+### Phase 1: [Name] -- [parallel/sequential] (~[time])
 | Agent | Model | Focus |
 |-------|-------|-------|
 | `agent-name` | [model] | [what this agent will do] |
 
-[repeat for all phases]
-
 Proceed?
 ```
 
@@ -45,12 +45,25 @@ Cost estimates use these rough defaults per agent type:
 
 ## 2. Phase Transition Banners
 
-At the start of each phase, show a clear banner with running totals:
+**MANDATORY**: Use `python3 ~/.claude/scripts/swarm-box.py` via Bash tool for ALL box-drawing output. NEVER hand-draw boxes.
 
+Phase start banner:
+```bash
+python3 ~/.claude/scripts/swarm-box.py <<'BOX'
+title: PHASE 1 · Research | ⏱ 0:00
+3 agents · sonnet · read-only
+BOX
 ```
+
+Phase completion summary:
+```bash
+python3 ~/.claude/scripts/swarm-box.py <<'BOX'
+title: PHASE 2 · Implement · COMPLETE | ⏱ ~10 min
 ---
-**Phase [N] / [total]: [Name]** -- [N] agent(s) [parallel/sequential]
-Running total: ~$[amount] | [elapsed] elapsed
+✓ implementer-core    — 40 new tests, graph modules done
+✓ implementer-wiring  — engine/runner/learner wired
+✓ implementer-docs    — docs.html + llms-full.txt updated
+BOX
 ```
 
 ## 3. Agent Completion Lines
@@ -113,34 +126,59 @@ Options:
 
 ## 6. Post-Completion Summary (MANDATORY)
 
-```
+**MANDATORY**: Use `python3 ~/.claude/scripts/swarm-box.py` via the Bash tool. NEVER hand-draw boxes — they will always be misaligned.
+
+### How to use swarm-box.py
+
+Call via Bash tool with a heredoc. The script auto-pads all lines to identical display width.
+
+```bash
+python3 ~/.claude/scripts/swarm-box.py <<'BOX'
+title: ORCHESTRATION COMPLETE | STATUS: PASS
 ---
-## Orchestration Complete -- [PASS / NEEDS ATTENTION / FAILED]
 
-**Pattern**: [name] | **Phases**: [N] | **Agents**: [N] | **Duration**: [time]
-**Tokens**: ~[total] | **Cost**: ~$[amount]
+Phases: 4  │  Agents: 8  │  Duration: ~14 min
 
-### What Changed
-[List files with brief descriptions. Include `git diff --stat` output if available.]
+[What Changed]
+20 files changed, +3,838 lines
 
-### Review Gate: [PASS / FAIL] ([Nth] iteration)
-| Reviewer | Result | Findings |
-|----------|--------|----------|
-| [name] | PASS/FAIL | [count] critical, [count] important, [count] suggestions |
+Tests:   53 new (987 → 1041), 64 files, all green
+Memory:  purge, prune, get, delete CLI commands
+Docs:    Knowledge Graph section on swarmengine.dev
+Version: 1.3.0 → 1.31.0
+Branch:  feat/execution-knowledge-graph → main
+[/]
 
-### Suggestions (non-blocking)
-- [suggestion with reviewer attribution]
+[Review Gate]
+reviewer-correctness  PASS (2 important → fixed)
+reviewer-convention   PASS (1 important → fixed)
+fixer                 6/6 findings resolved
+[/]
 
-### Knowledge Stored
-- [what was saved to memory, if anything]
+Next: npm publish (run npm publish when ready)
 
----
-**Next steps:**
-- Review changes: `git diff HEAD`
-- Run tests: `npm test` (or project equivalent)
-- Run verification: type `/verify`
+BOX
 ```
 
+### Input format
+
+| Line type | Syntax | Renders as |
+|-----------|--------|------------|
+| Header | `title: TEXT` | `║  TEXT  ║` (top of box) |
+| Separator | `---` | `╠═══════╣` |
+| Sub-box start | `[Label]` | `║  ┌─ Label ──┐ ║` |
+| Sub-box end | `[/]` | `║  └──────────┘ ║` |
+| Content (inside sub-box) | plain text | `║  │  text  │ ║` |
+| Content (outside sub-box) | plain text | `║  text  ║` |
+| Blank line | empty line | `║  ║` |
+
+### Rules
+
+- **EVERY box in swarm output MUST be generated by `swarm-box.py`** — phase banners, completion summaries, pre-flight plan headers, error recovery boxes. No exceptions.
+- The script guarantees all lines have identical display width (verified internally).
+- Copy-paste the script output directly into your response.
+- If the script is unavailable, fall back to markdown tables — never hand-draw box characters.
+
 ## Anti-Patterns (DO NOT)
 
 - Do NOT spawn agents before showing the pre-flight plan