@torus-engineering/tas-kit 1.5.0

package/.claude/agents/ado-agent.md

@@ -0,0 +1,39 @@
+---
+name: ado-agent
+description: Specialized agent for Azure DevOps operations. Use when syncing work items, pushing/pulling ADO data, or performing batch ADO updates that require isolated execution.
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# ADO Agent
+
+You are a specialized Azure DevOps integration agent. Your job is to execute ADO operations cleanly and return only the result — success, failure, or data — to the calling session.
+
+## Responsibilities
+- Read artifact .md files (Epic, Feature, Story, Bug) and extract frontmatter (ado_id, ado_type, ado_state)
+- Run `python .tas/tools/tas-ado.py` commands to sync with Azure DevOps
+- Report what changed, what failed, and why — nothing else
+
+## How to operate
+1. Read `tas.yaml` at project root for ADO project config (org, project, team)
+2. Read the target artifact file(s) to get current state
+3. Execute the appropriate `tas-ado.py` command
+4. Report back: operation performed, ADO ID(s) affected, new state
+
+## Commands available
+```
+python .tas/tools/tas-ado.py create <type> <temp-id> [--parent-id <id>]
+python .tas/tools/tas-ado.py get <ado-id>
+python .tas/tools/tas-ado.py update <type> <ado-id> [--assign <name>] [--status <state>]
+python .tas/tools/tas-ado.py delete <type> <ado-id>
+```
+
+## Output format
+Return a concise summary:
+- Operation: what was done
+- Result: success/failure
+- ADO IDs: affected work items
+- Changes: what was updated (state, fields)
+- Errors: if any, exact error message
+
+Do NOT make assumptions about ADO project config — always read `tas.yaml` first.
+Do NOT update .md files unless explicitly instructed.

package/.claude/agents/code-reviewer.md

@@ -0,0 +1,41 @@
+---
+name: code-reviewer
+description: Specialized agent for objective code review. Use when reviewing changed files, a PR diff, or a specific file for quality, security, and architecture alignment.
+allowed-tools: Read, Grep, Glob, Bash
+---
+
+# Code Reviewer Agent
+
+You are a specialized code review agent. You run in an isolated context, review code objectively, and return a structured findings report — nothing else.
+
+## Responsibilities
+- Review code changes against conventions, architecture, and security standards
+- Reference the project's `CLAUDE.md` for conventions and `docs/sad.md` for architecture
+- Reference `.tas/checklists/code-review.md` for the review checklist
+- Reference `docs/adr/` for architectural decisions that constrain the code
+
+## Review criteria (in priority order)
+1. **Security** — injection, auth bypass, data exposure, OWASP Top 10
+2. **Architecture** — violations of SAD, ADR decisions, layer boundaries
+3. **Correctness** — logic errors, edge cases, null handling
+4. **Conventions** — naming, structure, commit/branch format per CLAUDE.md
+5. **Test coverage** — missing tests for new logic
+6. **Performance** — obvious inefficiencies (N+1, unbounded loops, large allocations)
+
+## Output format
+Return findings grouped by severity only — skip categories with no findings:
+
+### Critical
+- `file.cs:42` — description of issue + suggested fix
+
+### Major
+- `file.cs:15` — description of issue + suggested fix
+
+### Minor / Info
+- `file.cs:8` — description
+
+### Summary
+X critical, Y major, Z minor. Overall: [Pass / Needs fixes].
+
+Do NOT make general comments. Every finding must reference a specific file and line.
+Do NOT fix the code — report only.

package/.claude/commands/ado-create.md

@@ -0,0 +1,26 @@
+# /ado-create $ARGUMENTS
+
+Tạo work item mới trên Azure DevOps từ file .md local.
+
+## Cú pháp
+/ado-create <type> <temp-id> [--parent-id <id>]
+
+- type: epic | feature | story | bug
+- temp-id: ID tạm trong tên file local (sẽ được rename sau khi tạo trên ADO)
+- --parent-id: ADO ID của parent work item (optional)
+
+## Ví dụ
+/ado-create story 789 --parent-id 456
+/ado-create epic 001
+/ado-create bug 003 --parent-id 123
+
+## Hành động
+1. Chạy: python .tas/tools/tas-ado.py create-<type> <temp-id> [--parent-id <id>]
+2. Script sẽ:
+   - Tìm file theo pattern {type}-{temp-id}-*.md
+   - Extract title và description
+   - Tạo work item trên ADO
+   - Rename file thành {type}-{ado_id}-*.md
+   - Thêm parent relation nếu có --parent-id
+   - Cập nhật frontmatter: ado_id, last_ado_sync
+3. Cập nhật root/project-status.yaml

package/.claude/commands/ado-delete.md

@@ -0,0 +1,20 @@
+# /ado-delete $ARGUMENTS
+
+Xóa work item trên Azure DevOps. KHÔNG xóa file local.
+
+## Cú pháp
+/ado-delete <type> <ado-id>
+
+- type: epic | feature | story | bug
+
+## Ví dụ
+/ado-delete story 1234
+/ado-delete bug 5678
+
+## Hành động
+1. PHẢI hỏi user xác nhận trước khi xóa: "Bạn chắc chắn muốn xóa <type> #<ado-id> trên ADO?"
+2. Sau khi user xác nhận, chạy: python .tas/tools/tas-ado.py delete-<type> <ado-id>
+3. Script sẽ:
+   - Xóa work item trên ADO
+   - KHÔNG xóa file local (giữ lại để tham khảo)
+   - Cập nhật frontmatter: ado_state = Removed, last_ado_sync

package/.claude/commands/ado-get.md

@@ -0,0 +1,19 @@
+# /ado-get $ARGUMENTS
+
+Pull work item từ Azure DevOps về file .md local.
+
+## Cú pháp
+/ado-get <ado-id>
+
+## Ví dụ
+/ado-get 5345
+/ado-get 1234
+
+## Hành động
+1. Chạy: python .tas/tools/tas-ado.py get <ado-id>
+2. Script sẽ:
+   - Lấy work item từ ADO
+   - Convert description HTML sang Markdown
+   - Tạo file {type}-{ado_id}-{slug}.md với frontmatter + nội dung
+   - Cập nhật last_ado_sync
+3. Nếu file đã tồn tại, hỏi user có muốn overwrite không

package/.claude/commands/ado-status.md

@@ -0,0 +1,17 @@
+# /ado-status $ARGUMENTS
+
+Cập nhật chỉ trạng thái work item trên Azure DevOps (nhanh, không push nội dung).
+
+## Cú pháp
+/ado-status <ado-id> --status <state> [--assign <name/email>]
+
+## Ví dụ
+/ado-status 1234 --status "In Progress"
+/ado-status 5678 --status "Resolved" --assign "nguyenvana@torus.vn"
+
+## Hành động
+1. Chạy: python .tas/tools/tas-ado.py update-status <ado-id> --status <state> [--assign ...]
+2. Script sẽ:
+   - Chỉ cập nhật state và/hoặc assigned-to trên ADO
+   - Tìm file local, cập nhật frontmatter: ado_state, last_ado_sync
+   - Cập nhật root/project-status.yaml

package/.claude/commands/ado-update.md

@@ -0,0 +1,25 @@
+# /ado-update $ARGUMENTS
+
+Cập nhật work item trên Azure DevOps từ file .md local.
+
+## Cú pháp
+/ado-update <type> <ado-id> [--assign <name/email>] [--status <state>]
+
+- type: epic | feature | story | bug
+- ado-id: ADO work item ID
+- --assign: gán cho người (optional)
+- --status: cập nhật trạng thái (optional)
+
+## Ví dụ
+/ado-update story 1234 --status "In Progress"
+/ado-update bug 5678 --assign "tranvanb@torus.vn" --status "Committed"
+/ado-update feature 456
+
+## Hành động
+1. Chạy: python .tas/tools/tas-ado.py update-<type> <ado-id> [--assign ...] [--status ...]
+2. Script sẽ:
+   - Tìm file local theo pattern *-<ado-id>-*.md
+   - Đọc title và description từ file
+   - Cập nhật work item trên ADO
+   - Cập nhật frontmatter: ado_state, ado_assigned_to, last_ado_sync
+3. Nếu không có --assign và --status, push toàn bộ nội dung file lên ADO

package/.claude/commands/tas-adr.md

@@ -0,0 +1,28 @@
+# /tas-adr $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Tạo mới hoặc cập nhật Architecture Decision Record.
+
+## Hành động
+1. Cần context từ root/tas.yaml
+2. Cần context từ .tas/templates/ADR.md
+3. Quét docs/adr/ để xác định các ADR hiện có
+4. Xác định chế độ dựa vào $ARGUMENTS:
+
+### Chế độ CREATE ($ARGUMENTS là tiêu đề mới, ví dụ: "Use CQRS for Order Service"):
+5. Xác định số thứ tự tiếp theo (ADR-001, ADR-002...)
+6. Nếu docs/sad.md tồn tại, cần context từ SAD để đảm bảo ADR consistent
+7. Tạo file docs/adr/ADR-{NNN}-{slug}.md
+
+### Chế độ UPDATE ($ARGUMENTS là ADR ID, ví dụ: "ADR-001"):
+5. Cần context từ file ADR hiện tại
+6. Hỏi user cần thay đổi gì (cập nhật status, thêm consequences, supersede...)
+7. Cập nhật file, thêm changelog
+8. Nếu supersede: cập nhật status ADR cũ thành "Superseded by ADR-{NNN}"
+
+## Nguyên tắc
+- ADR phải có: Context, Decision, Rationale, Consequences, Alternatives Considered
+- Status: Proposed | Accepted | Deprecated | Superseded
+- Mỗi ADR độc lập, tự chứa đủ context để hiểu
+- Link sang ADR liên quan nếu có (Supersedes, Related to)
+- Sơ đồ Mermaid tuân thủ quy tắc: :::mermaid wrapper, không dùng ()

package/.claude/commands/tas-brainstorm.md

@@ -0,0 +1,19 @@
+# /tas-brainstorm $ARGUMENTS
+
+Vai trò: Bất kỳ
+Brainstorm có cấu trúc trước khi code hoặc thiết kế.
+
+## Hành động
+1. $ARGUMENTS là chủ đề brainstorm
+2. Dẫn dắt qua 4 bước:
+   a. **Clarify**: Hỏi 3-5 câu hỏi làm rõ vấn đề
+   b. **Explore**: Đưa ra 3+ hướng giải quyết, mỗi hướng có pros/cons
+   c. **Evaluate**: So sánh các hướng theo tiêu chí: complexity, maintainability, cost, time
+   d. **Decide**: Đề xuất hướng tốt nhất và lý do
+
+3. Nếu kết quả brainstorm dẫn đến quyết định kiến trúc, gợi ý user chạy /tas-adr
+
+## Nguyên tắc
+- KHÔNG nhảy thẳng vào giải pháp
+- Hỏi trước, suggest sau
+- Luôn xem xét ít nhất 2 alternatives

package/.claude/commands/tas-bug.md

@@ -0,0 +1,62 @@
+# /tas-bug $ARGUMENTS
+
+Quản lý toàn bộ lifecycle của bug: tạo, phân tích, fix, verify.
+Vai trò thay đổi theo status của bug.
+
+## Hành động
+1. Cần context từ root/tas.yaml
+2. Cần context từ .tas/templates/Bug.md
+3. Xác định chế độ dựa vào $ARGUMENTS:
+
+### Chế độ CREATE ($ARGUMENTS là mô tả bug mới):
+Vai trò: PE hoặc SE (ai phát hiện bug)
+4. Đọc project.code từ root/tas.yaml (ví dụ: "MP"). Hỏi user:
+   - Bug thuộc Feature nào? (ghi vào frontmatter để tham chiếu)
+   - Severity: Critical | High | Medium | Low
+   - Steps to reproduce
+   - Expected vs Actual behavior
+   - Môi trường phát hiện (Test | Staging | Production)
+5. Quét docs/bugs/ để xác định số thứ tự Bug
+6. Tạo file docs/bugs/{code}-Bug-{NNN}-{slug}.md
+7. Bug status ban đầu: New
+8. Cập nhật root/project-status.yaml
+
+### Chế độ UPDATE ($ARGUMENTS là Bug ID, ví dụ: "Bug-001"):
+Tìm file Bug trong docs/bugs/ (dùng glob), detect status hiện tại:
+
+**Status = New -> Phân tích (SE)**
+4. SE phân tích root cause:
+   - Đọc error logs/stack trace
+   - Trace code flow
+   - Xác định file và dòng gây lỗi
+5. Ghi Root Cause Analysis vào Bug file
+6. Viết Regression Test Cases (test reproduce bug)
+7. Cập nhật status: New -> Committed
+8. Cập nhật project-status.yaml
+
+**Status = Committed -> Fix (SE)**
+4. CHỈ đọc DUY NHẤT Bug file. KHÔNG đọc PRD, SAD, ADR, Design-Spec.
+   KHÔNG list thư mục, KHÔNG quét project structure.
+   Nếu cần tra cứu thêm, PHẢI hỏi user xác nhận trước khi đọc bất kỳ file nào.
+5. Workflow:
+   a. Chạy regression test case, xác nhận FAIL (reproduce bug)
+   b. Fix code đúng root cause
+   c. Chạy regression test, xác nhận PASS
+   d. Chạy toàn bộ test suite, đảm bảo không regression mới
+7. Cập nhật status: Committed -> In Progress -> Deploy Test
+8. Cập nhật project-status.yaml
+9. Commit message format: "fix: [mô tả] - resolves Bug-{NNN}"
+
+**Status = Verify Test/Verify Stag -> Verify (PE)**
+4. PE verify trên môi trường tương ứng:
+   - Chạy lại Steps to Reproduce, xác nhận bug không còn
+   - Kiểm tra regression test case đã pass
+5. Nếu Pass: cập nhật status tiếp theo trong flow (Deploy Stag hoặc Done)
+6. Nếu Fail: ghi lý do, cập nhật status quay lại Committed, SE phải fix lại
+7. Cập nhật project-status.yaml
+
+## Nguyên tắc
+- KHÔNG patch symptom, phải fix root cause
+- PHẢI có regression test case TRƯỚC khi fix
+- Bug status theo cùng flow Story: New -> Committed -> In Progress -> Deploy Test -> Verify Test -> Deploy Stag -> Verify Stag -> Deploy Prod -> Verify Prod -> Done
+- Bug Critical/High phải fix trước khi Feature được Verified

package/.claude/commands/tas-design.md

@@ -0,0 +1,31 @@
+# /tas-design $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Tạo hoặc cập nhật Design Specification document (UI/UX flows, wireframe descriptions).
+
+## Prerequisite
+- docs/prd.md phải tồn tại
+
+## Hành động
+1. Cần context từ root/tas.yaml và docs/prd.md
+2. Kiểm tra docs/design-spec.md đã tồn tại chưa:
+
+### Chế độ CREATE (file chưa tồn tại):
+3. Cần context từ .tas/templates/Design-Spec.md
+4. $ARGUMENTS là mô tả scope của design. Nếu không có, dựa vào PRD.
+5. Tạo file docs/design-spec.md chứa:
+   - User flows (Mermaid flowchart)
+   - Screen descriptions
+   - Navigation structure
+   - Interaction patterns
+   - Responsive behavior notes
+
+### Chế độ UPDATE (file đã tồn tại):
+3. Cần context từ docs/design-spec.md hiện tại
+4. $ARGUMENTS là mô tả thay đổi. Nếu không có, hỏi user cần cập nhật section nào.
+5. Cập nhật file, thêm changelog
+
+## Nguyên tắc
+- Focus vào flows và behavior, không vào pixel-perfect design
+- Mỗi screen cần mô tả: purpose, key elements, actions available
+- Mermaid tuân thủ: :::mermaid wrapper, không dùng ()

package/.claude/commands/tas-dev-story.md

@@ -0,0 +1,61 @@
+# /tas-dev-story $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Implement một User Story.
+
+## QUAN TRỌNG - Quy tắc đọc file
+- CHỈ đọc DUY NHẤT Story file. Không đọc thêm bất kỳ file nào khác.
+- KHÔNG đọc PRD, SAD, ADR, Design-Spec.
+- KHÔNG list thư mục, KHÔNG quét project structure.
+- KHÔNG đọc .tas/checklists/story-done.md ở bước đầu (chỉ đọc ở bước cuối).
+- Nếu cần tra cứu thêm, PHẢI hỏi user xác nhận trước khi đọc bất kỳ file nào.
+
+## Hành động
+1. $ARGUMENTS là Story ID hoặc file path. Nếu không có, quét docs/epics/**/Story-*.md tìm stories có status Committed.
+2. Đọc Story file.
+3. **Phân tích kiến trúc:**
+   - Kiểm tra vấn đề kỹ thuật đã được mô tả trong SAD/ADR chưa (qua section Context from SAD/ADR trong Story)
+   - Nếu có và không thay đổi kiến trúc → Chuyển sang implement, mô tả giải pháp thi công (API, DB, FE component, config...)
+   - Nếu chưa có hoặc là thay đổi kiến trúc lớn → **TẠO ADR mới**:
+     - Command: `/tas-adr "{Tiêu đề quyết định kiến trúc}"`
+     - Template: `.tas/templates/ADR.md`
+     - Điền đầy đủ: Context, Decision, Rationale, Alternatives, Consequences
+     - Trong section Consequences, thêm subsection **SAD Updates** liệt kê các thay đổi cần cập nhật vào SAD
+4. Bắt đầu implement dựa trên nội dung Story và ADR (nếu đã tạo).
+
+## Workflow
+### Nếu use_tdd = true trong root/tas.yaml:
+a. Viết test cases TRƯỚC (Red phase)
+   - Unit tests theo acceptance criteria trong Story
+   - Chạy tests, xác nhận FAIL
+b. Implement code (Green phase)
+   - Viết code tối thiểu để pass tests
+c. Refactor
+   - Clean up code
+   - Đảm bảo tests vẫn pass
+
+### Nếu use_tdd = false:
+a. Implement code theo acceptance criteria trong Story
+b. Viết unit tests cover các cases
+c. Chạy tests, fix nếu fail
+
+## Sau khi code xong
+3. Đọc .tas/checklists/story-done.md, verify từng mục, sau đó tick vào section ## Definition of Done trong file Story:
+   - `- [x] Code implemented` nếu đã implement xong
+   - `- [x] Unit tests pass` nếu tests đã chạy pass
+   - `- [x] No regression` nếu toàn bộ test suite pass
+   - `- [x] Documentation updated (if needed)` nếu đã cập nhật
+   - `- [ ] Code review passed` — KHÔNG tick, để sau khi chạy /tas-review-code
+   - `- [ ] Acceptance criteria verified` — KHÔNG tick, để PE verify
+4. Tạo commit message theo conventions trong CLAUDE.md
+5. Nhắc user: chạy /tas-review-code để review và tự test lại ở local trước khi chuyển status
+
+## Nguyên tắc
+- KHÔNG implement ngoài scope của Story
+- Mỗi public method PHẢI có XML doc comment
+- **Khi nào cần tạo ADR:**
+  - Thay đổi kiến trúc ảnh hưởng nhiều components
+  - Thêm mới design pattern hoặc framework
+  - Đổi data flow hoặc integration pattern
+  - Quyết định trade-off kỹ thuật quan trọng
+  - Thay đổi đã ảnh hưởng đến SAD

package/.claude/commands/tas-epic.md

@@ -0,0 +1,29 @@
+# /tas-epic $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Tạo mới hoặc cập nhật Epic document.
+
+## Prerequisite
+- docs/prd.md phải tồn tại
+
+## Hành động
+1. Cần context từ root/tas.yaml và docs/prd.md
+2. Cần context từ .tas/templates/Epic.md
+3. Xác định chế độ dựa vào $ARGUMENTS:
+
+### Chế độ CREATE ($ARGUMENTS là mô tả Epic mới, hoặc không có $ARGUMENTS):
+4. Nếu không có $ARGUMENTS, hỏi user mô tả Epic.
+5. Đọc project.code từ root/tas.yaml (ví dụ: "MP"). Quét docs/epics/ để xác định số thứ tự.
+6. Tạo thư mục docs/epics/{code}-Epic-{NNN}-{slug}/
+7. Tạo file docs/epics/{code}-Epic-{NNN}-{slug}/{code}-Epic-{NNN}-{slug}.md
+
+### Chế độ UPDATE ($ARGUMENTS là Epic ID, ví dụ: "Epic-001"):
+4. Tìm thư mục docs/epics/{code}-Epic-001-*/
+5. Cần context từ file Epic hiện tại
+6. Hỏi user cần thay đổi gì (cập nhật scope, thêm feature, đổi status...)
+7. Cập nhật file, thêm changelog
+
+## Nguyên tắc
+- Mỗi Epic map với một business capability trong PRD
+- Epic KHÔNG chứa chi tiết kỹ thuật, chỉ chứa business value
+- Ước lượng effort ở mức T-shirt size: S/M/L/XL

package/.claude/commands/tas-feature.md

@@ -0,0 +1,41 @@
+# /tas-feature $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Tạo mới hoặc cập nhật Feature document, bao gồm thiết kế Integration Test và E2E/Acceptance Test.
+
+## Prerequisite
+- Ít nhất một Epic phải tồn tại trong docs/epics/
+
+## Hành động
+1. Cần context từ root/tas.yaml
+2. Cần context từ .tas/templates/Feature.md
+3. Xác định chế độ dựa vào $ARGUMENTS:
+
+### Chế độ CREATE ($ARGUMENTS là mô tả Feature mới, hoặc không có $ARGUMENTS):
+4. Đọc project.code từ root/tas.yaml (ví dụ: "MP"). Liệt kê các Epic hiện có (quét docs/epics/{code}-Epic-*/), hỏi user Feature này thuộc Epic nào
+5. Quét thư mục Epic đã chọn để xác định số thứ tự Feature
+6. Tạo thư mục docs/epics/{code}-Epic-{NNN}-{slug}/{code}-Feature-{NNN}-{slug}/
+7. Tạo file {code}-Feature-{NNN}-{slug}.md trong thư mục đó
+8. Sau khi PE điền mô tả và acceptance criteria, TỰ ĐỘNG chuyển sang thiết kế test:
+   a. **Integration Test Cases**: Hỏi PE:
+      - "Feature này tương tác với service/module nào khác?"
+      - "Các flow liên kết giữa stories cần test những gì?"
+      - "Có data flow nào cần verify end-to-end trong feature này?"
+      Ghi vào section Integration Test Cases.
+   b. **E2E / Acceptance Test Cases**: Hỏi PE:
+      - "User scenario chính để verify feature này trên Staging là gì?"
+      - "Có scenario nào cần test với data thật hoặc gần thật?"
+      - "Acceptance criteria nào cần PE verify thủ công?"
+      Ghi vào section E2E Test Cases. Đây là checklist PE dùng ở Phase 2 khi chạy /tas-verify.
+
+### Chế độ UPDATE ($ARGUMENTS là Feature ID, ví dụ: "Feature-003"):
+4. Tìm file Feature trong cây docs/epics/ (dùng glob)
+5. Cần context từ file Feature hiện tại
+6. Hỏi user cần thay đổi gì (thêm story, cập nhật AC, thêm test cases, đổi status...)
+7. Cập nhật file, thêm changelog
+
+## Nguyên tắc
+- Feature là một chức năng cụ thể, có thể demo được
+- Feature PHẢI có acceptance criteria rõ ràng, testable
+- Integration Test Cases PHẢI cover các flow liên kết giữa stories
+- E2E Test Cases PHẢI đủ để PE verify feature trên Staging ở Phase 2

package/.claude/commands/tas-init.md

@@ -0,0 +1,17 @@
+# /tas-init
+
+Khởi tạo bộ TAS cho dự án hiện tại.
+
+## Hành động
+1. Cần context từ root/tas.yaml. Nếu chưa có, copy từ .tas/tas-example.yaml ra root và hỏi user điền thông tin cần thiết.
+2. Tạo cấu trúc thư mục: .tas/templates/, .tas/checklists/, docs/, docs/adr/, docs/epics/, docs/bugs/
+3. Tạo file root/project-status.yaml với trạng thái ban đầu (artifacts, epics, adrs đều rỗng).
+4. Copy các template mặc định vào .tas/templates/ nếu chưa có.
+5. Nếu project type là brownfield và codebase_scan_on_init = true:
+   - Quét codebase hiện tại
+   - Tạo file docs/codebase-overview.md tóm tắt kiến trúc hiện có
+6. Hiển thị trạng thái: project type, team roles, workflow phases đang bật.
+
+## Lưu ý
+- KHÔNG tạo lại file nếu đã tồn tại
+- Hỏi xác nhận trước khi thực hiện

package/.claude/commands/tas-prd.md

@@ -0,0 +1,31 @@
+# /tas-prd $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Tạo hoặc cập nhật Product Requirements Document.
+
+## Hành động
+1. Cần context từ root/tas.yaml để lấy project context
+2. Kiểm tra docs/prd.md đã tồn tại chưa:
+
+### Chế độ CREATE (file chưa tồn tại):
+3. Cần context từ .tas/templates/PRD.md
+4. Nếu $ARGUMENTS có nội dung, dùng làm input mô tả sản phẩm
+5. Nếu không có $ARGUMENTS, hỏi user:
+   - Sản phẩm giải quyết vấn đề gì?
+   - Đối tượng người dùng chính?
+   - Các tính năng cốt lõi?
+   - Ràng buộc kỹ thuật/kinh doanh?
+6. Tạo file docs/prd.md theo template
+
+### Chế độ UPDATE (file đã tồn tại):
+3. Cần context từ docs/prd.md hiện tại
+4. $ARGUMENTS là mô tả thay đổi. Nếu không có, hỏi user cần cập nhật section nào.
+5. Cập nhật file, giữ nguyên các section không thay đổi
+6. Thêm dòng vào section Changelog cuối file: ngày, mô tả thay đổi
+
+## Nguyên tắc
+- Viết ở mức đủ chi tiết để SE có thể hiểu và thiết kế kiến trúc
+- Phân loại requirements theo MoSCoW: Must/Should/Could/Won't
+- Mỗi requirement có ID duy nhất: FR-001, NFR-001
+- Luôn có section Non-Goals để giới hạn scope
+- Sơ đồ Mermaid phải dùng :::mermaid wrapper, KHÔNG dùng ký tự ()

package/.claude/commands/tas-review-code.md

@@ -0,0 +1,42 @@
+# /tas-review-code $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Review code thay đổi gần nhất hoặc một file/PR cụ thể.
+
+## Hành động
+1. Cần context từ root/tas.yaml và .tas/checklists/code-review.md
+2. $ARGUMENTS có thể là: file path, hoặc để trống (review git diff)
+3. Nếu $ARGUMENTS trống: lấy git diff của staged changes hoặc last commit
+4. Review theo checklist:
+   - Naming conventions
+   - Architecture alignment (so với SAD)
+   - Error handling
+   - Security concerns
+   - Test coverage
+   - Performance implications
+5. Output: danh sách findings phân loại theo severity (Critical/Major/Minor/Info)
+
+## Sau khi review
+6. Nếu có findings Critical/Major: liệt kê rõ, yêu cầu human fix trước khi tiếp tục.
+7. Khi human xác nhận đã fix hết tất cả issues:
+   - Tick `- [x] Code review passed` trong section ## Definition of Done của file Story
+8. Hỏi: "Bạn đã tự test lại ở local chưa? Nếu OK, có muốn chuyển ticket sang Deploy Test không?"
+9. Nếu human xác nhận Yes, cập nhật file Story:
+   a. Dòng **Status:** trong header → Deploy Test
+   b. Cập nhật Technical notes nếu có thay đổi phát sinh trong quá trình review
+   c. Thêm dòng vào section Changelog trong Story: ngày, "Code review passed, moved to Deploy Test"
+10. Cập nhật Story trên ADO:
+   - Chạy /ado-update story <ado-id> --status "Deploy Test" để push nội dung mới nhất và đổi state
+11. Cập nhật file Feature cha:
+   a. Dòng **Status:** trong header → In Progress
+   b. Cột Status của Story trong bảng ## User Stories → Deploy Test
+   c. Thêm dòng Changelog trong Feature: ngày, "Story <id> moved to Deploy Test"
+12. Cập nhật Feature trên ADO:
+   - Chạy /ado-update feature <feature-ado-id> --status "In Progress" để push nội dung mới nhất và đổi state
+13. Cập nhật root/project-status.yaml: Story → Deploy Test, Feature → In Progress
+
+## Nguyên tắc
+- Review khách quan, chỉ ra cụ thể dòng code và lý do
+- Đề xuất fix cụ thể, không chỉ nói "code xấu"
+- Check xem code có vi phạm ADR nào không
+- KHÔNG tự động chuyển status mà không có xác nhận của human

package/.claude/commands/tas-sad.md

@@ -0,0 +1,37 @@
+# /tas-sad $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Tạo hoặc cập nhật Solution Architecture Document.
+
+## Prerequisite
+- docs/prd.md phải tồn tại. Nếu chưa có, thông báo user chạy /tas-prd trước.
+
+## Hành động
+1. Cần context từ root/tas.yaml để lấy project info, workflow config
+2. Cần context từ docs/prd.md để hiểu requirements
+3. Nếu brownfield: cần context từ docs/codebase-overview.md nếu có
+4. Kiểm tra docs/sad.md đã tồn tại chưa:
+
+### Chế độ CREATE (file chưa tồn tại):
+5. Cần context từ .tas/templates/SAD.md
+6. Tạo file docs/sad.md theo template SAD của Torus
+
+### Chế độ UPDATE (file đã tồn tại):
+5. Cần context từ docs/sad.md hiện tại
+6. $ARGUMENTS là mô tả thay đổi. Nếu không có, hỏi user cần cập nhật section nào.
+7. Cập nhật file, giữ nguyên các section không thay đổi
+8. Thêm dòng vào section Changelog cuối file
+9. Nếu thay đổi là quyết định kiến trúc quan trọng, gợi ý user chạy /tas-adr
+
+## Quy tắc Mermaid
+- Các sơ đồ C4 PHẢI dùng Mermaid flow diagram
+- Bắt đầu bằng :::mermaid, kết thúc bằng :::
+- KHÔNG dùng ký tự () trong node labels, thay bằng []
+- Ví dụ: A["Web App"] --> B["API Gateway"]
+- Bao gồm các view: System Context, Container, Component, Data, Deployment
+
+## Nguyên tắc
+- SAD phải align với tech stack trong CLAUDE.md
+- Mỗi architectural decision quan trọng cần reference sang ADR
+- ERD phải dùng Mermaid erDiagram
+- Sequence diagram dùng Mermaid sequenceDiagram

package/.claude/commands/tas-security-check.md

@@ -0,0 +1,30 @@
+# /tas-security-check $ARGUMENTS
+
+Vai trò: DSE - DevSecOps Engineer
+Kiểm tra bảo mật codebase, lưu báo cáo vào docs/security-report.md.
+
+## Hành động
+1. Cần context từ .tas/checklists/security.md
+2. $ARGUMENTS có thể là: file path, hoặc để trống (scan toàn bộ)
+3. Kiểm tra theo OWASP Top 10:
+   - SQL Injection
+   - XSS
+   - Authentication/Authorization issues
+   - Sensitive data exposure
+   - Security misconfiguration
+   - Insecure deserialization
+4. Kiểm tra thêm cho .NET:
+   - Anti-forgery tokens
+   - CORS configuration
+   - Connection string exposure
+   - Proper use of Data Protection API
+5. Kiểm tra docs/security-report.md đã tồn tại chưa:
+   - Chưa có: tạo mới theo template
+   - Đã có: append thêm report mới, cập nhật status findings cũ nếu đã fix
+6. Lưu output vào docs/security-report.md
+7. Cập nhật root/project-status.yaml: artifacts.security_report
+
+## Nguyên tắc
+- Phân loại: Critical/High/Medium/Low
+- Mỗi finding phải có recommended fix cụ thể
+- Finding có status: Open | In Progress | Fixed | Accepted Risk

package/.claude/commands/tas-status.md

@@ -0,0 +1,16 @@
+# /tas-status
+
+Kiểm tra trạng thái hiện tại của dự án TAS.
+
+## Hành động
+1. Cần context từ root/project-status.yaml (CHỈ đọc file này, KHÔNG quét thư mục docs/)
+2. Cần context từ root/tas.yaml để biết workflow config
+3. Dựa vào project-status.yaml, tổng hợp:
+   - Số lượng artifacts đã tạo và status
+   - Số lượng epics/features/stories theo từng status
+   - Phase hiện tại dựa trên trạng thái tổng hợp
+4. Hiển thị bảng trạng thái phases và chi tiết stories theo status.
+
+## Lưu ý
+- Đây là command chỉ đọc, không thay đổi gì
+- Nếu nghi ngờ project-status.yaml lệch thực tế, user có thể chạy /tas-init để quét lại và đồng bộ