Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
109 commits
Select commit Hold shift + click to select a range
1aaead4
fix: auto-scaffold Fact Checker agent during init and cast (#1222)
tamirdresher Jun 7, 2026
010f6fc
fix(upgrade): auto-scaffold Rai + Fact Checker on squad upgrade (#1222)
tamirdresher Jun 7, 2026
d41b046
Merge pull request #1223 from tamirdresher/fix/1222-fact-checker-auto…
bradygaster Jun 7, 2026
e5c1800
fix(permissions): use 'approve-once' for Copilot CLI v1.0.54+ contrac…
bradygaster Jun 9, 2026
a081832
feat: Squad.Agents.AI - Microsoft Agent Framework adapter for the Squ…
tamirdresher Jun 9, 2026
28962e2
ci(Squad.Agents.AI): switch NuGet publish to Trusted Publishing (OIDC…
tamirdresher Jun 9, 2026
647f337
fix(Squad.Agents.AI): expose SessionConfig + default OnPermissionRequ…
tamirdresher Jun 10, 2026
cc37a2f
Squad.Agents.AI 0.2.0: bump to MAF 1.10.0-rc1 / SDK 1.0.0 GA — file-I…
tamirdresher Jun 10, 2026
39ee9c7
fix: address pre-existing Copilot review comments from PR #1212 (#1258)
bradygaster Jun 11, 2026
611a82b
fix: expose memory tools via MCP + route writes through governed pipe…
bradygaster Jun 11, 2026
eeb68f2
docs(skills): update path references from .squad/skills/ to .copilot/…
bradygaster Jun 11, 2026
c11274d
feat(init): prompt to add @copilot as a team member during squad init…
bradygaster Jun 11, 2026
5824b60
docs: align skills path + state-backend upgrade flow (#1241, #1226) (…
bradygaster Jun 11, 2026
152bbf0
Squad.Agents.AI 0.3.0: first-class subagent observability (#1265)
tamirdresher Jun 11, 2026
d3c2d84
chore(lockfile): sync package-lock with package.json after v0.10.0 bu…
tamirdresher Jun 11, 2026
f79b03a
fix(bump-build): also update package-lock workspace entries (#1267)
tamirdresher Jun 11, 2026
da17eef
fix: release pipeline version pinning (#1203, #1204) (#1250)
bradygaster Jun 11, 2026
ce15d6b
chore: include CHANGELOG.md in published npm tarball (#1257)
bradygaster Jun 11, 2026
c076ffb
Squad.Agents.AI 0.4.0: default-on subagent observability + Aspire-sty…
tamirdresher Jun 11, 2026
dfc5b94
Squad.Agents.AI 0.5.0: auto-inject --agent squad (CLI parity by defau…
tamirdresher Jun 11, 2026
edcc39d
Squad.Agents.AI 0.5.1: fix 0.5.0 regression — use --agent CLI flag (n…
tamirdresher Jun 11, 2026
217e0bd
Add squad registry add/list/remove for discovery-only peer squads (#1…
tamirdresher Jun 12, 2026
2ca906d
fix(cli): stop writing squad_state to ~/.copilot/mcp-config.json on e…
tamirdresher Jun 13, 2026
84ce747
fix(sdk): wire team.md/routing.md/casting state on \squad preset appl…
tamirdresher Jun 13, 2026
68e2774
fix(docs): tell coordinator to roster Fact Checker on first-time cast…
tamirdresher Jun 13, 2026
16c6b25
fix(sdk): plumb Fact Checker like Rai — rich charter at init + .squad…
tamirdresher Jun 13, 2026
76ba4e7
fix(skills): rename squad disambiguation skill to squad-help (superse…
tamirdresher Jun 13, 2026
918cbd4
fix(prompt): coordinator must probe for squad_state/memory tools befo…
tamirdresher Jun 13, 2026
608f858
feat(skills): make /squad a real slash command (user-invocable: true …
tamirdresher Jun 13, 2026
40f78f2
fix(skills): install bundled skills to .github/skills/ (closes #1126)…
tamirdresher Jun 13, 2026
6afd067
feat(sdk): bundle cross-squad-communication skill (#5 cross-squad pro…
tamirdresher Jun 13, 2026
b79e64a
fix(coordinator): route "spawn a squad" / "another squad" prompts thr…
tamirdresher Jun 13, 2026
89a1b96
fix(sdk,cli): bundle missing skills on init + strip fabricated tiered…
tamirdresher Jun 13, 2026
942270b
docs: add feature pages for preset, cross-squad discover/delegate, an…
tamirdresher Jun 14, 2026
f9f77c0
docs: add feature pages for remaining 8 v0.10 features (tiered-memory…
tamirdresher Jun 14, 2026
caef438
docs(state-backends): document pre-commit hook, post-upgrade flow, an…
tamirdresher Jun 14, 2026
ae6f4e7
docs: clarify that .squad/casting/* files are identity, not two-layer…
tamirdresher Jun 14, 2026
567f447
fix(state-backend): conditional .gitignore entries for two-layer/orph…
tamirdresher Jun 14, 2026
264b876
feat(sdk): thread reasoningEffort through agent spawning pipeline (#1…
ahhlun Jun 15, 2026
6278510
deps: Bump xunit from 2.9.2 to 2.9.3 (#1237)
dependabot[bot] Jun 15, 2026
ca3fdd6
fix(test): anchor docs fence-parity regex to line start (#1319)
tamirdresher Jun 15, 2026
937665a
deps: Bump Microsoft.Extensions.Configuration and 8 others (#1317)
dependabot[bot] Jun 15, 2026
89bf31f
ci(dependabot): add npm ecosystem coverage for JS workspaces (#1320)
tamirdresher Jun 15, 2026
0b38155
deps: Bump GitHub.Copilot.SDK from 1.0.0 to 1.0.1 (#1316)
dependabot[bot] Jun 15, 2026
eb57b87
ci: bump the github-actions group across 1 directory with 8 updates (…
dependabot[bot] Jun 15, 2026
8418ef8
deps: Bump xunit.runner.visualstudio from 2.8.2 to 3.1.5 (#1238)
dependabot[bot] Jun 15, 2026
9a5babc
deps: bump the minor-patch group in /docs with 7 updates (#1330)
dependabot[bot] Jun 15, 2026
a137f9b
deps: Bump Microsoft.Extensions.AI from 10.6.0 to 10.7.0 (#1331)
dependabot[bot] Jun 15, 2026
03bc88a
deps: bump eslint-plugin-n from 17.24.0 to 18.1.0 (#1336)
dependabot[bot] Jun 15, 2026
6643897
deps: bump astro from 5.18.0 to 6.4.7 in /docs (#1332)
dependabot[bot] Jun 15, 2026
8fe1096
chore(deps): bump flask in /test-fixtures/dogfood/python-flask (#1341)
dependabot[bot] Jun 15, 2026
0df0bb0
chore(deps): bump black in /test-fixtures/dogfood/python-flask (#1340)
dependabot[bot] Jun 15, 2026
0024464
chore(deps): bump pytest in /test-fixtures/dogfood/mixed-lang/backend…
dependabot[bot] Jun 15, 2026
a23e9b2
fix(docs): migrate to astro 6 content collection config (#1345)
tamirdresher Jun 15, 2026
0796216
chore(deps-dev): bump vite in /samples/streaming-chat (#1344)
dependabot[bot] Jun 16, 2026
3ac4731
chore(deps): bump esbuild, tsx and vitest in /samples/streaming-chat …
dependabot[bot] Jun 16, 2026
daef99a
deps: bump typedoc-plugin-markdown from 4.11.0 to 4.12.0 in /packages…
dependabot[bot] Jun 16, 2026
616cf9f
deps: bump markdown-it from 14.1.1 to 14.2.0 (#1346)
dependabot[bot] Jun 16, 2026
e97ed62
deps: bump the minor-patch group across 1 directory with 13 updates (…
dependabot[bot] Jun 16, 2026
9ea067f
chore: bump @types/node to 25.9.3 (cli + sdk) (#1349)
tamirdresher Jun 16, 2026
f45f856
chore: adapt CLI to ink 7 (#1350)
tamirdresher Jun 16, 2026
f020c8f
deps: bump vscode-jsonrpc from 8.2.1 to 9.0.0 in /packages/squad-cli …
dependabot[bot] Jun 16, 2026
be0c7df
chore: upgrade to TypeScript 6 (cli + sdk + root) and align @typescri…
tamirdresher Jun 16, 2026
04c80ab
chore: upgrade vitest to v4 (coordinated with @vitest/coverage-v8 v4)…
tamirdresher Jun 16, 2026
d5ada48
deps: bump vscode-jsonrpc from 8.2.1 to 9.0.0 in /packages/squad-sdk …
dependabot[bot] Jun 16, 2026
9bb88c6
deps: bump sharp from 0.35.1 to 0.35.2 in /docs in the minor-patch gr…
dependabot[bot] Jun 23, 2026
79ead09
deps: bump the minor-patch group with 2 updates (#1360)
dependabot[bot] Jun 23, 2026
af128fd
deps: Bump GitHub.Copilot.SDK from 1.0.1 to 1.0.3 (#1359)
dependabot[bot] Jun 23, 2026
9329802
deps: bump hono from 4.12.22 to 4.12.26 (#1355)
dependabot[bot] Jun 23, 2026
e76a21d
fix(coordinator): restore always-on inline-dispatch gate (#1378)
tamirdresher Jun 24, 2026
bcdd2e5
chore(deps): bump flask in /test-fixtures/dogfood/mixed-lang/backend …
dependabot[bot] Jun 24, 2026
bcc1d8b
chore(deps): bump pytest in /test-fixtures/dogfood/python-flask (#1376)
dependabot[bot] Jun 24, 2026
df5686d
fix(docs): rephrase 'fenced code block' row in skill-security-scanner…
tamirdresher Jun 24, 2026
1166b8f
docs(Squad.Agents.AI): update README header to 0.5.1 and multi-target…
tamirdresher Jun 24, 2026
0250d5f
ci(release): stop publishing on test-only dep bumps (#1342)
bradygaster Jun 24, 2026
3cfd2c5
ci: bump actions/checkout from 6 to 7 in the github-actions group (#1…
dependabot[bot] Jun 24, 2026
fc057de
fix: respect SQUAD_HOME env var, implement SQUAD_PERSONAL_DIR, fix Wi…
bradygaster Jun 25, 2026
389f147
docs: fix platform paths and explain global squad.agent.md (#1381)
bradygaster Jun 25, 2026
b563251
fix: CLI and upgrade bug fixes (#1050, #1048, #1047, #1052, #1029, #1…
bradygaster Jun 25, 2026
ae6f5c9
fix(sdk): export gitignore-state helpers; bump Squad.Agents.AI to 0.5…
bradygaster Jun 25, 2026
9eda638
feat(tracing): capture task-tool dispatch + tool requests for subagen…
tamirdresher Jun 25, 2026
dff05c4
fix: escape args for cmd.exe shell on Windows (DEP0190) (#1388)
tamirdresher Jun 25, 2026
78c48ca
feat(coordinator): spawn cast members as sub-sessions in Copilot App …
bradygaster Jun 25, 2026
7e49eb7
fix(coordinator): address #1385 review follow-ups (#1390)
bradygaster Jun 25, 2026
d407b82
Rename .NET Aspire references to Aspire (#1239)
Meir017 Jun 25, 2026
ea48282
chore: simplify workflow files by removing .ai-team fallback logic (#…
bradygaster Jun 25, 2026
45080ad
fix(routing): strip surrounding quotes from routing.md examples (#1357)
duongau Jun 25, 2026
ee1870d
fix(cli): add externalize/internalize to top-level squad --help (#1232)
primetimetank21 Jun 25, 2026
54ded23
deps: bump @types/node from 25.9.4 to 26.0.0 in /packages/squad-cli (…
dependabot[bot] Jun 25, 2026
a61f950
deps: bump @types/node from 25.9.4 to 26.0.0 in /packages/squad-sdk (…
dependabot[bot] Jun 25, 2026
5b9db05
ci: bump esbuild and tsx in /samples/storage-provider-sqlite (#1380)
dependabot[bot] Jun 25, 2026
918bbe8
deps: bump @opentelemetry/sdk-trace-base from 1.30.1 to 2.8.0 in /pac…
dependabot[bot] Jun 26, 2026
63ab588
deps: bump @opentelemetry/resources from 1.30.1 to 2.8.0 in /packages…
dependabot[bot] Jun 26, 2026
173880a
deps: bump @github/copilot-sdk from 0.3.0 to 1.0.4 (#1361)
dependabot[bot] Jun 26, 2026
98542a6
deps: bump @github/copilot-sdk from 0.3.0 to 1.0.4 in /packages/squad…
dependabot[bot] Jun 26, 2026
606840a
deps: bump cspell from 9.7.0 to 10.0.1 (#1362)
dependabot[bot] Jun 26, 2026
097c2fa
docs(casting): add spoiler-awareness to casting/naming rules (#1196)
obit91 Jun 26, 2026
f69cb03
feat(prompt): slim squad.agent.md by extracting 3 sections to satelli…
tamirdresher Jun 26, 2026
62c5249
feat(cli): rename hire to cast (#1394)
bradygaster Jun 26, 2026
89c36ab
Add OSS release checklist files (#1217)
bradygaster Jun 28, 2026
dc3bcf4
feat: add 'squad preset install <source>' for sharing presets via rep…
tamirdresher Jun 28, 2026
04682c6
fix: update adapter/client.ts for @github/copilot-sdk 1.0.4 API chang…
bradygaster Jun 28, 2026
6c7e110
deps: bump @opentelemetry/sdk-metrics and sdk-trace-node to 2.8.0 (#1…
bradygaster Jun 29, 2026
4ef3282
fix(cli): pin squad-sdk to workspace:* (fixes prerelease build crash)…
bradygaster Jun 29, 2026
897d883
Fix green test suite (#1416)
bradygaster Jun 29, 2026
6e6f1aa
Stage 0.11.0 release (#1420)
bradygaster Jun 30, 2026
7e01965
Guard symlink test for Windows/restricted environments (#1418)
bradygaster Jun 30, 2026
f963839
chore: promote dev → main (v0.11.0)
bradygaster Jun 30, 2026
e4cf2f8
chore: allow SWE-bench docs terms
bradygaster Jun 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
docs(casting): add spoiler-awareness to casting/naming rules (#1196)
* Add spoiler-awareness guideline to casting/naming rules

Squad's casting system allocated character names from fictional universes
but never screened them for plot spoilers. The existing easter-egg rule
only hides the casting *rationale*, not spoiler-bearing names. A name that
encodes a character's later title, role, transformation, or fate can spoil
a user who is mid-way through the source material, since names appear in
plain text across team.md, prompts, and logs.

Adds an always-loaded Name Allocation rule in squad.agent.md and a new
"Spoiler Awareness" section in casting-reference.md (with a scrubbed
motivating example), propagated to all mirrors via sync-templates.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix(casting): restore CRLF endings on casting-reference.md to remove false diff

The Spoiler Awareness edit was made on files whose committed blobs use CRLF, but local normalization rewrote them to LF. That made all 104 existing lines appear changed (122 ins / 104 del) and hid the real 18-line addition. Restoring CRLF collapses the diff to the genuine change only (18 insertions, 0 deletions).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs(casting): clarify spoiler guidance wording

Address review feedback on the Spoiler Awareness section:
- Use standard spelling 'midway' instead of 'mid-way'.
- Replace the ambiguous 'Never reorganize the casting around the spoiler'
  with explicit guidance: keep existing name mappings stable and only
  let the next/new allocation pick a different spoiler-safe character.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: add changeset for spoiler-aware casting

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
  • Loading branch information
obit91 and Copilot authored Jun 26, 2026
commit 097c2fa0737fb392dc84e17774f2d5832d4fdf29
29 changes: 29 additions & 0 deletions .changeset/spoiler-aware-casting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
---
"@bradygaster/squad-cli": patch
"@bradygaster/squad-sdk": patch
---

docs(casting): make agent name allocation spoiler-aware

Agent names are drawn from fictional universes as easter eggs and are
shown in plain text across `team.md`, prompts, logs, and generated files.
Previously the casting rules optimized only for theme fit and uniqueness,
so a freshly set-up squad could surface a character name that encodes a
future title, role, transformation, or fate — spoiling the source
material for a user who is only part-way through it.

This change updates the canonical naming guidance so that name allocation
now:

- Prefers the name a character has when first introduced.
- Avoids titles or epithets a character only earns later.
- Avoids names that reveal a transformation, fate, hidden identity, or
later reveal.
- Falls back to a safer character from the same universe when unsure.
- Keeps existing name mappings stable — only the next/new allocation
picks a different spoiler-safe character, so already-named agents are
never renamed.

Updates the `squad.agent.md` name-allocation rule and the
`casting-reference.md` reference (new "Spoiler Awareness" section),
propagated to all template copies via `scripts/sync-templates.mjs`.
19 changes: 10 additions & 9 deletions .github/agents/squad.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -809,7 +809,7 @@ If the user wants to remove someone:

## Casting & Persistent Naming

Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are easter eggs: never explain or document the mapping rationale in output, logs, or docs.
Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are spoiler-free easter eggs: never explain or document the mapping rationale in output, logs, or docs.

### Universe Allowlist

Expand All @@ -826,14 +826,15 @@ Agent names are drawn from a single fictional universe per assignment. Names are
After selecting a universe:

1. Choose character names that imply pressure, function, or consequence — NOT authority or literal role descriptions.
2. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
3. **Scribe is always "Scribe"** — exempt from casting.
4. **Ralph is always "Ralph"** — exempt from casting.
5. **Rai is always "Rai"** — exempt from casting.
6. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
7. Store the mapping in `.squad/casting/registry.json`.
8. Record the assignment snapshot in `.squad/casting/history.json`.
9. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.
2. Avoid spoiler-laden names. Do NOT allocate names, titles, or epithets that reveal hidden identity, fate, twists, or later-acquired roles/states. Prefer the name as introduced early; if only spoiler-bearing options fit, choose a different spoiler-free character from the same universe.
3. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
4. **Scribe is always "Scribe"** — exempt from casting.
5. **Ralph is always "Ralph"** — exempt from casting.
6. **Rai is always "Rai"** — exempt from casting.
7. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
8. Store the mapping in `.squad/casting/registry.json`.
9. Record the assignment snapshot in `.squad/casting/history.json`.
10. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.

### Overflow Handling

Expand Down
18 changes: 18 additions & 0 deletions .squad-templates/casting-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ score = size_fit + shape_fit + resonance_fit + LRU

Same inputs → same choice (unless LRU changes between assignments).

## Spoiler Awareness

Character names are easter eggs shown in plain text across `team.md`, prompts, logs, and generated files. The user configuring the squad may be midway through the source material. A name that bakes in a future title, role, transformation, or fate can spoil later plot events even when the casting rationale stays hidden.

How to avoid it:

- Prefer the name a character has when first introduced.
- Avoid titles or epithets earned later.
- Avoid names that describe a transformation, fate, hidden identity, or reveal.
- When unsure, pick a safer character from the same universe.
- Keep existing name mappings stable — do not rename already-allocated agents or switch universes to dodge a spoiler. Only the next/new allocation should pick a different spoiler-safe character.

> **Motivating example.** A user setting up a squad requested the *Malazan Book of the Fallen* universe (Steven Erikson) and was only four books into the series. The casting allocated two spoiler-bearing names:
> - One name bundled a **title/epithet the character only earns after a major mid-series development** — encoding a role they do not yet hold at the reader's current point in the story.
> - The other referenced a **state/transformation that has not yet occurred** at the reader's position — revealing what later becomes of that character.
>
> Both leaked future plot. (Character names are deliberately omitted here so this document does not reproduce the spoiler.)

## Casting State File Schemas

### policy.json
Expand Down
19 changes: 10 additions & 9 deletions .squad-templates/squad.agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -809,7 +809,7 @@ If the user wants to remove someone:

## Casting & Persistent Naming

Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are easter eggs: never explain or document the mapping rationale in output, logs, or docs.
Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are spoiler-free easter eggs: never explain or document the mapping rationale in output, logs, or docs.

### Universe Allowlist

Expand All @@ -826,14 +826,15 @@ Agent names are drawn from a single fictional universe per assignment. Names are
After selecting a universe:

1. Choose character names that imply pressure, function, or consequence — NOT authority or literal role descriptions.
2. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
3. **Scribe is always "Scribe"** — exempt from casting.
4. **Ralph is always "Ralph"** — exempt from casting.
5. **Rai is always "Rai"** — exempt from casting.
6. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
7. Store the mapping in `.squad/casting/registry.json`.
8. Record the assignment snapshot in `.squad/casting/history.json`.
9. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.
2. Avoid spoiler-laden names. Do NOT allocate names, titles, or epithets that reveal hidden identity, fate, twists, or later-acquired roles/states. Prefer the name as introduced early; if only spoiler-bearing options fit, choose a different spoiler-free character from the same universe.
3. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
4. **Scribe is always "Scribe"** — exempt from casting.
5. **Ralph is always "Ralph"** — exempt from casting.
6. **Rai is always "Rai"** — exempt from casting.
7. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
8. Store the mapping in `.squad/casting/registry.json`.
9. Record the assignment snapshot in `.squad/casting/history.json`.
10. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.

### Overflow Handling

Expand Down
18 changes: 18 additions & 0 deletions packages/squad-cli/templates/casting-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ score = size_fit + shape_fit + resonance_fit + LRU

Same inputs → same choice (unless LRU changes between assignments).

## Spoiler Awareness

Character names are easter eggs shown in plain text across `team.md`, prompts, logs, and generated files. The user configuring the squad may be midway through the source material. A name that bakes in a future title, role, transformation, or fate can spoil later plot events even when the casting rationale stays hidden.

How to avoid it:

- Prefer the name a character has when first introduced.
- Avoid titles or epithets earned later.
- Avoid names that describe a transformation, fate, hidden identity, or reveal.
- When unsure, pick a safer character from the same universe.
- Keep existing name mappings stable — do not rename already-allocated agents or switch universes to dodge a spoiler. Only the next/new allocation should pick a different spoiler-safe character.

> **Motivating example.** A user setting up a squad requested the *Malazan Book of the Fallen* universe (Steven Erikson) and was only four books into the series. The casting allocated two spoiler-bearing names:
> - One name bundled a **title/epithet the character only earns after a major mid-series development** — encoding a role they do not yet hold at the reader's current point in the story.
> - The other referenced a **state/transformation that has not yet occurred** at the reader's position — revealing what later becomes of that character.
>
> Both leaked future plot. (Character names are deliberately omitted here so this document does not reproduce the spoiler.)

## Casting State File Schemas

### policy.json
Expand Down
19 changes: 10 additions & 9 deletions packages/squad-cli/templates/squad.agent.md.template
Original file line number Diff line number Diff line change
Expand Up @@ -809,7 +809,7 @@ If the user wants to remove someone:

## Casting & Persistent Naming

Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are easter eggs: never explain or document the mapping rationale in output, logs, or docs.
Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are spoiler-free easter eggs: never explain or document the mapping rationale in output, logs, or docs.

### Universe Allowlist

Expand All @@ -826,14 +826,15 @@ Agent names are drawn from a single fictional universe per assignment. Names are
After selecting a universe:

1. Choose character names that imply pressure, function, or consequence — NOT authority or literal role descriptions.
2. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
3. **Scribe is always "Scribe"** — exempt from casting.
4. **Ralph is always "Ralph"** — exempt from casting.
5. **Rai is always "Rai"** — exempt from casting.
6. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
7. Store the mapping in `.squad/casting/registry.json`.
8. Record the assignment snapshot in `.squad/casting/history.json`.
9. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.
2. Avoid spoiler-laden names. Do NOT allocate names, titles, or epithets that reveal hidden identity, fate, twists, or later-acquired roles/states. Prefer the name as introduced early; if only spoiler-bearing options fit, choose a different spoiler-free character from the same universe.
3. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
4. **Scribe is always "Scribe"** — exempt from casting.
5. **Ralph is always "Ralph"** — exempt from casting.
6. **Rai is always "Rai"** — exempt from casting.
7. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
8. Store the mapping in `.squad/casting/registry.json`.
9. Record the assignment snapshot in `.squad/casting/history.json`.
10. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.

### Overflow Handling

Expand Down
18 changes: 18 additions & 0 deletions packages/squad-sdk/templates/casting-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ score = size_fit + shape_fit + resonance_fit + LRU

Same inputs → same choice (unless LRU changes between assignments).

## Spoiler Awareness

Character names are easter eggs shown in plain text across `team.md`, prompts, logs, and generated files. The user configuring the squad may be midway through the source material. A name that bakes in a future title, role, transformation, or fate can spoil later plot events even when the casting rationale stays hidden.

How to avoid it:

- Prefer the name a character has when first introduced.
- Avoid titles or epithets earned later.
- Avoid names that describe a transformation, fate, hidden identity, or reveal.
- When unsure, pick a safer character from the same universe.
- Keep existing name mappings stable — do not rename already-allocated agents or switch universes to dodge a spoiler. Only the next/new allocation should pick a different spoiler-safe character.

> **Motivating example.** A user setting up a squad requested the *Malazan Book of the Fallen* universe (Steven Erikson) and was only four books into the series. The casting allocated two spoiler-bearing names:
> - One name bundled a **title/epithet the character only earns after a major mid-series development** — encoding a role they do not yet hold at the reader's current point in the story.
> - The other referenced a **state/transformation that has not yet occurred** at the reader's position — revealing what later becomes of that character.
>
> Both leaked future plot. (Character names are deliberately omitted here so this document does not reproduce the spoiler.)

## Casting State File Schemas

### policy.json
Expand Down
19 changes: 10 additions & 9 deletions packages/squad-sdk/templates/squad.agent.md.template
Original file line number Diff line number Diff line change
Expand Up @@ -809,7 +809,7 @@ If the user wants to remove someone:

## Casting & Persistent Naming

Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are easter eggs: never explain or document the mapping rationale in output, logs, or docs.
Agent names are drawn from a single fictional universe per assignment. Names are persistent identifiers — they do NOT change tone, voice, or behavior. No role-play. No catchphrases. No character speech patterns. Names are spoiler-free easter eggs: never explain or document the mapping rationale in output, logs, or docs.

### Universe Allowlist

Expand All @@ -826,14 +826,15 @@ Agent names are drawn from a single fictional universe per assignment. Names are
After selecting a universe:

1. Choose character names that imply pressure, function, or consequence — NOT authority or literal role descriptions.
2. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
3. **Scribe is always "Scribe"** — exempt from casting.
4. **Ralph is always "Ralph"** — exempt from casting.
5. **Rai is always "Rai"** — exempt from casting.
6. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
7. Store the mapping in `.squad/casting/registry.json`.
8. Record the assignment snapshot in `.squad/casting/history.json`.
9. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.
2. Avoid spoiler-laden names. Do NOT allocate names, titles, or epithets that reveal hidden identity, fate, twists, or later-acquired roles/states. Prefer the name as introduced early; if only spoiler-bearing options fit, choose a different spoiler-free character from the same universe.
3. Each agent gets a unique name. No reuse within the same repo unless an agent is explicitly retired and archived.
4. **Scribe is always "Scribe"** — exempt from casting.
5. **Ralph is always "Ralph"** — exempt from casting.
6. **Rai is always "Rai"** — exempt from casting.
7. **@copilot is always "@copilot"** — exempt from casting. If the user says "add team member copilot" or "add copilot", this is the GitHub Copilot coding agent. Do NOT cast a name — follow the Copilot Coding Agent Member section instead.
8. Store the mapping in `.squad/casting/registry.json`.
9. Record the assignment snapshot in `.squad/casting/history.json`.
10. Use the allocated name everywhere: charter.md, history.md, team.md, routing.md, spawn prompts.

### Overflow Handling

Expand Down
18 changes: 18 additions & 0 deletions templates/casting-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ score = size_fit + shape_fit + resonance_fit + LRU

Same inputs → same choice (unless LRU changes between assignments).

## Spoiler Awareness

Character names are easter eggs shown in plain text across `team.md`, prompts, logs, and generated files. The user configuring the squad may be midway through the source material. A name that bakes in a future title, role, transformation, or fate can spoil later plot events even when the casting rationale stays hidden.

How to avoid it:

- Prefer the name a character has when first introduced.
- Avoid titles or epithets earned later.
- Avoid names that describe a transformation, fate, hidden identity, or reveal.
- When unsure, pick a safer character from the same universe.
- Keep existing name mappings stable — do not rename already-allocated agents or switch universes to dodge a spoiler. Only the next/new allocation should pick a different spoiler-safe character.

> **Motivating example.** A user setting up a squad requested the *Malazan Book of the Fallen* universe (Steven Erikson) and was only four books into the series. The casting allocated two spoiler-bearing names:
> - One name bundled a **title/epithet the character only earns after a major mid-series development** — encoding a role they do not yet hold at the reader's current point in the story.
> - The other referenced a **state/transformation that has not yet occurred** at the reader's position — revealing what later becomes of that character.
>
> Both leaked future plot. (Character names are deliberately omitted here so this document does not reproduce the spoiler.)

## Casting State File Schemas

### policy.json
Expand Down
Loading
Loading