@torus-engineering/tas-kit 1.5.0

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

@@ -0,0 +1,50 @@
+# /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ừ root/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. Đọc project.code từ root/tas.yaml (ví dụ: "MP"). Liệt kê Features hiện có (quét docs/epics/{code}-Epic-*/{code}-Feature-*/), hỏi user Story thuộc Feature nào
+5. **Đọc đầy đủ context để trích xuất thông tin vào Story:**
+   - Đọc Feature đã chọn
+   - Đọc PRD (nếu có)
+   - Đọc SAD (nếu có)
+   - Đọc ADRs liên quan (nếu 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 phải NHÚNG TẤT CẢ thông tin cần thiết** để SE khi coding chỉ cần đọc file Story này, KHÔNG cần đọc lại file nào khác:
+   - 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, constraints từ SAD/ADR
+   - Context từ PRD (chỉ thêm section nếu có business requirements đặc biệt)
+   - Context từ SAD/ADR (chỉ thêm section nếu có architecture decisions, patterns cần tuân thủ)
+   - Prerequisites từ Feature (chỉ thêm section nếu có dependency)
+   - Unit Test Cases
+   - 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
+- **Single Source of Truth:** Story file phải chứa TẤT CẢ thông tin cần thiết từ PRD, SAD, ADR, Feature. SE khi coding chỉ cần đọc file Story-*.md, KHÔNG cần đọc lại file nào khác để tiết kiệm token.
+- Chỉ nhúng thông tin liên quan, không dư thừa - linh hoạt theo từng Story
+- 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

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

@@ -0,0 +1,33 @@
+# /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ừ root/tas.yaml
+2. $ARGUMENTS là Feature ID. Nếu không có, liệt kê features có status "Ready To Verify".
+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 có 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ê bugs
+8. Cập nhật root/project-status.yaml
+
+## 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 Bug để track
+- Feature chỉ được chuyển sang Phase 3 (Deploy) khi status = "Verified"

package/.claude/settings.json

@@ -0,0 +1,21 @@
+{
+  "permissions": {
+    "allow": [
+      "Read:*",
+      "Write:*",
+      "Edit:*",
+      "Bash:git:*",
+      "Bash:python:*",
+      "Bash:python3:*",
+      "Bash:dotnet:*",
+      "Bash:npm:*",
+      "Bash:node:*",
+      "Bash:az:*"
+    ],
+    "deny": [
+      "Bash:sudo:*",
+      "Read:**/.env",
+      "Read:**/*.env"
+    ]
+  }
+}

package/.claude/skills/ado-integration/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: ado-integration
+description: |
+  Azure DevOps integration. Auto-invoke khi user nhắc đến:
+  sync ADO, push to board, pull work item, update status on ADO,
+  create work item on ADO, hoặc bất kỳ thao tác liên quan Azure DevOps.
+allowed-tools: Read, Write, Edit, Bash, Grep
+---
+
+# ADO Integration Skill
+
+Cho phép đồng bộ hai chiều giữa file .md trong repo và work items trên Azure DevOps.
+
+## Prerequisites
+- Azure CLI + extension azure-devops: `az extension add --name azure-devops --upgrade`
+- Python 3.8+ với pyyaml: `pip install pyyaml`
+- PAT trong file .env: `AzureDevops_Personal_AccessToken=your-pat-here`
+
+## Commands
+Tất cả ADO commands chạy qua: `python .tas/tools/tas-ado.py <command> [args]`
+
+Hoặc dùng slash commands:
+- `/ado-create <type> <temp-id> [--parent-id <id>]`
+- `/ado-get <ado-id>`
+- `/ado-update <type> <ado-id> [--assign <name>] [--status <state>]`
+- `/ado-status <ado-id> --status <state>`
+- `/ado-delete <type> <ado-id>`
+
+## File Convention
+- Tên file: `{type}-{ado_id}-{slug-title}.md`
+- Mỗi file có frontmatter YAML: ado_id, ado_type, ado_state, last_ado_sync
+- File .md là single source of truth, sync lên ADO khi cần

package/.claude/skills/tas-conventions/SKILL.md

@@ -0,0 +1,17 @@
+---
+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
+---
+
+# TAS Conventions
+
+Khi generate hoặc review code, PHẢI tuân thủ conventions được định nghĩa trong CLAUDE.md của project.
+
+## Checklist
+- Đọc CLAUDE.md để lấy naming conventions, branching, commit format
+- Enforce các conventions đó trong code output
+- Nếu code vi phạm conventions, chỉ ra cụ thể

package/.claude/skills/tas-tdd/SKILL.md

@@ -0,0 +1,26 @@
+---
+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
+---
+
+# TAS TDD Workflow
+
+Khi use_tdd=true trong tas.yaml, enforce Red-Green-Refactor cycle:
+
+## Red Phase
+1. Viết test case TRƯỚC dựa trên acceptance criteria trong Story
+2. Chạy test, xác nhận FAIL
+3. KHÔNG viết implementation code ở phase này
+
+## Green Phase
+1. Viết code TỐI THIỂU để pass tests
+2. Chạy test, xác nhận PASS
+3. KHÔNG refactor ở phase này
+
+## Refactor Phase
+1. Clean up code, loại bỏ duplication
+2. Chạy test, xác nhận vẫn PASS
+3. Commit sau mỗi refactor thành công

package/.env.example

@@ -0,0 +1 @@
+AZURE_DEVOPS_PAT=your-pat-here