Spec-Driven Development và kỷ nguyên “AI-as-Teammate”: So sánh 4 framework hiện đại cho developer 2025

Giới thiệu

Khi AI coding assistant (Claude Code, Copilot, Gemini, Cursor, Qwen...) đã trở thành “đồng đội thật”, điều tiếp theo chúng ta cần không phải model mạnh hơn, mà là framework làm việc cùng AI có kỷ luật.

Spec-Driven Development (SDD) ra đời để giải quyết điều đó:

“Hãy mô tả rõ cái bạn sẽ làm, trước khi AI (hoặc con người) bắt đầu code.”

Hiện nay có 4 framework SDD tiêu biểu:

• Spec-Kit (GitHub)
• OpenSpec (Fission AI)
• Agent-OS (Builder Methods)
• cc-sdd (GotaLab)

Mỗi framework có triết lý và kiến trúc khác nhau. Bài viết này giúp bạn hiểu, so sánh và chọn đúng công cụ theo bối cảnh team bạn.

Tổng quan nhanh

II. Kiến trúc hệ thống & workflow

Spec-Kit – “Đường ray SDD chuẩn hoá”

• Focus: từ 0→1 feature mới.
• Kiến trúc: mỗi bước là 1 folder + file markdown rõ ràng.
• Integration: GitHub Actions có thể dùng speckit review để check drift.
• Ưu điểm: workflow sạch, CI-friendly.
• Nhược điểm: không xử lý tốt các thay đổi nhiều spec cùng lúc (multi-spec delta).

OpenSpec – “Git cho đặc tả thay đổi”

┌────────────────────┐
│ Draft Change       │
│ Proposal           │
└────────┬───────────┘
         │ share intent with your AI
         ▼
┌────────────────────┐
│ Review & Align     │
│ (edit specs/tasks) │◀──── feedback loop ──────┐
└────────┬───────────┘                          │
         │ approved plan                        │
         ▼                                      │
┌────────────────────┐                          │
│ Implement Tasks    │──────────────────────────┘
│ (AI writes code)   │
└────────┬───────────┘
         │ ship the change
         ▼
┌────────────────────┐
│ Archive & Update   │
│ Specs (source)     │
└────────────────────┘

1. Draft a change proposal that captures the spec updates you want.
2. Review the proposal with your AI assistant until everyone agrees.
3. Implement tasks that reference the agreed specs.
4. Archive the change to merge the approved updates back into the source-of-truth specs.

• Focus: 1→N, sửa nhiều phần trong hệ thống cũ (brownfield).
• Kiến trúc: openspec/specs/ + openspec/changes/[change-id]/.
• Điểm sáng: ghi version spec delta, giúp audit rõ ràng.
• Ưu điểm: track thay đổi, audit, rollback dễ dàng.
• Nhược điểm: hơi “meta” với team mới, cần discipline.

Agent-OS – “Hệ điều hành cho coding agents”

• Focus: orchestrate multi-agent theo chuẩn của team.
• Kiến trúc: .agent-os/ (standards, stack, context).
• Ưu điểm: mạnh mẽ cho multi-agent pipelines, code consistency.
• Nhược điểm: cần setup & governance rõ ràng (giống DevOps cho AI).

cc-sdd – “AI-DLC trong IDE, plug-and-play”

flowchart LR
  Q[npx cc-sdd] --> R[Scaffold Docs (req, design, tasks, steering)]
  R --> S[Slash Commands in IDE]
  S --> T[AI/Dev Edit + Approve]
  T --> U[Commit & Review]

• Focus: productivity, 1-lệnh khởi tạo.
• Kiến trúc: docs/requirements.md, design.md, tasks.md, steering.md.
• Ưu điểm: tiện cho team nhỏ, làm nhanh trong IDE.
• Nhược điểm: khó mở rộng, ít kiểm soát CI.

III. Bảng so sánh chi tiết tính năng

💡 IV. Pros / Cons tóm tắt

Case Study thực tế

🏗 Case 1: Startup fintech (team 5 dev + AI assistant)

• Vấn đề: xây feature mới nhanh, nhưng phải kiểm tra spec/plan rõ.
• Chọn: Spec-Kit → chạy speckit init → dùng speckit review trên PR.
• Kết quả: tiết kiệm 30% thời gian review và AI code chính xác hơn.

🏢 Case 2: Enterprise có 10+ service, muốn quản lý thay đổi nhiều module

• Vấn đề: mỗi lần thay đổi ảnh hưởng nhiều API & service khác nhau.
• Chọn: OpenSpec → dùng proposal & delta spec cho mỗi thay đổi.
• Kết quả: dễ audit, rollback, và compliance rõ hơn cho CI/CD.

🤖 Case 3: R&D Lab có nhiều coding agents (Claude, Gemini, Local LLM)

• Vấn đề: agent phải hiểu context & tiêu chuẩn của team.
• Chọn: Agent-OS → định nghĩa .agent-os/standards.yaml + stack.
• Kết quả: multi-agent coordination nhất quán, không xung đột code style.

⚡ Case 4: Team nhỏ, prototype nhanh trong Cursor/Claude Code

• Vấn đề: không muốn setup phức tạp, chỉ cần rails docs nhanh.
• Chọn: cc-sdd → npx cc-sdd → slash commands tạo spec + tasks.
• Kết quả: kickstart feature trong 1h, có docs rõ ràng để handoff.

🧭 VI. Hướng dẫn chọn nhanh

Gợi ý kết hợp

Trên thực tế, 4 công cụ này không loại trừ nhau. Một combo lý tưởng cho năm 2025:

Spec-Kit → làm rails SDD (spec, plan, tasks, review)
OpenSpec → quản lý thay đổi, delta, audit
Agent-OS → cung cấp standards, stack, orchestration multi-agent
cc-sdd → làm productivity layer trong IDE

Kết luận

Không có “framework đúng”, chỉ có “framework phù hợp với độ phức tạp của bạn”.

Spec-Driven Development không chỉ giúp AI hiểu bạn hơn — nó giúp chính bạn hiểu mình đang làm gì.