Claude Code host: remaining work before 2.0 (#2438)
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 5/5
- 預估耗時
- 一週以上
- 新手友好度
- 15/100
- Issue 類型
- 功能
- 描述清晰度
- 基本清楚
- 活躍度
- 活躍
- 技術堆疊
- github, github-actions, typescript
研究方向
This checklist tracks remaining work across the Claude Code host effort, linking to issues #2438, #2441, #2452, #2470 and #2471 and ADR-003 at docs/specification/adr-003-host-neutral-canonical-coordinator.md. Start by checking the linked PRs and issues to see which items have merged, then read the relevant phase checklist. Done means the remaining 2.0 gates are resolved and the epic’s success criteria are checked; release planning and several maintainer decisions are still open.
由索引模型根據 Issue 內容生成。
描述
Everything left before Claude Code support in Squad is done, from epic #2438. Phases 0, 2, 3, 4, 5 and 6 are merged (#2445, #2450, #2463). Phase 1 is merged in #2451 except for the live golden trace.
Each item is marked Must (blocks calling Claude support done for 2.0), Should (strongly wanted for 2.0) or Later (can ship after 2.0).
1. Finish Phase 1: execution harness (#2441)
- Must Merge #2452: the G1–G9 golden trace, run live on
claude-agent-sdk(merged 2026-11-12) - Must Close #2441 (closed)
- Later (deferred 2026-11-13) Maintainers decide: pending approvals live in memory, and a harness restart cancels them and resumes the session. Does that meet "durable approval versions" (harness-adapters §15 item 6)? If not, persist pending approvals
- Should "Make
@github/copilot-sdkan optional peer dependency" (epic Phase 1): filed as #2472
2. Bugs from the end-to-end run
- Must fixed in #2470 (merged): #2462
squad initcommits machine-specificnode <abs path>launchers into.mcp.jsonand.claude/settings.jsonhooks, which breaks the repo for anyone else who clones it - Must fixed in #2470 (merged): #2453
squad init --client claudetells Claude users to runcopilot --agent squad - Should fixed in #2471 (merged): #2456 Member subagent descriptions are written at cast time, before routing exists, and stay vague until
squad upgrade - Should fixed in #2471 (merged): #2454 The coordinator asks Scribe for session and orchestration logs, but Scribe's charter rules them out
- Should fixed in #2471 (merged): #2455
squad_state_healthresolvedTeamDirreports the repo root, not.squad - Should fixed in #2471 (merged): #2458
squad init --client claudealso writes.copilot/,.github/and.vscode/. Confirm it's intended and document it - Later #2457 Dates are stamped in UTC (a day ahead in US evenings). Not Claude-specific
3. Plugin and dashboard hardening (after #2463)
- Must regenerated against
2.0.0-preview.5in #2506 (release prep): The plugin and marketplace pin2.0.0-preview.4, which lacks the dashboard and hook commands. They must be regenerated against the CLI version that ships these features (open thread on #2463). This happens as part of the release, see §6 - Must Install the plugin for real from the GitHub marketplace on a clean machine; so far only
--plugin-dirhas been run. Can run once 2.0.0-preview.5 is published - Should fixed in #2483 (merged; Windows CI runs the launcher tests): Test the Windows launcher's
npxquoting. Also fixes the repository launcher never findingsquadon PATH (a #2470 regression) - Should fixed in #2471 (merged): Add frontmatter to the
cli-wiringandretro-enforcementtemplate skills (claude plugin validatewarnings) - Later Plugin icon
- Later #2461 Team dashboard as a canvas in the GitHub Copilot app
4. Phase 7: host-neutral canonical coordinator
- Should decided: option C, ADR-003 Accepted in #2501; #2487 done (live scenarios with the Copilot file absent recorded in the host feature matrix, #2503); option B stays an opt-in spike in #2488. ADR-003 direction from the team (2026-11-12): option C for 2.0 → #2487 (self-sufficient non-Copilot coordinators, live behavioral scenarios with the Copilot file absent, about 3–5 days); option B as an opt-in spike → #2488 (fixed budget, not shipped). Analysis: #2486. Original item: Decision (not a release gate) Analysis in #2486 recommends option C (drop the pointer to the Copilot file, about half a day) and deferring B (about 2–3 days). Decide ADR-003 (
docs/specification/adr-003-host-neutral-canonical-coordinator.md, Proposed): does the canonical coordinator move from.github/agents/squad.agent.mdto a host-neutral source? Also decide whether it gates 2.0 or follows it - Implementation merged (#2487 work, #2500, #2501, #2503)
5. Review, test and docs loose ends
- Should done (threads resolved or annotated): Resolve or annotate the declined code-scanning threads on merged PRs: #2450 (hook launcher allowlist, hook-context text, member
Toolsallowlist) and #2451 (env allowlist for the Claude harness) - Should Run the epic's Phase 1 evidence item against a direct Anthropic API, Bedrock or Vertex endpoint (not a Copilot bridge), and record the endpoint in the evidence string
- Later A live approval test for the Copilot harness (only plain turns have run live)
- Later Replace the fake
claudebinary intest/cli/watch-claude-preset.test.tswith live runs behindSQUAD_REAL_CLI_TESTS=1 - Later Run a real gh-aw workflow with
engine: claudeandengine.args: ["--agent", "squad"] - Later decided and fixed in #2504 (merged): Claude no longer gets Copilot's template Init Mode skills. Decide whether to stop projecting the template
init-modeskill for Claude
Also found while working these
- The upgrade matrix's 1.0.1 and 1.1.0 release rows were silently skipping on
dev: the fixture fetched assets frombradygaster/squad, which now returns 404. Fixed in #2470, which points them atgithub/squadand refolds the matrix
6. Release gate (prepared in #2506, not yet dispatched)
- Must agreed: the next release is 2.0.0-preview.5, prepared in #2506 (plugin and marketplace regenerated there). A maintainer merges #2506 and dispatches
squad-release.yml. Agree the 2.0 release plan with Tamir: the version (another preview or 2.0), what ships in it, and who regenerates the plugin and marketplace against it. Nothing in this checklist starts the release process - Must After the release: tick the epic's success criteria and close #2438
🤖 Generated with Claude Code
2026-11-12: demo run findings
A real claude -p run on a fresh repository, recorded for the README:
- merged #2484 The coordinator skipped the init-mode skill and hand-wrote
.claude/agents/(blocked by Claude Code): Init Mode now namessquad cast/squad client syncinline. Casting went from 54 turns, $1.49 and no subagents to 17 turns, $0.37 and all subagents written - merged #2484 Member descriptions doubled a period, and the coordinator passed paragraphs as
--role - merged #2484
squad dashboardshowed a headless session as running forever (no Stop hooks → no end marker); it now ends atcost-state - merged #2485 README "See it in Claude Code" with the recorded dashboard GIF (trending goal)
2026-11-16: status
All code work for Claude Code support is merged. Merged 2026-11-13/14: #2496 (narrower Squad Bash allowlist), #2500 (linked team repositories), #2501 (ADR-003 option C accepted), #2502 (squad_decide says where a git-branch backend stored it), #2503 (live scenario evidence), #2504 (no Copilot Init Mode skills for Claude), #2505 (a user's team decision reaches decisions.md in the same turn, so a teammate on Copilot sees it; one team with one person on Claude Code and another on Copilot CLI checked live both ways).
What's left for this issue:
- Must (maintainer): merge #2506 and dispatch the 2.0.0-preview.5 release
- Must: the clean-machine marketplace install, after the release
- Must: tick the epic's success criteria and close #2438
- Should: Phase 1 evidence against a direct Anthropic API, Bedrock or Vertex endpoint
- 主要語言
- TypeScript
- 星號
- 3.4k
- 分支
- 516
- 平均合併
- 1 天 15 小時
- 30 天內合併 PR
- 116
環境準備
- 提供 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
github/squad 的其他 Issue
-
bug
難度 2/5 1-3 小時 新手友好度 84/100
維護者通常 1 天內回覆
-
bug
難度 2/5 1-3 小時 新手友好度 77/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 82/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 72/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 78/100
維護者通常 1 天內回覆
相似的 Issue
-
bot:ai-assisted component:platform-js status:untriaged
難度 1/5 1 小時以內 新手友好度 74/100
midnightntwrk/platform-js#38 ·
-
難度 2/5 1-3 小時 新手友好度 68/100
ranxianglei/billion-context#7068 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 78/100
mybigday/whisper.rn#348 ·
-
enhancement severity:low
難度 2/5 1-3 小時 新手友好度 82/100
Battle-Cattle/BCUK-Bot-4#1075 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 67/100
ilan-pinto/roaring-lions#1552 ·
維護者通常 1 天內回覆