@torus-engineering/tas-kit 1.5.0

package/.tas/README.md

@@ -0,0 +1,1583 @@
+# Torus-Agentic-SDLC (TAS) Kit - Thiết kế chi tiết
+
+> **Version:** 1.5
+> **Author:** Torus BelleSoft Architecture Team
+> **Purpose:** Bộ kit Claude Code skills/commands cho quy trình SDLC hiện đại
+
+---
+
+## 1. Tổng quan kiến trúc
+
+### 1.1 Triết lý thiết kế
+
+TAS lấy ý tưởng từ BMAD (workflow agent theo role) và Superpowers (skills có phương pháp luận) nhưng thiết kế lại hoàn toàn theo nguyên tắc:
+
+- **Gọn nhẹ**: Mỗi skill < 3KB, tổng kit < 50KB. Không load thừa context.
+- **Context-aware**: Story.md là context digest đã hấp thụ toàn bộ thông tin từ PRD, SAD, ADR, Feature — mỗi session implement chỉ cần đọc CLAUDE.md + Story.md. Đây là Context Layer: đầu tư token ở phase thiết kế để tiết kiệm gấp nhiều lần ở phase code. Khi code PHẢI bắt đầu session mới (không tận dụng session cũ đã load PRD/SAD vì sẽ phình Window Context).
+- **Role-based**: 3 role thực tế của công ty (PE, SE, DSE) thay vì 12 agent giả lập.
+- **Template-driven**: SAD, ADR, PRD, Story dùng template riêng của Torus, cho phép custom.
+- **Flow-configurable**: File `tas.yaml` điều khiển flow theo từng dự án (greenfield/brownfield).
+- **AzureDevops-compatible**: Output Markdown tương thích Wiki, không dùng ký tự `()` trong Mermaid.
+
+### 1.2 Cấu trúc thư mục
+
+```
+your-project/
+├── CLAUDE.md                          # Project context (copy từ CLAUDE-Example.md)
+├── .env                               # PAT và secrets (trong .gitignore)
+├── .gitignore                         # Chứa .env
+├── .claude/
+│   ├── settings.json                  # Hooks configuration
+│   ├── commands/                      # Slash commands (thin wrappers)
+│   │   ├── tas-init.md                # /tas-init - Khởi tạo TAS trong project
+│   │   ├── tas-status.md              # /tas-status - Xem trạng thái workflow
+│   │   ├── tas-prd.md                 # /tas-prd - Tạo hoặc cập nhật PRD
+│   │   ├── tas-design.md              # /tas-design - Tạo hoặc cập nhật Design Spec
+│   │   ├── tas-epic.md                # /tas-epic - Tạo hoặc cập nhật Epic
+│   │   ├── tas-feature.md             # /tas-feature - Tạo hoặc cập nhật Feature
+│   │   ├── tas-story.md               # /tas-story - Tạo hoặc cập nhật Story
+│   │   ├── tas-sad.md                 # /tas-sad - Tạo hoặc cập nhật SAD
+│   │   ├── tas-adr.md                 # /tas-adr - Tạo hoặc cập nhật ADR
+│   │   ├── tas-dev-story.md           # /tas-dev-story - Implement story
+│   │   ├── tas-review-code.md         # /tas-review-code
+│   │   ├── tas-brainstorm.md          # /tas-brainstorm
+│   │   ├── tas-bug.md                 # /tas-bug - Bug lifecycle
+│   │   ├── tas-security-check.md      # /tas-security-check
+│   │   ├── tas-verify.md              # /tas-verify - PE verify Feature trên Staging
+│   │   ├── ado-create.md              # /ado-create - Tạo work item trên ADO
+│   │   ├── ado-get.md                 # /ado-get - Pull work item từ ADO
+│   │   ├── ado-update.md              # /ado-update - Cập nhật work item trên ADO
+│   │   ├── ado-status.md              # /ado-status - Quick update status trên ADO
+│   │   └── ado-delete.md              # /ado-delete - Xóa work item trên ADO
+│   │
+│   └── skills/                        # Auto-invocable skills
+│       ├── tas-conventions/
+│       │   └── SKILL.md               # Coding conventions, naming rules
+│       ├── tas-tdd/
+│       │   └── SKILL.md               # TDD workflow skill
+│       └── ado-integration/
+│           └── SKILL.md               # ADO sync skill
+│
+├── tas.yaml                           # Flow config per project (copy từ .tas/tas-example.yaml)
+├── .tas/                              # TAS kit (static, safe to overwrite on upgrade)
+│   ├── tas-example.yaml               # Reference template cho tas.yaml
+│   ├── project-status-example.yaml    # Reference template cho root/project-status.yaml
+│   ├── templates/
+│   │   ├── PRD.md
+│   │   ├── Design-Spec.md
+│   │   ├── Epic.md
+│   │   ├── Feature.md
+│   │   ├── Story.md
+│   │   ├── Bug.md
+│   │   ├── SAD.md
+│   │   ├── ADR.md
+│   │   ├── Security-Report.md
+│   │   └── Performance-Report.md
+│   ├── checklists/
+│   │   ├── story-done.md              # Definition of Done checklist
+│   │   ├── code-review.md             # Code review checklist
+│   │   └── security.md                # Security checklist
+│   └── tools/
+│       └── tas-ado.py                 # ADO integration Python script
+│
+├── project-status.yaml                # Trạng thái tổng hợp project (auto-updated)
+└── docs/                              # Generated artifacts
+    ├── bugs/                          # Bug tickets
+    │   ├── PROJ-Bug-001-login-error.md
+    │   └── PROJ-Bug-002-timeout.md
+    ├── prd.md
+    ├── design-spec.md
+    ├── sad.md
+    ├── security-report.md             # DSE: báo cáo security
+    ├── performance-report.md          # DSE: báo cáo performance (optional)
+    ├── adr/
+    │   ├── ADR-001-*.md
+    │   └── ADR-002-*.md
+    └── epics/
+        ├── Epic-001-user-management/
+        │   ├── Epic-001-user-management.md
+        │   ├── Feature-001-login/
+        │   │   ├── Feature-001-login.md
+        │   │   ├── Story-001-login-form.md
+        │   │   └── Story-002-forgot-password.md
+        │   └── Feature-002-registration/
+        │       ├── Feature-002-registration.md
+        │       └── Story-003-register-form.md
+        └── Epic-002-order/
+            ├── Epic-002-order.md
+            └── Feature-003-checkout/
+                ├── Feature-003-checkout.md
+                └── Story-004-cart-page.md
+```
+
+### 1.3 Cơ chế hoạt động
+
+```
+User gõ /tas-prd
+    │
+    ▼
+Command file (.claude/commands/tas-prd.md)
+    │  Chứa prompt ngắn: "Cần context từ config + template, tạo hoặc cập nhật PRD"
+    │
+    ▼
+Claude Code kiểm tra:
+    A. File docs/prd.md đã tồn tại?
+       → KHÔNG: Chế độ CREATE - tạo mới theo template
+       → CÓ: Chế độ UPDATE - đọc file hiện tại, hỏi user cần cập nhật gì,
+         giữ nguyên phần không thay đổi, ghi changelog cuối file
+    │
+    B. Context files (tas.yaml, templates, artifacts khác):
+       → Đọc file cần thiết cho command.
+    │
+    ▼
+Claude Code tạo/cập nhật artifact → docs/prd.md
+```
+
+**Ví dụ tiết kiệm token:** SE implement 10 stories (mỗi story 1 session mới):
+- Không có TAS: mỗi session đọc CLAUDE.md + PRD + SAD + ADR + Feature + Story = ~9,000 tokens → tổng 90,000 tokens.
+- Có TAS: Story.md đã digest sẵn context từ PRD/SAD/ADR → mỗi session chỉ đọc CLAUDE.md + Story.md = ~2,000 tokens → tổng 20,000 tokens.
+- Tiết kiệm ~78%. Lợi thế đến từ việc **đầu tư viết Story.md tốt ở phase thiết kế**, không phải từ việc tái dùng session cũ.
+
+---
+
+## 2. File cấu hình: tas.yaml
+
+File `tas.yaml` ở root dự án. CHỈ chứa flow và logic của TAS. Tech stack, coding conventions, build commands thuộc về CLAUDE.md. Tham khảo `.tas/tas-example.yaml` khi cần.
+
+```yaml
+# tas.yaml - TAS Project Configuration
+project:
+  name: "Project Name"
+  code: "PROJ"              # Prefix for file naming: PROJ-Epic-001, PROJ-Feature-001, etc.
+  type: greenfield          # greenfield | brownfield
+  description: "Mô tả ngắn về dự án"
+
+# Azure DevOps integration
+ado:
+  organization: "https://dev.azure.com/torus-bellesoft"
+  project_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+
+team:
+  - name: "Nguyen Van A"
+    role: pe                  # Product Engineer
+    ado_id: "nguyenvana@torus.vn"
+  - name: "Tran Van B"
+    role: se                  # Software Engineer
+    ado_id: "tranvanb@torus.vn"
+  - name: "Le Van C"
+    role: dse                 # DevSecOps Engineer
+    ado_id: "levanc@torus.vn"
+
+# Flow configuration - bật/tắt phase theo nhu cầu dự án
+workflow:
+  # Phase 0: Discovery & Design (Human-led, AI-powered)
+  # PE lead, SE hỗ trợ architecture. Tạo toàn bộ artifacts trước khi code.
+  # Gate: "Ready for Development" - PE xác nhận đủ PRD, SAD, Stories
+  discovery:
+    enabled: true
+    lead: pe
+    artifacts:
+      - prd
+      - design_spec
+      - sad
+      - adr
+      - epic
+      - feature
+      - story
+    gate: ready_for_development  # PE confirm trước khi sang Phase 1
+
+  # Phase 1: Develop (Orchestrated Agentic) → Môi trường Test
+  # SE implement stories, Claude Code orchestrate TDD + code review
+  develop:
+    enabled: true
+    lead: se
+    environment: test
+    use_tdd: true
+    auto_review: true
+
+  # Phase 2: Verify (Agentic + PE Review) → Môi trường Staging
+  # Per Feature: chạy integration test, PE verify acceptance criteria
+  # Gate: PE approved
+  verify:
+    enabled: true
+    lead: pe
+    environment: staging
+    auto_integration_test: true
+    gate: pe_approved
+
+  # Phase 3: Deploy with Feature Flag (Agentic) → Môi trường Prod
+  # DSE lead, deploy với feature flag, canary release
+  # Gate: PE approve production
+  deploy:
+    enabled: true
+    lead: dse
+    environment: production
+    feature_flag: true
+    gate: pe_approved_production
+
+  # Phase 4: Operate (Autonomous) → Môi trường Prod
+  # DSE lead, monitoring, auto-scaling, incident response
+  operate:
+    enabled: false             # Bật khi đã có monitoring setup
+    lead: dse
+    environment: production
+    security_check: true
+    performance_monitor: true
+
+# Brownfield-specific config
+brownfield:
+  existing_docs_path: "docs/"
+  codebase_scan_on_init: true
+
+# Template overrides (optional - chỉ định khi muốn dùng template khác default)
+templates:
+  sad: ".tas/templates/SAD.md"
+  adr: ".tas/templates/ADR.md"
+  prd: ".tas/templates/PRD.md"
+  epic: ".tas/templates/Epic.md"
+  feature: ".tas/templates/Feature.md"
+  story: ".tas/templates/Story.md"
+  bug: ".tas/templates/Bug.md"
+
+# Model mapping - chọn model phù hợp cho từng command để tối ưu chi phí
+models:
+  default: sonnet
+  commands:
+    tas-prd: sonnet
+    tas-design: sonnet
+    tas-sad: opus              # Kiến trúc cần suy luận sâu
+    tas-adr: opus              # Quyết định kiến trúc cần chất lượng cao
+    tas-epic: sonnet
+    tas-feature: sonnet
+    tas-story: sonnet
+    tas-dev-story: sonnet      # Code generation, Sonnet đủ tốt
+    tas-review-code: opus      # Review cần phân tích sâu
+    tas-brainstorm: opus       # Suy luận đa chiều
+    tas-bug: sonnet             # Fix code, Sonnet đủ tốt
+    tas-verify: haiku          # Chủ yếu đọc checklist, hỏi pass/fail
+    tas-status: haiku          # Chỉ đọc và format
+    tas-security-check: opus   # Security cần kỹ
+```
+
+---
+
+## 2.1 File trạng thái: project-status.yaml
+
+File `root/project-status.yaml` lưu trạng thái tổng hợp của toàn bộ project. Được auto-update bởi TAS commands, có thể sửa tay.
+
+```yaml
+# project-status.yaml - Auto-updated by TAS commands
+last_updated: "2026-03-12T10:30:00"
+
+artifacts:
+  prd:
+    status: done
+    path: "docs/prd.md"
+  design_spec:
+    status: done
+    path: "docs/design-spec.md"
+  sad:
+    status: in_progress
+    path: "docs/sad.md"
+
+adrs:
+  ADR-001:
+    title: "Use CQRS for Order Service"
+    status: Accepted
+    path: "docs/adr/ADR-001-use-cqrs.md"
+  ADR-002:
+    title: "JWT Authentication"
+    status: Proposed
+    path: "docs/adr/ADR-002-jwt-auth.md"
+
+bugs:
+  Bug-001:
+    title: "Login timeout on mobile"
+    severity: High
+    status: In Progress
+    path: "docs/bugs/PROJ-Bug-001-login-timeout.md"
+
+epics:
+  Epic-001:
+    title: "User Management"
+    status: In Progress
+    path: "docs/epics/Epic-001-user-management/"
+    features:
+      Feature-001:
+        title: "Login"
+        status: In Development
+        path: "docs/epics/Epic-001-user-management/Feature-001-login/"
+        stories:
+          Story-001:
+            title: "Login form"
+            status: In Progress
+            assigned: "tranvanb@torus.vn"
+          Story-002:
+            title: "Forgot password"
+            status: Committed
+            assigned: "tranvanb@torus.vn"
+      Feature-002:
+        title: "Registration"
+        status: New
+        path: "docs/epics/Epic-001-user-management/Feature-002-registration/"
+        stories: {}
+  Epic-002:
+    title: "Order Management"
+    status: Pending
+    path: "docs/epics/Epic-002-order/"
+    features: {}
+```
+
+**Nguyên tắc:**
+- File này là single source of truth cho trạng thái project
+- /tas-status CHỈ đọc file này, không quét thư mục
+- Mọi command thay đổi artifact/status PHẢI cập nhật file này (xem bảng chi tiết ở section 3)
+- Human có thể sửa tay khi cần (ví dụ: cập nhật status hàng loạt)
+- Nếu file bị lệch thực tế, chạy /tas-init để quét và đồng bộ lại
+
+---
+
+## 3. Chi tiết từng Command
+
+> **Quy tắc Context-Aware (áp dụng cho TẤT CẢ commands):**
+> Mỗi command phase code (/tas-dev-story, /tas-bug fix) PHẢI chạy trong session mới. Story.md đã chứa đủ context (Acceptance Criteria, Technical Notes, Unit Test Cases, references SAD/ADR) — KHÔNG cần đọc PRD, SAD, ADR, Feature trong session implement. Chỉ đọc thêm khi user yêu cầu cụ thể. Nguyên tắc này tránh phình Window Context do tích lũy artifact từ session cũ.
+
+> **Quy tắc Project Status (áp dụng cho TẤT CẢ commands có thay đổi artifact hoặc status):**
+> Sau khi hoàn thành tạo/cập nhật artifact hoặc thay đổi status, PHẢI cập nhật file `root/project-status.yaml` ngay lập tức. Cụ thể:
+>
+> | Command | Cập nhật gì trong project-status.yaml |
+> |---------|---------------------------------------|
+> | /tas-init | Tạo file mới với cấu trúc rỗng |
+> | /tas-prd | artifacts.prd: status + path |
+> | /tas-design | artifacts.design_spec: status + path |
+> | /tas-sad | artifacts.sad: status + path |
+> | /tas-adr | adrs.ADR-{NNN}: title + status |
+> | /tas-epic | epics.Epic-{NNN}: title + status + path, tạo features rỗng |
+> | /tas-feature | epics.Epic-{NNN}.features.Feature-{NNN}: title + status + path, tạo stories rỗng |
+> | /tas-story | epics...stories.Story-{NNN}: title + status + assigned |
+> | /tas-dev-story | Story status: Committed → In Progress → (done) cập nhật theo progress |
+> | /tas-verify | Feature status: Ready To Verify → Verified (hoặc giữ nguyên nếu fail). Story status cập nhật tương ứng. |
+> | /tas-bug | Tạo mới: thêm bug entry trong Feature. Update: cập nhật bug status theo lifecycle. |
+> | /tas-security-check | artifacts.security_report: status + path + last_scan date |
+>
+> Luôn cập nhật `last_updated` timestamp. Quy tắc này đảm bảo /tas-status chỉ cần đọc 1 file duy nhất thay vì quét toàn bộ thư mục.
+
+> **Quy tắc Model Selection (áp dụng cho TẤT CẢ commands):**
+> Trước khi thực thi command, đọc `models.commands` trong tas.yaml để xác định model phù hợp. Nếu command không có trong danh sách thì dùng `models.default`. KHÔNG ghi model trong từng command prompt để tránh trùng lặp.
+
+### 3.1 /tas-init - Khởi tạo TAS
+
+```markdown
+# /tas-init
+
+Khởi tạo bộ TAS cho dự án hiện tại.
+
+## Hành động
+1. Cần context từ tas.yaml ở root. 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/
+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
+```
+
+### 3.2 /tas-status - Xem trạng thái
+
+```markdown
+# /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ừ 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:
+
+| Phase | Status | Lead | Environment | Gate | Next Action |
+|-------|--------|------|-------------|------|-------------|
+| 0 - Discovery & Design | Done | PE | - | Ready for Dev | - |
+| 1 - Develop | In Progress | SE | Test | - | Implement Story-003 |
+| 2 - Verify | Not Started | PE | Staging | PE Approved | Chờ Feature hoàn thành |
+| 3 - Deploy | Not Started | DSE | Production | PE Approved Prod | - |
+| 4 - Operate | Disabled | DSE | Production | - | - |
+
+5. Hiển thị chi tiết stories theo status:
+   - Committed: {count} stories chờ implement
+   - In Progress: {count} stories đang làm
+   - Deploy Test: {count} stories chờ deploy test
+   - ...
+
+## 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ộ
+```
+
+### 3.3 /tas-prd - PRD
+
+```markdown
+# /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ừ 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ự ()
+```
+
+### 3.4 /tas-sad - SAD
+
+```markdown
+# /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ừ 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
+```
+
+### 3.5 /tas-adr - ADR
+
+```markdown
+# /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ừ 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 ()
+```
+
+### 3.6 /tas-epic - Epic
+
+```markdown
+# /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ừ 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ừ 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/Epic-001-*/
+5. Cần context từ file Epic hiện tại
+5. Hỏi user cần thay đổi gì (cập nhật scope, thêm feature, đổi status...)
+6. 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
+```
+
+### 3.7 /tas-feature - Feature
+
+```markdown
+# /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ừ 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ừ 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 docs/epics/{code}-Epic-{NNN}-{slug}/{code}-Feature-{NNN}-{slug}/{code}-Feature-{NNN}-{slug}.md
+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 trong Feature.
+   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 trong Feature.
+      Đâ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
+```
+
+### 3.8 /tas-story - Story
+
+```markdown
+# /tas-story $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Tạo mới hoặc cập nhật User Story document.
+
+## Prerequisite
+- Ít nhất một Feature phải tồn tại
+
+## Hành động
+1. Cần context từ tas.yaml
+2. Cần context từ .tas/templates/Story.md
+3. Xác định chế độ dựa vào $ARGUMENTS:
+
+### Chế độ CREATE ($ARGUMENTS là mô tả Story mới, hoặc không có $ARGUMENTS):
+4. Liệt kê Features hiện có (quét docs/epics/Epic-*/Feature-*/), hỏi user Story thuộc Feature nào
+5. Nếu docs/sad.md tồn tại, cần context từ SAD để hiểu kiến trúc
+6. Quét thư mục Feature đã chọn để xác định số thứ tự Story
+7. Tạo file docs/epics/{code}-Epic-{NNN}-{slug}/{code}-Feature-{NNN}-{slug}/{code}-Story-{NNN}-{slug}.md
+8. Story chứa:
+   - User story format: "As a [role], I want [goal], so that [benefit]"
+   - Acceptance criteria (Given/When/Then format)
+   - Technical notes: files cần thay đổi, patterns áp dụng
+   - Unit Test Cases (xem bên dưới)
+   - Definition of Done checklist
+9. **Test Case Prompting**: Sau khi PE điền acceptance criteria, TỰ ĐỘNG hỏi thêm:
+   - "Ngoài happy path, có edge case nào cần test không?" (ví dụ: input rỗng, giá trị biên, concurrent access)
+   - "Có negative case nào cần cover?" (ví dụ: unauthorized, invalid data, timeout)
+   - "Có dependency nào cần mock khi test?" (ví dụ: external API, database state)
+   Ghi tất cả vào section Unit Test Cases trong Story.
+
+### Chế độ UPDATE ($ARGUMENTS là Story ID, ví dụ: "Story-005"):
+4. Tìm file Story trong cây docs/epics/ (dùng glob)
+5. Cần context từ file Story hiện tại
+6. Hỏi user cần thay đổi gì (cập nhật AC, đổi status, thêm test cases...)
+7. Cập nhật file, thêm changelog
+
+## Nguyên tắc
+- Story phải nhỏ đủ để hoàn thành trong 1-3 ngày
+- PHẢI có acceptance criteria dạng Given/When/Then
+- Technical notes phải reference đến SAD/ADR nếu liên quan
+- Unit Test Cases PHẢI cover: happy path, edge cases, negative cases
+- Story status: New → Committed → In Progress → Deploy Test → Verify Test → Deploy Stag → Verify Stag → Deploy Prod → Verify Prod → Done
+```
+
+### 3.9 /tas-dev-story - Implement Story
+
+```markdown
+# /tas-dev-story $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Implement một User Story.
+
+## Hành động
+1. Cần context từ tas.yaml
+2. $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.
+3. Cần context từ Story file để hiểu requirements (CHỈ đọc Story file là đủ, KHÔNG đọc PRD, SAD, ADR, Design-Spec)
+4. Cần context từ .tas/checklists/story-done.md
+5. Nếu trong quá trình implement gặp vấn đề cần tra cứu kiến trúc hoặc requirements gốc, HỎI user xác nhận trước khi đọc thêm SAD/ADR/PRD
+
+## Workflow
+### Nếu use_tdd = true trong tas.yaml:
+a. Viết test cases TRƯỚC (Red phase)
+   - Unit tests theo acceptance criteria
+   - Chạy tests, xác nhận FAIL
+b. Implement code (Green phase)
+   - Viết code tối thiểu để pass tests
+   - Tuân thủ conventions trong CLAUDE.md
+c. Refactor
+   - Clean up code
+   - Đảm bảo tests vẫn pass
+
+### Nếu use_tdd = false:
+a. Implement code theo acceptance criteria
+b. Viết unit tests cover các cases
+c. Chạy tests, fix nếu fail
+
+6. Cập nhật Story status thành "Done" trong file Story
+7. Nếu auto_review = true, tự chạy code review theo .tas/checklists/code-review.md
+8. Tạo commit message theo conventions trong CLAUDE.md
+
+## Nguyên tắc
+- KHÔNG implement ngoài scope của Story
+- Code PHẢI follow naming conventions trong CLAUDE.md
+- Mỗi public method PHẢI có XML doc comment
+```
+
+### 3.10 /tas-review-code - Review Code
+
+```markdown
+# /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ừ 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)
+
+## 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
+```
+
+### 3.11 /tas-brainstorm - Brainstorm
+
+```markdown
+# /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-create-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
+```
+
+### 3.12 /tas-bug - Bug Lifecycle
+
+```markdown
+# /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ừ 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. Hỏi user:
+   - Bug thuộc Feature nào?
+   - 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 thư mục Feature đã chọn để xác định số thứ tự Bug
+6. Tạo file docs/epics/{code}-Epic-{NNN}-*/{code}-Feature-{NNN}-*/{code}-Bug-{NNN}-{slug}.md
+7. Bug status ban đầu: New
+8. Cập nhật project-status.yaml
+
+### Chế độ UPDATE ($ARGUMENTS là Bug ID, ví dụ: "Bug-001"):
+Tìm file Bug trong cây docs/epics/ (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 Bug file là đủ (đã có Root Cause Analysis, Regression Test Cases). KHÔNG đọc PRD, SAD, ADR, Design-Spec.
+5. Nếu trong quá trình fix gặp vấn đề cần tra cứu kiến trúc, HỎI user xác nhận trước khi đọc thêm SAD/ADR.
+6. 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
+6. Cập nhật status: Committed → In Progress → Deploy Test
+7. Cập nhật project-status.yaml
+8. 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
+```
+
+### 3.13 /tas-security-check - Security Check
+
+```markdown
+# /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
+```
+
+### 3.14 /tas-design - Design Spec
+
+```markdown
+# /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ừ 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 ()
+```
+
+### 3.15 /tas-verify - Verify Feature (Phase 2)
+
+```markdown
+# /tas-verify $ARGUMENTS
+
+Vai trò: PE - Product Engineer
+Verify Feature trên môi trường Staging (Phase 2).
+
+## Prerequisite
+- Feature phải có status "Ready To Verify"
+- Môi trường Staging phải sẵn sàng
+
+## Hành động
+1. Cần context từ tas.yaml
+2. $ARGUMENTS là Feature ID. Nếu không có, liệt kê features có stories đã Done.
+3. Tìm file Feature trong cây docs/epics/ (dùng glob)
+4. Cần context từ file Feature hiện tại (đặc biệt section Integration Test Cases và E2E Test Cases)
+
+### Workflow verify:
+5. Hiển thị checklist từ 2 section test trong Feature:
+   a. **Integration Test Cases**: Liệt kê từng test case, hỏi PE kết quả (Pass/Fail)
+   b. **E2E / Acceptance Test Cases**: Liệt kê từng test case, hỏi PE kết quả (Pass/Fail)
+6. Với mỗi test case FAIL:
+   - Hỏi PE mô tả lỗi
+   - Tự động tạo Bug trong thư mục Feature đó (dùng logic /tas-bug)
+   - Bug Story có tag "bug" và reference đến test case gốc
+7. Cập nhật file Feature:
+   - Ghi kết quả test (Pass/Fail + ngày) vào từng test case
+   - Nếu tất cả Pass: cập nhật Feature status thành "Verified"
+   - Nếu có Fail: giữ Feature status "Ready To Verify", liệt kê bug stories
+
+## Nguyên tắc
+- KHÔNG skip test case nào, phải verify hết
+- Bug phát hiện ở Phase 2 PHẢI được ghi thành Story để track
+- Feature chỉ được chuyển sang Phase 3 (Deploy) khi status = "Verified"
+```
+
+---
+
+## 4. Skills (Auto-invocable)
+
+### 4.1 tas-conventions
+
+```yaml
+---
+name: tas-conventions
+description: |
+  Coding conventions và naming rules của dự án Torus. 
+  Auto-invoke khi viết code mới, review code, refactor, 
+  hoặc khi user hỏi về coding standards.
+allowed-tools: Read, Grep, Glob
+---
+```
+
+Nội dung: Đọc conventions từ tas.yaml và enforce khi Claude Code generate/review code.
+
+### 4.2 tas-tdd
+
+```yaml
+---
+name: tas-tdd
+description: |
+  TDD workflow. Auto-invoke khi implement feature, 
+  write tests, hoặc khi use_tdd=true trong tas.yaml.
+allowed-tools: Read, Write, Edit, Bash, Grep
+---
+```
+
+Nội dung: Enforce Red-Green-Refactor cycle khi implement.
+
+---
+
+## 5. Templates mặc định
+
+### 5.1 Template SAD
+
+Dùng nguyên template từ repo https://github.com/liemqv/sad-adr-best-practices/blob/main/SAD-Template.md của anh Liêm, với các section:
+1. Executive Summary
+2. Architecture Vision
+3. Business Requirements
+4. Technology Baseline
+5. System Context - C4 Level 1
+6. Logical View - C4 Level 2
+7. Component View - C4 Level 3
+8. Data Architecture & ERD
+9. Integration & Data Flow
+10. Security Architecture
+11. Deployment View
+12. Non-Functional Requirements
+13. Architectural Decisions
+14. Risks & Mitigation
+
+**Quy tắc Mermaid cho AzureDevops Wiki:**
+- Wrap: `:::mermaid` ... `:::`
+- Node labels dùng `["text"]` thay vì `("text")`
+- KHÔNG dùng `()` trong bất kỳ node label nào
+
+### 5.2 Template ADR
+
+Dùng template từ repo https://github.com/liemqv/sad-adr-best-practices/blob/main/ADR-Template.md, gồm:
+1. Title & Metadata (ID, Status, Date, Author)
+2. Context
+3. Decision
+4. Rationale
+5. Consequences (Positive/Negative)
+6. Alternatives Considered
+7. Related ADRs
+
+### 5.3 Template PRD
+
+Dùng template từ https://github.com/ugur10/prd-template/blob/main/PRD_TEMPLATE.md, customize bỏ các section Go-to-Market vì Torus là outsource.
+
+### 5.4 Template Epic
+
+```markdown
+# Epic-{NNN}: {Title}
+
+> **Status:** New | Pending | In Design | In Progress | In Monitoring | In Closing | Done | Removed
+> **Owner:** {PE name}
+> **Created:** {Date}
+> **PRD Reference:** {link to PRD section}
+
+## Business Value
+{Mô tả giá trị kinh doanh}
+
+## Scope
+### In Scope
+- Item 1
+- Item 2
+
+### Out of Scope
+- Item 1
+
+## Acceptance Criteria (High-level)
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+## Features
+| ID | Feature | Priority | Estimate |
+|----|---------|----------|----------|
+| Feature-001 | {name} | Must | M |
+| Feature-002 | {name} | Should | L |
+
+## Dependencies
+- {dependency 1}
+
+## Risks
+- {risk 1}
+```
+
+### 5.5 Template Feature
+
+```markdown
+# Feature-{NNN}: {Title}
+
+> **Status:** New | Pending | In Design | In Progress | Ready for Dev | In Development | Ready To Verify | Verified | Done | Removed
+> **Epic:** Epic-{NNN}
+> **Owner:** {PE name}
+> **Created:** {Date}
+> **Verified Date:** {Date khi status = Verified}
+
+## Description
+{Mô tả chức năng}
+
+## User Stories
+| ID | Story | Priority | Estimate | Status |
+|----|-------|----------|----------|--------|
+| Story-001 | {name} | Must | S | Draft |
+
+## Acceptance Criteria
+- [ ] AC-1: {criteria}
+- [ ] AC-2: {criteria}
+
+## UI/UX Notes
+{Nếu có, reference đến design-spec.md}
+
+## Technical Notes
+{Nếu có, reference đến SAD/ADR}
+
+## Integration Test Cases
+PE thiết kế khi tạo Feature. SE implement trong code.
+
+| ID | Scenario | Expected Result | Status |
+|----|----------|-----------------|--------|
+| IT-1 | {Mô tả flow liên kết} | {Kết quả mong đợi} | - |
+| IT-2 | {Mô tả flow liên kết} | {Kết quả mong đợi} | - |
+
+## E2E / Acceptance Test Cases
+PE thiết kế khi tạo Feature. PE verify trên Staging ở Phase 2 bằng /tas-verify.
+
+| ID | User Scenario | Steps | Expected Result | Status | Verified Date |
+|----|---------------|-------|-----------------|--------|---------------|
+| E2E-1 | {Scenario} | {Bước thực hiện} | {Kết quả mong đợi} | - | - |
+| E2E-2 | {Scenario} | {Bước thực hiện} | {Kết quả mong đợi} | - | - |
+```
+
+### 5.6 Template Story
+
+```markdown
+# Story-{NNN}: {Title}
+
+> **Status:** New | Committed | In Progress | Deploy Test | Verify Test | Deploy Stag | Verify Stag | Deploy Prod | Verify Prod | Done
+> **Feature:** Feature-{NNN}
+> **Assigned to:** {SE name}
+> **Estimate:** {S/M/L}
+> **Created:** {Date}
+
+## User Story
+As a {role}, I want {goal}, so that {benefit}.
+
+## Acceptance Criteria
+### AC-1: {title}
+- **Given** {precondition}
+- **When** {action}
+- **Then** {expected result}
+
+### AC-2: {title}
+- **Given** {precondition}
+- **When** {action}
+- **Then** {expected result}
+
+## Technical Notes
+- **Files to modify:** {list}
+- **Patterns:** {reference to SAD/ADR}
+- **Database changes:** {if any}
+
+## Unit Test Cases
+SE implement trong code. PE thiết kế happy path + edge cases + negative cases khi tạo Story.
+
+### Happy Path
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-1 | {description} | {input} | {expected} |
+
+### Edge Cases
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-E1 | {description, ví dụ: input rỗng, giá trị biên} | {input} | {expected} |
+
+### Negative Cases
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-N1 | {description, ví dụ: unauthorized, invalid data} | {input} | {expected} |
+
+### Dependencies to Mock
+- {external API, database state, third-party service...}
+
+## Definition of Done
+- [ ] Code implemented
+- [ ] Unit tests pass
+- [ ] Code review passed
+- [ ] Acceptance criteria verified
+- [ ] No regression
+- [ ] Documentation updated (if needed)
+```
+
+### 5.7 Template Bug
+
+```markdown
+# Bug-{NNN}: {Title}
+
+> **Status:** New | Committed | In Progress | Deploy Test | Verify Test | Deploy Stag | Verify Stag | Deploy Prod | Verify Prod | Done
+> **Feature:** Feature-{NNN}
+> **Severity:** Critical | High | Medium | Low
+> **Found in:** Test | Staging | Production
+> **Found by:** {PE/SE name}
+> **Assigned to:** {SE name}
+> **Created:** {Date}
+
+## Description
+{Mô tả bug ngắn gọn}
+
+## Steps to Reproduce
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+## Expected Behavior
+{Kết quả mong đợi}
+
+## Actual Behavior
+{Kết quả thực tế}
+
+## Evidence
+{Screenshots, logs, error messages}
+
+## Root Cause Analysis
+*SE điền khi phân tích*
+- **Root Cause:** {Mô tả nguyên nhân gốc}
+- **Affected Files:** {Danh sách file liên quan}
+- **Impact Scope:** {Ảnh hưởng đến những chức năng nào khác}
+
+## Regression Test Cases
+*SE thiết kế trước khi fix*
+
+| ID | Description | Input | Expected | Status |
+|----|-------------|-------|----------|--------|
+| RT-1 | Reproduce bug case | {input} | {expected fail trước fix, pass sau fix} | - |
+| RT-2 | Related regression | {input} | {expected} | - |
+
+## Fix Notes
+*SE ghi sau khi fix*
+- **Fix Description:** {Mô tả cách fix}
+- **Files Changed:** {Danh sách file đã sửa}
+- **Commit:** {commit hash}
+
+## Verify Notes
+*PE ghi khi verify*
+
+| Date | Environment | Result | Verified by | Notes |
+|------|-------------|--------|-------------|-------|
+| {Date} | {env} | Pass/Fail | {PE name} | {notes} |
+```
+
+### 5.8 Template Security Report
+
+```markdown
+# Security Report
+
+> **Last Scan:** {Date}
+> **Scope:** {Full scan | File/Module specific}
+> **Scanned by:** {DSE name}
+
+## Summary
+| Severity | Open | Fixed | Accepted Risk | Total |
+|----------|------|-------|---------------|-------|
+| Critical | 0 | 0 | 0 | 0 |
+| High | 0 | 0 | 0 | 0 |
+| Medium | 0 | 0 | 0 | 0 |
+| Low | 0 | 0 | 0 | 0 |
+
+## Findings
+
+### SEC-001: {Title}
+- **Severity:** Critical | High | Medium | Low
+- **Status:** Open | In Progress | Fixed | Accepted Risk
+- **Location:** {file:line}
+- **Description:** {Mô tả vấn đề}
+- **Recommended Fix:** {Cách fix cụ thể}
+- **Fixed Date:** {Date, nếu đã fix}
+
+## Scan History
+| Date | Scope | New Findings | Fixed | Remaining |
+|------|-------|-------------|-------|-----------|
+| {Date} | {Scope} | {count} | {count} | {count} |
+```
+
+### 5.9 Template Performance Report
+
+```markdown
+# Performance Report
+
+> **Last Test:** {Date}
+> **Environment:** {Test | Staging | Production}
+> **Tested by:** {DSE name}
+
+## Baseline Metrics
+| Metric | Target | Actual | Status |
+|--------|--------|--------|--------|
+| API Response Time (p95) | < 200ms | {value} | Pass/Fail |
+| Throughput | > 1000 req/s | {value} | Pass/Fail |
+| Database Query (p95) | < 100ms | {value} | Pass/Fail |
+| Memory Usage | < 512MB | {value} | Pass/Fail |
+| CPU Usage (peak) | < 80% | {value} | Pass/Fail |
+
+## Bottlenecks
+| ID | Description | Impact | Recommendation | Status |
+|----|-------------|--------|----------------|--------|
+| PERF-001 | {description} | {impact} | {recommendation} | Open/Fixed |
+
+## Load Test Results
+- **Tool:** {k6 | JMeter | NBomber...}
+- **Scenario:** {description}
+- **Duration:** {minutes}
+- **Concurrent users:** {count}
+- **Results:** {summary}
+
+## Test History
+| Date | Environment | Result | Notes |
+|------|-------------|--------|-------|
+| {Date} | {env} | Pass/Fail | {notes} |
+```
+
+---
+
+## 6. Checklists
+
+### 6.1 Code Review Checklist (.tas/checklists/code-review.md)
+
+```markdown
+# Code Review Checklist
+
+## Architecture
+- [ ] Code align với SAD
+- [ ] Không vi phạm ADR nào
+- [ ] Đúng layer separation
+
+## Code Quality
+- [ ] Naming theo conventions trong CLAUDE.md
+- [ ] Không có magic numbers/strings
+- [ ] Error handling đầy đủ
+- [ ] Logging có ý nghĩa
+- [ ] Không có code duplication
+
+## Security
+- [ ] Input validation
+- [ ] No SQL injection risk
+- [ ] No XSS risk
+- [ ] Sensitive data không log
+
+## Testing
+- [ ] Unit tests cover happy path
+- [ ] Unit tests cover edge cases
+- [ ] Tests có assertion rõ ràng
+
+## Performance
+- [ ] Không có N+1 query
+- [ ] Async/await đúng cách
+- [ ] Dispose resources properly
+```
+
+### 6.2 Security Checklist (.tas/checklists/security.md)
+
+```markdown
+# Security Checklist - .NET Specific
+
+## Authentication & Authorization
+- [ ] JWT validation đúng
+- [ ] Role-based authorization
+- [ ] Anti-forgery token cho forms
+
+## Data Protection
+- [ ] Connection strings trong secrets, không hardcode
+- [ ] PII data encrypted at rest
+- [ ] HTTPS enforced
+
+## Input Validation
+- [ ] Model validation attributes
+- [ ] Parameterized queries (EF Core)
+- [ ] File upload validation
+
+## CORS & Headers
+- [ ] CORS policy restrictive
+- [ ] Security headers: X-Content-Type-Options, X-Frame-Options
+- [ ] HSTS enabled
+```
+
+---
+
+## 7. CLAUDE.md Integration
+
+Mẫu CLAUDE.md cho dự án dùng TAS. Lưu ý: tech stack, coding conventions, build commands thuộc về CLAUDE.md, KHÔNG ghi trong tas.yaml.
+
+```markdown
+# Project Context
+
+## Tech Stack
+- Backend: .NET 8, C#, Entity Framework Core
+- Frontend: Angular 17
+- Database: SQL Server 2022
+- Infrastructure: Azure App Service, Azure SQL
+- CI/CD: Azure DevOps Pipelines
+
+## Conventions
+- Branching: git-flow
+- Commit: conventional commits
+- Namespace: Torus.{ProjectName}.{Layer}
+- Naming: PascalCase for classes/methods, camelCase for variables
+- Test framework: xUnit
+
+## Legacy Patterns to Avoid (Brownfield)
+- Repository pattern without interface
+- Direct SQL queries in controllers
+
+## Mermaid Rules (AzureDevops Wiki)
+- Always wrap with :::mermaid and :::
+- NEVER use () in node labels, use [] instead
+- Example: A["Web App"] --> B["API Gateway"]
+
+## Build & Test
+- Build: dotnet build
+- Test: dotnet test
+- Lint: dotnet format --verify-no-changes
+
+## TAS Kit
+This project uses Torus-Agentic-SDLC (TAS) kit.
+- Flow config: tas.yaml
+- Templates: .tas/templates/
+- Generated docs: docs/
+
+## Key Rules
+- Architecture: see docs/sad.md
+- Decisions: see docs/adr/
+
+## Commands
+Type /tas-status to see current project state.
+Type /tas-[artifact] to create or update artifacts (prd, sad, adr, epic, feature, story, design).
+Type /tas-dev-story to implement a story.
+Type /tas-verify to verify a Feature on Staging (Phase 2).
+Type /tas-review-code, /tas-brainstorm, /tas-bug, /tas-security-check for dev workflows.
+```
+
+---
+
+## 8. Flow Greenfield vs Brownfield
+
+### Greenfield Flow
+```
+Phase 0: Discovery & Design (Human-led, AI-powered)
+├── /tas-init (type: greenfield)
+├── /tas-brainstorm (optional, product idea exploration)
+├── /tas-prd
+├── /tas-design (optional)
+├── /tas-sad
+├── /tas-adr (repeat per decision)
+├── /tas-epic (repeat per epic)
+├── /tas-feature (repeat per feature)
+└── /tas-story (repeat per story)
+    ↓ Gate: PE confirm "Ready for Development"
+
+Phase 1: Develop (Orchestrated Agentic) → Test
+├── /tas-dev-story (implement each story, TDD)
+├── /tas-review-code (auto hoặc manual)
+└── /tas-bug (nếu phát sinh)
+    ↓ Per Feature completed:
+
+Phase 2: Verify (Agentic + PE Review) → Staging
+├── /tas-verify (PE verify per Feature)
+├── Integration test chạy trên Staging
+├── PE verify acceptance criteria per Feature
+└── /tas-security-check
+    ↓ Gate: PE approved
+
+Phase 3: Deploy with Feature Flag → Production
+├── DSE deploy với feature flag
+├── Canary release, monitor
+└── PE approve bật feature flag
+    ↓ Gate: PE approved production
+
+Phase 4: Operate (Autonomous) → Production
+├── Monitoring, alerting
+├── Auto-scaling
+└── Incident response
+
+--- Sau Sprint 1, khi có change request ---
+Quay lại Phase 0:
+├── /tas-prd (UPDATE mode)
+├── /tas-sad (UPDATE mode nếu kiến trúc thay đổi)
+├── /tas-epic / /tas-feature / /tas-story (tạo mới hoặc cập nhật)
+└── Tiếp tục Phase 1 → 2 → 3 → 4
+```
+
+### Brownfield Flow
+```
+Phase 0: Discovery & Design
+├── /tas-init (type: brownfield, auto-scan codebase)
+├── /tas-brainstorm (explore improvement areas)
+├── /tas-adr (document decisions cho codebase hiện tại)
+├── /tas-epic (nếu feature set mới)
+├── /tas-story (smaller changes go direct to story)
+│
+│   --- Khi cần mở rộng ---
+├── /tas-prd (tạo hoặc cập nhật)
+├── /tas-sad (tạo hoặc cập nhật)
+└── /tas-epic / /tas-feature / /tas-story
+    ↓ Gate: PE confirm "Ready for Development"
+
+Phase 1: Develop → Test
+├── /tas-dev-story
+├── /tas-bug (bug fixes không cần full Phase 0)
+└── /tas-review-code
+    ↓ Per Feature:
+
+Phase 2 → 3 → 4: Giống Greenfield Flow
+```
+
+---
+
+## 9. Ước tính Token Cost
+
+| Component | Size | Khi nào load |
+|-----------|------|--------------|
+| tas.yaml | ~300 tokens | Lần đầu cần. Các lần sau lấy từ context. |
+| project-status.yaml | ~200-800 tokens | /tas-status đọc. Các command khác chỉ write, không cần read. |
+| Template (1 file) | ~800 tokens | Lần đầu tạo artifact loại đó. Các lần sau lấy từ context. |
+| Checklist (1 file) | ~300 tokens | Lần đầu review/check. Các lần sau lấy từ context. |
+| Command prompt | ~200 tokens | Mỗi lần gọi command (luôn load) |
+| Existing artifact (PRD, SAD...) | ~1000-3000 tokens | Lần đầu cần reference. Các lần sau lấy từ context. |
+
+**Cost phase thiết kế (1 lần/artifact)**: Story.md = 1,000-2,000 tokens context để tạo.
+**Cost phase code (mỗi session mới)**: CLAUDE.md + Story.md = ~2,000 tokens.
+**So sánh**: Không có TAS phải load CLAUDE.md + PRD + SAD + ADR + Feature + Story = ~9,000 tokens/session.
+
+**Ví dụ thực tế:** Implement 10 stories (mỗi story 1 session mới):
+- Không có TAS: 10 x 9,000 = 90,000 tokens
+- Có TAS (Context Layer): 10 x 2,000 = 20,000 tokens
+- Tiết kiệm: ~78% — nhờ Story.md đã digest sẵn context, KHÔNG nhờ tái dùng session cũ
+
+---
+
+## 9.1 ADO Integration
+
+### Prerequisites
+- Azure CLI + extension: `az extension add --name azure-devops --upgrade`
+- Python 3.8+ với pyyaml: `pip install pyyaml`
+- Tạo file `.env` ở root project (đã có trong .gitignore):
+  ```
+  AZURE_DEVOPS_PAT=your-pat-here
+  ```
+  PAT cần scope "Work Items (Full)"
+
+### Commands
+
+| Command | Cú pháp | Mô tả |
+|---------|---------|-------|
+| /ado-create | `<type> <temp-id> [--parent-id <id>]` | Tạo work item trên ADO từ file local |
+| /ado-get | `<ado-id>` | Pull work item từ ADO về file local |
+| /ado-update | `<type> <ado-id> [--assign <n>] [--status <s>]` | Cập nhật work item trên ADO |
+| /ado-status | `<ado-id> --status <state>` | Quick update status trên ADO |
+| /ado-delete | `<type> <ado-id>` | Xóa work item trên ADO (giữ file local) |
+
+Type: `epic | feature | story | bug`
+
+### Frontmatter YAML
+Mỗi file Epic/Feature/Story/Bug có frontmatter cho ADO sync:
+```yaml
+---
+ado_id: 5345
+ado_type: User Story
+ado_title: Login Form
+ado_state: In Progress
+ado_assigned_to: Tran Van B <tranvanb@torus.vn>
+ado_created: 2026-03-10
+last_ado_sync: 2026-03-17 15:42:08
+parent_ado_id: 456
+---
+```
+
+### Cơ chế hoạt động
+- File .md là single source of truth
+- Mỗi lần create/get/update thành công, `last_ado_sync` được cập nhật tự động
+- Khi create: file được rename từ temp-id sang ado-id thực
+- Khi delete: chỉ xóa trên ADO, file local giữ nguyên với state "Removed"
+- Script: `python .tas/tools/tas-ado.py <command> [args]`
+
+---
+
+## 10. Lộ trình triển khai
+
+### Triển khai Phase 1 - Phase 0 commands (Tuần 1-2)
+- tas-init, tas-status
+- tas-prd, tas-design, tas-sad, tas-adr
+- tas-epic, tas-feature, tas-story
+- tas-brainstorm
+- Tất cả templates + tas.yaml config
+
+### Triển khai Phase 2 - Phase 1 commands (Tuần 3-4)
+- tas-dev-story, tas-review-code, tas-bug
+- Checklists: code-review, story-done
+- Skills: tas-conventions, tas-tdd
+
+### Triển khai Phase 3 - Phase 2+3 commands (Tuần 5)
+- tas-security-check
+- Checklist: security
+- ADO integration: auto update work items
+
+### Triển khai Phase 4 - Phase 4 commands (Tuần 6+)
+- Monitoring integration
+- Performance testing template
+- Incident response workflow
+
+### Ongoing - Optimization
+- Đo lường token cost thực tế
+- Tinh chỉnh template/command dựa trên feedback team
+- Tạo hooks tự động (auto-lint, auto-test)
+
+---
+
+## 11. Changelog
+
+### v1.5 — 2026-03-22
+- **Thêm `CLAUDE.md`** cho TAS Kit repo: mô tả cấu trúc kit, hướng dẫn thêm/sửa command, skill, agent để Claude hiểu khi làm việc trên repo này
+- **Cập nhật `.claude/settings.json`**: mở rộng permissions — thêm `Write:*`, `Edit:*` (trước chỉ cho `*.md`), thêm `Bash` cho `python`, `dotnet`, `npm`, `node`, `az`; fix deny rule cho `.env` files
+- **Thêm `.claude/agents/`**: tạo mới thư mục agents với 2 specialized subagents
+  - `ado-agent.md`: chạy ADO operations trong isolated context, trả về structured result
+  - `code-reviewer.md`: review code isolated, output findings theo severity với file:line cụ thể
+- Cập nhật cấu trúc thư mục trong README phản ánh thêm `.claude/agents/`
+
+### v1.4 — (trước 2026-03-22)
+- Phiên bản ban đầu với 20 commands, 3 skills, ADO integration