spec: Squad as a state and team service without the generated coordinator (headless mode, file ownership, versioned state contract, engine boundary guide)

Đang mở
#2,359 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript

Hướng nghiên cứu

Start with the preview.2 upgrade work in #2303 and the related issues #2320, #2315, #2317, #2319, #2329, #2331, and #2333. Define the headless mode, file ownership and preview rules, versioned state contract, and engine boundary guide for comment before implementation; done means the spec covers all four areas and is ready to share.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

squad squad:architect wave:2-soon

From enterprise integrator feedback (Teams, Oct 28). A team runs Squad in an Azure DevOps hosted .NET monorepo as a persistent team and knowledge layer under Copilot CLI, with their own coordinator calling the state MCP, worktree local state, external memory disabled, jointly pinned CLI/SDK, and no generated coordinator or GitHub automation. Brady and Tamir agree this should be a supported path.

This issue tracks the spec (to be shared for comment before implementation) covering:

  1. A first class "state and team services without the generated coordinator" mode. What init and upgrade do in that mode, what is scaffolded, how the state MCP is declared for a host that is not Copilot.
  2. Separation of runtime upgrades from generated file updates. Explicit ownership rules per file (Squad owned, user owned, user owned with Squad generated block), upgrade must never touch user owned files, and a complete change preview before any write. Builds on the preview.2 upgrade work (#2303).
  3. The state interface as an independently versioned contract: CLI/SDK compatibility matrix, state format transitions, deprecation policy.
  4. An integration guide that states which features require Squad's own dispatch (model routing, usage accounting, reviewer gates) and which work when another host dispatches agents.

Related: #2320 (linked team on orphan/two layer), the "2.0 on non Copilot hosts" fixes from joslat (#2315 #2317 #2319 #2329 #2331 #2333), and the smaller preview.3 items filed alongside this one.

Ngôn ngữ chính
TypeScript
Star
3.4k
Fork
516
Merge trung bình
1 ngày 15 giờ
Pull request đã merge (30 ngày)
116

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của github/squad

Tất cả issue của github/squad

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.