squad-coordinator-init-mode
Squad coordinator only: Init Mode, proposing and casting a new team. Load when team.md is missing or has an empty roster, or when asked to set up or cast a team.
- License 许可
- MIT
- 所属仓库
- github/squad
- 最近更新
- 2026-11-15
- Stars
- ★ 3.4k
- Forks
- 520
01 前言 Front Matter
- name
- squad-coordinator-init-mode
- description
- Squad coordinator only: Init Mode, proposing and casting a new team. Load when team.md is missing or has an empty roster, or when asked to set up or cast a team.
03 SKILL.md 正文
<!-- Generated by Squad from the Squad SDK (claude-plugin.ts). Do not edit: run node scripts/build-claude-plugin.mjs. -->
Init Mode and casting
This is the full text of core-protocol item 0 of the Squad coordinator, loaded on demand. It applies only to the Squad coordinator, never to team members.
Init Mode (only when there is truly no team). Decide this with squad_state_read of team.md (or squad_state_list), NEVER with glob/grep/search tools: many hosts' glob/grep skip dot-directories like .squad/ and will wrongly report "no matches". If team.md is readable and lists members, a team exists: NEVER overwrite or re-cast it, or its charters, decisions, history or casting records; use it. Only if team.md does not exist or has an empty roster:
- Phase 1 (propose). Infer the project's purpose from the request and repository (ask only if it is genuinely unknowable AND the session is interactive). Propose 3-5 specialists with a thematic universe, names and roles (a Lead, domain implementers, a Tester; Scribe, Ralph, Rai and Fact Checker are always-on built-ins).
- Auto-confirm (default). Do NOT stop to ask questions in Init Mode. The user's request is the confirmation: pick sensible defaults for anything unspecified (stack, scope, universe), record those assumptions under
Project Contextinteam.md, and continue to Phase 2 in the SAME turn. This is mandatory when the user said to proceed / confirm / go, or the host runs headless (print / exec / no question tool). Only an interactive session with a genuinely unknowable purpose may ask, and then at most ONE short question. Never end the turn with only a proposal or questions. - Phase 2 (create). If you can run shell commands, add EVERY member with the CLI, one call each:
squad cast --name <Name> --role "<Role>"(or, whensquadis not on PATH,node .squad/squad.mjs cast --name <Name> --role "<Role>"; notnpx squad, which may fetch an old published version and needs an approval prompt) (it writes the charter, history, theteam.mdroster row,routinghooks and the casting registry/history pair correctly; the built-ins scribe, ralph, rai and fact-checker already exist aftersquad init). Then write/adjust.squad/routing.mdas an ordinary file, and once routing is written runsquad client syncso host files built from it (Claude Code member subagent descriptions) pick up who owns what; it rewrites only Squad-managed files. If a cast command is denied, stop: show the exactsquad castcommands and ask the user to allow them (in Claude Code, by trusting the folder, which turns on the allow rules Squad wrote) or run them, then continue; never write the members yourself instead. Ifsquad cast --nameis not recognised (an oldersquadbuild that only lists the cast), tell the user to upgrade the squad CLI instead of hand-writing the team. NEVER hand-write or edit anything under.squad/casting/(registry.json,history.json,registry-history.commit.jsonare a checksummed pair: manual edits makesquad upgradefail with a registry error). If you cannot run shell commands, writeteam.md(a markdown table withName,Role,Charter,Statuscolumns; the Coordinator row stays separate),.squad/agents/<lowercase-name>/charter.mdandhistory.mdas ordinary files, leave.squad/casting/untouched and tell the user to runsquad cast --name <Name> --role "<Role>"for each member to register them. - After casting, STOP and report the roster unless the user's request also asked for work (setting up the team is not a request to build anything).
- Scratch space. Use
.squad/scratch/(inside the workspace) for temporary files; never write outside the workspace directory (hosts reject external-directory access).
04 同仓库更多 Skills
windows-compatibility
Cross-platform path handling and command patterns
versioning-policy
SemVer rules for Squad's stable, preview, insider, and local package versions
tiered-memory
Three-tier agent memory model (hot/cold/wiki) for context reduction per spawn
test-discipline
Design assertions that prove the actual contract and fail on realistic regressions
squad
Squad's command catalog and interactive menu. Invoke via /squad (slash command) or natural language ("squad commands", "what can squad do", "show me squad options"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.
squad-version-check
Internals of how @bradygaster/squad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.