@bradygaster/squad-sdk 0.9.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +296 -296
  2. package/dist/agents/history-shadow.js +30 -30
  3. package/dist/build/github-dist.js +42 -42
  4. package/dist/config/init.js +173 -173
  5. package/dist/sharing/consult.js +78 -78
  6. package/package.json +1 -1
  7. package/templates/casting/Futurama.json +9 -9
  8. package/templates/casting-history.json +4 -4
  9. package/templates/casting-policy.json +37 -37
  10. package/templates/casting-reference.md +104 -104
  11. package/templates/casting-registry.json +3 -3
  12. package/templates/ceremonies.md +41 -41
  13. package/templates/charter.md +53 -53
  14. package/templates/constraint-tracking.md +38 -38
  15. package/templates/cooperative-rate-limiting.md +229 -229
  16. package/templates/copilot-instructions.md +46 -46
  17. package/templates/history.md +10 -10
  18. package/templates/identity/now.md +9 -9
  19. package/templates/identity/wisdom.md +15 -15
  20. package/templates/issue-lifecycle.md +412 -412
  21. package/templates/keda-scaler.md +164 -164
  22. package/templates/machine-capabilities.md +74 -74
  23. package/templates/mcp-config.md +90 -90
  24. package/templates/multi-agent-format.md +28 -28
  25. package/templates/plugin-marketplace.md +49 -49
  26. package/templates/ralph-circuit-breaker.md +313 -313
  27. package/templates/raw-agent-output.md +37 -37
  28. package/templates/roster.md +60 -60
  29. package/templates/routing.md +39 -39
  30. package/templates/run-output.md +50 -50
  31. package/templates/schedule.json +19 -19
  32. package/templates/scribe-charter.md +119 -119
  33. package/templates/skill.md +24 -24
  34. package/templates/skills/agent-collaboration/SKILL.md +42 -42
  35. package/templates/skills/agent-conduct/SKILL.md +24 -24
  36. package/templates/skills/architectural-proposals/SKILL.md +151 -151
  37. package/templates/skills/ci-validation-gates/SKILL.md +84 -84
  38. package/templates/skills/cli-wiring/SKILL.md +47 -47
  39. package/templates/skills/client-compatibility/SKILL.md +89 -89
  40. package/templates/skills/cross-squad/SKILL.md +114 -114
  41. package/templates/skills/distributed-mesh/SKILL.md +287 -287
  42. package/templates/skills/distributed-mesh/mesh.json.example +30 -30
  43. package/templates/skills/distributed-mesh/sync-mesh.ps1 +111 -111
  44. package/templates/skills/distributed-mesh/sync-mesh.sh +104 -104
  45. package/templates/skills/docs-standards/SKILL.md +71 -71
  46. package/templates/skills/economy-mode/SKILL.md +114 -114
  47. package/templates/skills/external-comms/SKILL.md +329 -329
  48. package/templates/skills/gh-auth-isolation/SKILL.md +183 -183
  49. package/templates/skills/git-workflow/SKILL.md +204 -204
  50. package/templates/skills/github-multi-account/SKILL.md +95 -95
  51. package/templates/skills/history-hygiene/SKILL.md +36 -36
  52. package/templates/skills/humanizer/SKILL.md +105 -105
  53. package/templates/skills/init-mode/SKILL.md +102 -102
  54. package/templates/skills/model-selection/SKILL.md +117 -117
  55. package/templates/skills/nap/SKILL.md +24 -24
  56. package/templates/skills/personal-squad/SKILL.md +57 -57
  57. package/templates/skills/project-conventions/SKILL.md +56 -56
  58. package/templates/skills/release-process/SKILL.md +423 -423
  59. package/templates/skills/reskill/SKILL.md +92 -92
  60. package/templates/skills/reviewer-protocol/SKILL.md +79 -79
  61. package/templates/skills/secret-handling/SKILL.md +200 -200
  62. package/templates/skills/session-recovery/SKILL.md +155 -155
  63. package/templates/skills/squad-conventions/SKILL.md +69 -69
  64. package/templates/skills/test-discipline/SKILL.md +37 -37
  65. package/templates/skills/windows-compatibility/SKILL.md +74 -74
  66. package/templates/workflows/squad-ci.yml +24 -24
  67. package/templates/workflows/squad-docs.yml +54 -54
  68. package/templates/workflows/squad-heartbeat.yml +171 -171
  69. package/templates/workflows/squad-insider-release.yml +61 -61
  70. package/templates/workflows/squad-issue-assign.yml +161 -161
  71. package/templates/workflows/squad-label-enforce.yml +181 -181
  72. package/templates/workflows/squad-preview.yml +55 -55
  73. package/templates/workflows/squad-promote.yml +120 -120
  74. package/templates/workflows/squad-release.yml +77 -77
  75. package/templates/workflows/squad-triage.yml +260 -260
  76. package/templates/workflows/sync-squad-labels.yml +169 -169
@@ -1,28 +1,28 @@
1
- # Multi-Agent Artifact Format
2
-
3
- When multiple agents contribute to a final artifact (document, analysis, design), use this format. The assembled result must include:
4
-
5
- - Termination condition
6
- - Constraint budgets (if active)
7
- - Reviewer verdicts (if any)
8
- - Raw agent outputs appendix
9
-
10
- ## Assembly Structure
11
-
12
- The assembled result goes at the top. Below it, include:
13
-
14
- ```
15
- ## APPENDIX: RAW AGENT OUTPUTS
16
-
17
- ### {Name} ({Role}) — Raw Output
18
- {Paste agent's verbatim response here, unedited}
19
-
20
- ### {Name} ({Role}) — Raw Output
21
- {Paste agent's verbatim response here, unedited}
22
- ```
23
-
24
- ## Appendix Rules
25
-
26
- This appendix is for diagnostic integrity. Do not edit, summarize, or polish the raw outputs. The Coordinator may not rewrite raw agent outputs; it may only paste them verbatim and assemble the final artifact above.
27
-
28
- See `.squad/templates/run-output.md` for the complete output format template.
1
+ # Multi-Agent Artifact Format
2
+
3
+ When multiple agents contribute to a final artifact (document, analysis, design), use this format. The assembled result must include:
4
+
5
+ - Termination condition
6
+ - Constraint budgets (if active)
7
+ - Reviewer verdicts (if any)
8
+ - Raw agent outputs appendix
9
+
10
+ ## Assembly Structure
11
+
12
+ The assembled result goes at the top. Below it, include:
13
+
14
+ ```
15
+ ## APPENDIX: RAW AGENT OUTPUTS
16
+
17
+ ### {Name} ({Role}) — Raw Output
18
+ {Paste agent's verbatim response here, unedited}
19
+
20
+ ### {Name} ({Role}) — Raw Output
21
+ {Paste agent's verbatim response here, unedited}
22
+ ```
23
+
24
+ ## Appendix Rules
25
+
26
+ This appendix is for diagnostic integrity. Do not edit, summarize, or polish the raw outputs. The Coordinator may not rewrite raw agent outputs; it may only paste them verbatim and assemble the final artifact above.
27
+
28
+ See `.squad/templates/run-output.md` for the complete output format template.
@@ -1,49 +1,49 @@
1
- # Plugin Marketplace
2
-
3
- Plugins are curated agent templates, skills, instructions, and prompts shared by the community via GitHub repositories (e.g., `github/awesome-copilot`, `anthropics/skills`). They provide ready-made expertise for common domains — cloud platforms, frameworks, testing strategies, etc.
4
-
5
- ## Marketplace State
6
-
7
- Registered marketplace sources are stored in `.squad/plugins/marketplaces.json`:
8
-
9
- ```json
10
- {
11
- "marketplaces": [
12
- {
13
- "name": "awesome-copilot",
14
- "source": "github/awesome-copilot",
15
- "added_at": "2026-02-14T00:00:00Z"
16
- }
17
- ]
18
- }
19
- ```
20
-
21
- ## CLI Commands
22
-
23
- Users manage marketplaces via the CLI:
24
- - `squad plugin marketplace add {owner/repo}` — Register a GitHub repo as a marketplace source
25
- - `squad plugin marketplace remove {name}` — Remove a registered marketplace
26
- - `squad plugin marketplace list` — List registered marketplaces
27
- - `squad plugin marketplace browse {name}` — List available plugins in a marketplace
28
-
29
- ## When to Browse
30
-
31
- During the **Adding Team Members** flow, AFTER allocating a name but BEFORE generating the charter:
32
-
33
- 1. Read `.squad/plugins/marketplaces.json`. If the file doesn't exist or `marketplaces` is empty, skip silently.
34
- 2. For each registered marketplace, search for plugins whose name or description matches the new member's role or domain keywords.
35
- 3. Present matching plugins to the user: *"Found '{plugin-name}' in {marketplace} marketplace — want me to install it as a skill for {CastName}?"*
36
- 4. If the user accepts, install the plugin (see below). If they decline or skip, proceed without it.
37
-
38
- ## How to Install a Plugin
39
-
40
- 1. Read the plugin content from the marketplace repository (the plugin's `SKILL.md` or equivalent).
41
- 2. Copy it into the agent's skills directory: `.squad/skills/{plugin-name}/SKILL.md`
42
- 3. If the plugin includes charter-level instructions (role boundaries, tool preferences), merge those into the agent's `charter.md`.
43
- 4. Log the installation in the agent's `history.md`: *"📦 Plugin '{plugin-name}' installed from {marketplace}."*
44
-
45
- ## Graceful Degradation
46
-
47
- - **No marketplaces configured:** Skip the marketplace check entirely. No warning, no prompt.
48
- - **Marketplace unreachable:** Warn the user (*"⚠ Couldn't reach {marketplace} — continuing without it"*) and proceed with team member creation normally.
49
- - **No matching plugins:** Inform the user (*"No matching plugins found in configured marketplaces"*) and proceed.
1
+ # Plugin Marketplace
2
+
3
+ Plugins are curated agent templates, skills, instructions, and prompts shared by the community via GitHub repositories (e.g., `github/awesome-copilot`, `anthropics/skills`). They provide ready-made expertise for common domains — cloud platforms, frameworks, testing strategies, etc.
4
+
5
+ ## Marketplace State
6
+
7
+ Registered marketplace sources are stored in `.squad/plugins/marketplaces.json`:
8
+
9
+ ```json
10
+ {
11
+ "marketplaces": [
12
+ {
13
+ "name": "awesome-copilot",
14
+ "source": "github/awesome-copilot",
15
+ "added_at": "2026-02-14T00:00:00Z"
16
+ }
17
+ ]
18
+ }
19
+ ```
20
+
21
+ ## CLI Commands
22
+
23
+ Users manage marketplaces via the CLI:
24
+ - `squad plugin marketplace add {owner/repo}` — Register a GitHub repo as a marketplace source
25
+ - `squad plugin marketplace remove {name}` — Remove a registered marketplace
26
+ - `squad plugin marketplace list` — List registered marketplaces
27
+ - `squad plugin marketplace browse {name}` — List available plugins in a marketplace
28
+
29
+ ## When to Browse
30
+
31
+ During the **Adding Team Members** flow, AFTER allocating a name but BEFORE generating the charter:
32
+
33
+ 1. Read `.squad/plugins/marketplaces.json`. If the file doesn't exist or `marketplaces` is empty, skip silently.
34
+ 2. For each registered marketplace, search for plugins whose name or description matches the new member's role or domain keywords.
35
+ 3. Present matching plugins to the user: *"Found '{plugin-name}' in {marketplace} marketplace — want me to install it as a skill for {CastName}?"*
36
+ 4. If the user accepts, install the plugin (see below). If they decline or skip, proceed without it.
37
+
38
+ ## How to Install a Plugin
39
+
40
+ 1. Read the plugin content from the marketplace repository (the plugin's `SKILL.md` or equivalent).
41
+ 2. Copy it into the agent's skills directory: `.squad/skills/{plugin-name}/SKILL.md`
42
+ 3. If the plugin includes charter-level instructions (role boundaries, tool preferences), merge those into the agent's `charter.md`.
43
+ 4. Log the installation in the agent's `history.md`: *"📦 Plugin '{plugin-name}' installed from {marketplace}."*
44
+
45
+ ## Graceful Degradation
46
+
47
+ - **No marketplaces configured:** Skip the marketplace check entirely. No warning, no prompt.
48
+ - **Marketplace unreachable:** Warn the user (*"⚠ Couldn't reach {marketplace} — continuing without it"*) and proceed with team member creation normally.
49
+ - **No matching plugins:** Inform the user (*"No matching plugins found in configured marketplaces"*) and proceed.