Spec Driven Dev
VS Code extension for the Spec-Driven Development workflow.
Two panels in one extension:
- 📋 Review Board — visual UI to review AI-generated findings from
/refine-prd, /review-context, /review-tech-docs
- 📊 Living Documentation — project-wide traceability dashboard driven by
.trace/*.tsv
Installation
code --install-extension edupia-team.spec-driven-dev-team
Hoặc VS Code → Ctrl+Shift+P → "Extensions: Install from Marketplace" → search Spec Driven Dev.
VS Code tự động cập nhật khi có version mới.
Panel 1 — Review Board
Cách dùng
Bước 1 — Chạy một review command trong Claude Code
/refine-prd specs/prd/payment/create-invoice.md
/review-context specs/prd/payment/create-invoice.md
/review-context specs/bdd/payment/PAY-UC01.feature
/review-tech-docs tech-docs/payment/PAY-UC01-tech-design.md
Claude phân tích và ghi file vào .agent/review/:
| Command |
Findings file |
/refine-prd |
{prd-slug}-findings.yaml |
/review-context (PRD) |
{prd-slug}-review-context-findings.yaml |
/review-context (BDD) |
{uc-id}-review-bdd-findings.yaml |
/review-tech-docs |
{uc-id}-tech-review-findings.yaml |
Bước 2 — Mở Review Panel
- Sidebar (khuyến nghị): Click icon trên Activity Bar → danh sách findings files → click file
- Right-click: Right-click vào file
*-findings.yaml trong Explorer → "Open Review Board"
- Command Palette:
Ctrl+Shift+P → "Spec Driven Dev: Open Review Board"
VS Code tự hiện thông báo "Mở ngay?" khi file findings vừa được tạo.
Bước 3 — Review từng finding
Mỗi finding hiển thị:
- Severity: 🔴 Critical / 🟡 Major / 🔵 Minor
- Badge:
⚡ auto-fix (AI có thể tự sửa) / 👤 human (cần quyết định của người)
- ID: check_id (
P1, B2, T3) hoặc lens (QA, DEV, SA, PO)
- Section / Issue / Suggestion
Bấm để xử lý:
| Nút |
Kết quả |
| ✓ Accept |
Chấp nhận finding |
| ✎ Modify |
Chấp nhận có chỉnh sửa — nhập note vào modal |
| ⏸ Defer |
Để sau |
| ✗ Reject |
Từ chối — nhập lý do vào modal |
| ↩ Change |
Hoàn tác về pending |
Bước 4 — Apply
Sau khi review xong, bấm "Apply" ở cuối panel. Extension tự chọn lệnh đúng theo loại findings:
| Workflow |
Terminal command |
refine-prd |
/refine-prd {prd-file} --resume |
review-context |
/review-context --resume {source-file} |
tech-design |
/review-tech-docs --resume {tech-doc} |
Quick-fix path (không qua Review Board)
Dành cho dev muốn apply nhanh tất cả auto_fixable findings:
/review-context --fix specs/bdd/payment/PAY-UC01.feature
AI apply ngay, bỏ qua Review Board, chỉ để lại các finding cần quyết định của người.
Tính năng
| Tính năng |
Mô tả |
| Multi-command |
Hỗ trợ findings từ /refine-prd, /review-context, /review-tech-docs |
| Lens tabs |
All / QA / DEV / SA / PO (refine-prd) hoặc PRD / BDD / TECH (review-context) |
| auto_fixable badge |
⚡ auto-fix / 👤 human trên mỗi finding |
| check_id label |
P1, B2, T3 hiển thị khi dùng review-context / review-tech-docs |
| Progress bar |
Thanh tiến độ % đã review |
| Search |
Tìm kiếm toàn văn qua issue / suggestion / section |
| Smart Apply |
Tự chọn --resume command đúng theo loại findings file |
| Auto-detect |
Tự tìm findings files khi mở từ Command Palette |
| File watcher |
Tự refresh sidebar khi findings file mới được tạo |
Panel 2 — Living Documentation
Dashboard traceability health của toàn project, đọc từ .trace/*.tsv.
Cách mở
Ctrl+Shift+P → "Spec Driven Dev: Open Living Documentation"
Dashboard
┌──────────────────────────────────────────────────────────────────┐
│ PRDs Use Cases Scenarios Code Cov. Test Cov. Drift Gap │
│ 19 86 1077 93% 89% 12 5 │
└──────────────────────────────────────────────────────────────────┘
Drill down: PRD → Use Case → per-scenario table
| SC ID |
Title |
Spec ver |
Gen ver |
Code |
Tests |
Status |
| PAY-UC01-SC1 |
Happy path |
1.2 |
1.2 |
✅ |
✅ |
OK |
| PAY-UC01-SC2 |
Refund |
1.3 |
1.2 |
⚠️ |
✅ |
DRIFT |
| PAY-UC02-SC1 |
Void |
1.0 |
— |
— |
— |
UNTRACKED |
Status badges:
- ✅ OK — spec ver = gen ver, code + tests tồn tại
- ⚠️ DRIFT — spec ver ≠ gen ver (scenario đã sửa, code chưa update)
- 🔴 GAP — code tồn tại nhưng chưa có tests
- UNTRACKED — chưa có code implement
Tính năng:
- Filter theo PRD status (Approved / Draft / Other)
- Search theo UC/SC ID hoặc title
- Filter theo status (OK / DRIFT / GAP / UNTRACKED)
- Live reload khi
.trace/*.tsv thay đổi
Data source: .trace/{UC-ID}.tsv — được ghi bởi /generate-bdd, /generate-code, /generate-tests, cập nhật bởi /validate-traces.
Yêu cầu
Uninstall
code --uninstall-extension edupia-team.spec-driven-dev-team
Liên quan
