SpecDeck
Điều phối coding agents bất đồng bộ bằng spec-first workflow.
SpecDeck là gì?
SpecDeck là một control deck để điều phối nhiều coding agent bất đồng bộ. Thay vì viết code, Spec của bạn giờ là source code. Bạn chỉ cần đưa ra ý định; các agent sẽ biến nó thành code. Bạn duyệt ở tầng Spec, dựa trên Bằng chứng (Evidence).
- Bắt buộc có bằng chứng: test, log, ảnh chụp màn hình, video. Một Check đạt mà không có Bằng chứng sẽ không bao giờ được tính là pass.
- Các bài kiểm tra xác định (deterministic) chạy trước, AI judge chạy sau. Checker độc lập đảm nhận xác minh, không phải Builder.
Shopping cart calculation
Tax is applied based on region
Evidence: Unit tests passed (12/12)
Discount codes are validated
Missing Evidence: No e2e tests found
Bốn cột, từ trái sang phải. Mỗi thẻ là một Spec.
Bạn quản lý công việc trên bảng 4 cột (Backlog, Plan, Review, Done). Một quy trình các agent chuyên biệt (Planner, Builder, Checker) nhận ý tưởng của bạn, viết Spec, viết code và cung cấp Bằng chứng. Bạn chỉ đọc các Check, không phải đọc code.
- Backlog01
Các Spec đang chờ được lập kế hoạch.
- Plan02
Agent soạn thảo Spec. Bạn xem xét những gì sắp được xây dựng.
- Review03
Agent đã hoàn thành. Bạn duyệt ở tầng Check và Evidence.
You review here - Done04
Đã phát hành và đóng băng. Spec chính là bản hợp đồng cuối cùng.
Planner, Builder, Checker.
A pipeline of specialized agents. Verification is independent and evidence-gated.
- Planner
Biến ý định thành Spec: Goal (Mục tiêu), Acceptance (Tiêu chí chấp nhận) và Checks.
- Builder
Thực thi một Spec một cách độc lập. Mỗi agent xử lý một đơn vị công việc.
- Checker
Một model độc lập xác minh Bằng chứng (Evidence). Không bao giờ tự chấm điểm công việc của chính mình.
Sẵn sàng tự lưu trữ (Self-host)
Postgres, Redis, gateway, agent và web frontend trong một file compose. Tự dùng key model của bạn.