Spec-Driven Dev Plugin

An AI-First Spec-Driven Development workflow plugin for Claude Code.

Guides your team through a complete feature lifecycle — Discovery → PRD → Design-Spec → BDD → Tech Design → Code → Dev self-check → QC automation — with AI review gates at every transition and end-to-end traceability.

📚 Documentation

Toàn bộ tài liệu nằm trong docs/, chia theo vai trò và chủ đề:

| Bạn là… | Bắt đầu ở | |---------|-----------| | Người mới / cài đặt lần đầu | 01 · Getting Started | | Product Owner / BA | Guide · Product Owner | | Developer (FE / BE / App) | Guide · Developer | | Tester / QA | Guide · Tester / QA — gồm cả pipeline QC tự động (/qc-*) | | Muốn hiểu kiến trúc | 03 · Concepts | | Vận hành / admin | 04 · Operations | | Tra cứu lệnh / schema / module | 05 · Reference |

→ Mở mục lục đầy đủ

Quick Start

Requires Node.js (check: node -v).

# 1. Install framework
#    Single-service:
npx @anhth2/spec-driven-dev-plugin --init --module java-spring
#    Multi-service monorepo:
npx @anhth2/spec-driven-dev-plugin --init \
  --services backend:java-spring,web-admin:react,app-mobile:flutter

# 2. Open the project in Claude Code, then:
/setup-ai-first

# 3. Fill in the generated config (CLAUDE.md, .agent/project-context.yaml,
#    specs/domain-knowledge/*), then start your first feature:
/define-product

Full install paths (upgrade, umbrella, uninstall) → Getting Started › Installation. First feature end-to-end → Getting Started › Quick Start.

Workflow at a glance

Phase 1  Discovery        /define-product
Phase 2  PRD              /generate-prd · /refine-prd · /review-context
Phase 2b Design Spec      /generate-design-spec            (FE/App only)
Phase 3  BDD              /generate-bdd · /review-context
Phase 4  Tech Design      /generate-tech-docs · /review-tech-docs
Phase 5  Code             /generate-code · /review-code
Phase 6  Dev self-check   /dev-gen-test · /dev-run-test · /dev-smoke-test   → dev_selftest
Phase 6b QC automation    /qc-analyze → /qc-plan → /qc-design-test
                          → /qc-review → /qc-run-test → /qc-report          → qc_status
Phase 7  Trace            /validate-traces
Phase 8  Tester feedback  /report-bug · /propose-scenario → /sync
Cross-cutting             /sync · /learn · /update-framework

Pipeline chi tiết → Concepts › Pipeline. Bảng đầy đủ mọi command → Reference › Commands.

Philosophy

Write the spec first. Generate the code from the spec. Trace everything.

• Humans define what — acceptance criteria, business rules, platform requirements.
• AI generates how — BDD scenarios, tech design, code, tests — adapted to the platform.
• Every artifact is reviewed before proceeding to the next phase.
• Every line of code traces back to a scenario in a .feature file.
• In multi-service projects, each service evolves independently while sharing the same workflow.

Framework version: see npm — npm view @anhth2/spec-driven-dev-plugin version. Build internals & directory map → Concepts › Architecture.