@torus-engineering/tas-kit 1.7.0 → 1.9.0

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

@@ -1,31 +1,35 @@
-# /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. 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
-8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — thêm entry vào `epics`.
-
-### 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
-8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — cập nhật `epics.{EPIC_ID}.status`.
-
-## 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
+# /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. 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
+8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — thêm entry vào `epics`.
+
+### 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
+8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — cập nhật `epics.{EPIC_ID}.status`.
+
+## 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
+
+## Bước cuối — Token Log
+
+Invoke skill `token-logger`: ghi AI Usage Log vào file Epic đang làm việc.

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

@@ -1,43 +1,47 @@
-# /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. Liệt kê các Epic hiện có, 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.
-9. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — thêm entry vào `epics.{EPIC_ID}.features`.
-
-### 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
-8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — cập nhật `epics.{EPIC_ID}.features.{FEATURE_ID}.status`.
-
-## 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
+# /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. Liệt kê các Epic hiện có, 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.
+9. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — thêm entry vào `epics.{EPIC_ID}.features`.
+
+### 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
+8. Cập nhật `project-status.yaml` theo `.claude/rules/common/project-status.md` — cập nhật `epics.{EPIC_ID}.features.{FEATURE_ID}.status`.
+
+## 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
+
+## Bước cuối — Token Log
+
+Invoke skill `token-logger`: ghi AI Usage Log vào file Feature đang làm việc.

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

@@ -1,47 +1,51 @@
-# /tas-fix $ARGUMENTS
-
-Vai trò: SE - Software Engineer
-Quick fix cho bug nhỏ hoặc lỗi rõ ràng — không cần tạo ticket, không cần full lifecycle.
-Dùng khi: solo dev, hotfix nhanh, bug tìm thấy trong lúc dev.
-Khác với /tas-bug: không tạo Bug file, không track status, không deploy flow.
-
-## Stack Detection
-Đọc `.claude/rules/common/stack-detection.md`.
-
-## Hành động
-
-### 1. Hiểu bug
-$ARGUMENTS là mô tả lỗi, error message, hoặc file:line_number.
-- Nếu có error message/stack trace: parse ngay, xác định file và dòng lỗi
-- Nếu chỉ có mô tả: hỏi 1 câu duy nhất để làm rõ (reproduce steps hoặc expected vs actual)
-- KHÔNG hỏi nhiều hơn 1 câu
-
-### 2. Diagnose (tối đa 3 file đọc)
-- Đọc file lỗi và các file liên quan trực tiếp
-- Xác định root cause trong 1-2 câu ngắn
-- KHÔNG đọc toàn bộ project, KHÔNG quét cấu trúc folder
-- Nếu cần đọc thêm file ngoài 3 file đầu tiên: hỏi user xác nhận
-
-### 3. Fix với regression test
-
-Trước khi fix, đọc các rules liên quan:
-- `.claude/rules/common/security.md` — kiểm tra fix có tạo ra security risk không
-- `.claude/rules/common/testing.md` — pattern viết regression test
-- `.claude/rules/[lang_rules]/coding-style.md` — conventions của stack hiện tại (nếu xác định được)
-
-Sau đó:
-a. Viết 1 test case tối thiểu reproduce bug (nếu project có test framework)
-b. Xác nhận test FAIL
-c. Fix code đúng root cause
-d. Xác nhận test PASS
-e. Chạy nhanh test suite nếu có (để check regression)
-
-### 4. Wrap up
-- Output commit message: `fix: <mô tả ngắn gọn>`
-- Nhắc: "Nếu bug này có khả năng tái phát hoặc ảnh hưởng production, cân nhắc dùng /tas-bug để track đầy đủ."
-
-## Nguyên tắc
-- Tổng số file đọc ≤ 3 trừ khi được cho phép
-- Fix đúng root cause, KHÔNG patch symptom
-- Nếu fix kéo theo thay đổi architecture → dừng, gợi ý dùng /tas-bug + /tas-adr
-- Nếu bug thuộc production và severity cao → dừng, gợi ý dùng /tas-bug với severity Critical/High
+# /tas-fix $ARGUMENTS
+
+Vai trò: SE - Software Engineer
+Quick fix cho bug nhỏ hoặc lỗi rõ ràng — không cần tạo ticket, không cần full lifecycle.
+Dùng khi: solo dev, hotfix nhanh, bug tìm thấy trong lúc dev.
+Khác với /tas-bug: không tạo Bug file, không track status, không deploy flow.
+
+## Stack Detection
+Đọc `.claude/rules/common/stack-detection.md`.
+
+## Hành động
+
+### 1. Hiểu bug
+$ARGUMENTS là mô tả lỗi, error message, hoặc file:line_number.
+- Nếu có error message/stack trace: parse ngay, xác định file và dòng lỗi
+- Nếu chỉ có mô tả: hỏi 1 câu duy nhất để làm rõ (reproduce steps hoặc expected vs actual)
+- KHÔNG hỏi nhiều hơn 1 câu
+
+### 2. Diagnose (tối đa 3 file đọc)
+- Đọc file lỗi và các file liên quan trực tiếp
+- Xác định root cause trong 1-2 câu ngắn
+- KHÔNG đọc toàn bộ project, KHÔNG quét cấu trúc folder
+- Nếu cần đọc thêm file ngoài 3 file đầu tiên: hỏi user xác nhận
+
+### 3. Fix với regression test
+
+Trước khi fix, đọc các rules liên quan:
+- `.claude/rules/common/security.md` — kiểm tra fix có tạo ra security risk không
+- `.claude/rules/common/testing.md` — pattern viết regression test
+- `.claude/rules/[lang_rules]/coding-style.md` — conventions của stack hiện tại (nếu xác định được)
+
+Sau đó:
+a. Viết 1 test case tối thiểu reproduce bug (nếu project có test framework)
+b. Xác nhận test FAIL
+c. Fix code đúng root cause
+d. Xác nhận test PASS
+e. Chạy nhanh test suite nếu có (để check regression)
+
+### 4. Wrap up
+- Output commit message: `fix: <mô tả ngắn gọn>`
+- Nhắc: "Nếu bug này có khả năng tái phát hoặc ảnh hưởng production, cân nhắc dùng /tas-bug để track đầy đủ."
+
+## Nguyên tắc
+- Tổng số file đọc ≤ 3 trừ khi được cho phép
+- Fix đúng root cause, KHÔNG patch symptom
+- Nếu fix kéo theo thay đổi architecture → dừng, gợi ý dùng /tas-bug + /tas-adr
+- Nếu bug thuộc production và severity cao → dừng, gợi ý dùng /tas-bug với severity Critical/High
+
+## Bước cuối — Token Log
+
+Invoke skill `token-logger`: ghi AI Usage Log vào file Story hoặc Bug liên quan (nếu có).

package/.claude/commands/tas-functest-mobile.md

@@ -0,0 +1,144 @@
+# /tas-functest-mobile $ARGUMENTS
+
+Vai tro: SE / QA
+Generate tat ca Detox automation test scripts cho mot mobile Feature.
+
+## QUAN TRONG - Layer 2: Mobile Functional Test Scripts
+- Tao Detox test scripts tu Func-Test-Spec (markdown)
+- Scripts nam trong `apps/mobile/e2e/features/`
+- Reusable helpers duoc export de Layer 3 (E2E) tai su dung
+- Data hardcoded trong test, credentials tu .env
+
+## Hanh dong
+
+### Buoc 1: Xac dinh Feature
+1. $ARGUMENTS la Feature ID hoac file path
+2. Neu khong co: scan `docs/epics/**/Feature-*.md` tim features co status In Progress
+3. Doc Feature file de lay Epic/Feature numbers va danh sach Stories
+
+### Buoc 2: Kiem tra Prerequisites
+1. Kiem tra `apps/mobile/` ton tai. Neu khong → bao loi:
+   > "Mobile app chua ton tai trong project nay. Vui long tao apps/mobile/ truoc."
+2. Tim tat ca `Func-Test-*.md` files trong Feature directory:
+   ```
+   docs/epics/{epic-dir}/{feature-dir}/Func-Test-*.md
+   ```
+3. Neu khong co Func-Test-Spec nao → bao loi:
+   > "Chua co Func-Test-Spec nao cho Feature nay. Chay /tas-functest {story-ID} truoc."
+4. Doc `apps/mobile/e2e/test-ids.ts` de biet testID hien co
+5. Doc `apps/mobile/e2e/helpers/data-loader.ts` va `test-utils.ts` de hieu patterns
+
+### Buoc 3: Aggregate FT Test Cases
+- Tu tat ca Func-Test-Spec files, tong hop danh sach FT test cases
+- Nhom theo Story
+- Lay test data requirements tu moi spec
+
+### Buoc 4: Generate Test Scripts
+Voi MOI Story co Func-Test-Spec:
+
+**File output**: `apps/mobile/e2e/features/{epic-slug}/{feature-slug}/{story-slug}.func.e2e.ts`
+
+**Structure**:
+```typescript
+/**
+ * Functional Tests: {Story Name}
+ * Story: {Story_ID}
+ * Feature: {Feature_ID}  
+ * Epic: {Epic_ID}
+ * 
+ * Generated by /tas-functest-mobile
+ * Spec: docs/epics/{epic-dir}/{feature-dir}/Func-Test-{story-slug}.md
+ */
+
+import { device, element, expect, by, waitFor } from 'detox';
+import { TEST_IDS } from '../../../test-ids';
+import { loadTestData, getCredentials } from '../../../helpers/data-loader';
+import { login, navigateTo } from '../../../helpers/test-utils';
+
+const testData = loadTestData();
+
+describe('{Feature Name} - {Story Name}', () => {
+  beforeAll(async () => {
+    await device.launchApp({ newInstance: true });
+  });
+
+  beforeEach(async () => {
+    await device.reloadReactNative();
+  });
+
+  // AC Reference: AC-1
+  describe('{PROJECT}_E{EPIC}_F{FEATURE}_S{STORY}_FT_001_H', () => {
+    it('should {description from spec}', async () => {
+      // Given: {precondition}
+      // When: {action}
+      // Then: {expected}
+    });
+  });
+});
+```
+
+### Buoc 5: Update test-ids.ts (neu can)
+- Neu test cases can testID chua co trong test-ids.ts
+- Them testID moi theo naming convention hien tai
+- Giu nguyen structure: nested object voi dot notation
+
+### Buoc 6: Generate Feature Helpers
+Tao file `apps/mobile/e2e/features/{epic-slug}/{feature-slug}/helpers.ts`:
+```typescript
+/**
+ * Reusable helpers cho {Feature Name}
+ * Duoc tai su dung boi Layer 3 E2E scripts
+ */
+
+export async function {featureSpecificHelper}() {
+  // Helper logic extracted from functional tests
+}
+```
+
+### Buoc 7: Update package.json Script
+Them hoac update script trong `apps/mobile/package.json`:
+```json
+"functest:mobile:{feature-slug}": "detox test --configuration ios.sim.debug --testPathPattern='e2e/features/{epic-slug}/{feature-slug}'"
+```
+
+### Buoc 8: Generate Index
+Tao `apps/mobile/e2e/features/{epic-slug}/{feature-slug}/index.ts`:
+```typescript
+export * from './helpers';
+```
+
+## File Structure Output
+```
+apps/mobile/e2e/features/
+└── {epic-slug}/
+    └── {feature-slug}/
+        ├── {story-1-slug}.func.e2e.ts
+        ├── {story-2-slug}.func.e2e.ts
+        ├── helpers.ts
+        └── index.ts
+```
+
+## Test Data Convention
+- **Hardcoded values**: Truc tiep trong test (vd: "invalid@email", "short")
+- **Credentials**: `const creds = getCredentials();` → password tu process.env
+- **Environment data**: `const testData = loadTestData();` → doc tu test-data.{env}.json
+- **KHONG BAO GIO** hardcode passwords/tokens trong test files
+
+## Chay Tests
+```bash
+# Chay tat ca func tests cho feature
+yarn functest:mobile:{feature-slug}
+
+# Chay chi mot story
+npx detox test --configuration ios.sim.debug --testPathPattern='e2e/features/{epic}/{feature}/{story}'
+
+# Chay voi Android
+npx detox test --configuration android.emu.debug --testPathPattern='e2e/features/{epic}/{feature}'
+```
+
+## Nguyen tac
+- Script PHAI chay duoc ngay tu CLI, KHONG can cua so Claude
+- Moi describe block dung full FT ID de grep duoc
+- Helpers PHAI export de Layer 3 reuse
+- KHONG import tu Layer 3 (flows/), chi export LEN Layer 3
+- Neu apps/mobile/ khong ton tai → bao loi graceful, KHONG tao

package/.claude/commands/tas-functest-web.md

@@ -0,0 +1,192 @@
+# /tas-functest-web $ARGUMENTS
+
+Vai tro: SE / QA
+Generate tat ca Playwright automation test scripts cho mot web Feature.
+
+## QUAN TRONG - Layer 2: Web Functional Test Scripts
+- Tao Playwright test scripts tu Func-Test-Spec (markdown)
+- Scripts nam trong `apps/web/e2e/features/`
+- Reusable helpers duoc export de Layer 3 (E2E) tai su dung
+- Data hardcoded trong test, credentials tu .env
+- Cross-viewport testing (mobile, tablet, desktop)
+
+## Hanh dong
+
+### Buoc 1: Xac dinh Feature
+1. $ARGUMENTS la Feature ID hoac file path
+2. Neu khong co: scan `docs/epics/**/Feature-*.md` tim features co status In Progress
+3. Doc Feature file de lay Epic/Feature numbers va danh sach Stories
+
+### Buoc 2: Kiem tra Prerequisites
+1. Kiem tra `apps/web/` ton tai. Neu khong → bao:
+   > "Web app chua ton tai trong project nay. Neu project chi co mobile, dung /tas-functest-mobile."
+   > DUNG LAI, KHONG tao file.
+2. Tim tat ca `Func-Test-*.md` files trong Feature directory:
+   ```
+   docs/epics/{epic-dir}/{feature-dir}/Func-Test-*.md
+   ```
+3. Neu khong co Func-Test-Spec nao → bao loi:
+   > "Chua co Func-Test-Spec nao cho Feature nay. Chay /tas-functest {story-ID} truoc."
+4. Doc `apps/web/playwright.config.ts` (neu co) de hieu config hien tai
+5. Doc `apps/web/e2e/helpers/` (neu co) de hieu patterns
+
+### Buoc 3: Aggregate FT Test Cases
+- Tu tat ca Func-Test-Spec files, tong hop danh sach FT test cases
+- Nhom theo Story
+- Lay test data requirements tu moi spec
+
+### Buoc 4: Generate Test Scripts
+Voi MOI Story co Func-Test-Spec:
+
+**File output**: `apps/web/e2e/features/{epic-slug}/{feature-slug}/{story-slug}.func.spec.ts`
+
+**Structure**:
+```typescript
+/**
+ * Functional Tests: {Story Name}
+ * Story: {Story_ID}
+ * Feature: {Feature_ID}
+ * Epic: {Epic_ID}
+ * 
+ * Generated by /tas-functest-web
+ * Spec: docs/epics/{epic-dir}/{feature-dir}/Func-Test-{story-slug}.md
+ */
+
+import { test, expect } from '@playwright/test';
+import { loadTestData, getCredentials } from '../../../helpers/data-loader';
+
+const testData = loadTestData();
+
+test.describe('{Feature Name} - {Story Name}', () => {
+  test.beforeEach(async ({ page }) => {
+    await page.goto('/target-page');
+  });
+
+  // AC Reference: AC-1
+  test.describe('{PROJECT}_E{EPIC}_F{FEATURE}_S{STORY}_FT_001_H', () => {
+    test('should {description from spec}', async ({ page }) => {
+      // Given: {precondition}
+      // When: {action}
+      await page.getByTestId('element-id').click();
+      // Then: {expected}
+      await expect(page.getByTestId('result')).toBeVisible();
+    });
+  });
+
+  // Viewport testing for responsive features
+  test.describe('{PROJECT}_E{EPIC}_F{FEATURE}_S{STORY}_FT_001_H - Viewports', () => {
+    const viewports = [
+      { width: 375, height: 812, name: 'mobile' },
+      { width: 768, height: 1024, name: 'tablet' },
+      { width: 1280, height: 720, name: 'desktop' },
+    ];
+
+    for (const vp of viewports) {
+      test(`should work on ${vp.name} (${vp.width}x${vp.height})`, async ({ page }) => {
+        await page.setViewportSize({ width: vp.width, height: vp.height });
+        // Test responsive behavior
+      });
+    }
+  });
+});
+```
+
+### Buoc 5: Generate Feature Helpers
+Tao file `apps/web/e2e/features/{epic-slug}/{feature-slug}/helpers.ts`:
+```typescript
+import { Page, expect } from '@playwright/test';
+
+/**
+ * Reusable helpers cho {Feature Name}
+ * Duoc tai su dung boi Layer 3 E2E scripts
+ */
+
+export async function {featureSpecificHelper}(page: Page) {
+  // Helper logic extracted from functional tests
+}
+```
+
+### Buoc 6: Generate/Update Data Loader (neu chua co)
+Neu `apps/web/e2e/helpers/data-loader.ts` chua ton tai, tao:
+```typescript
+type TestEnv = 'dev' | 'staging' | 'prod';
+
+export function loadTestData(env?: TestEnv) {
+  const targetEnv = env || (process.env.TEST_ENV as TestEnv) || 'dev';
+  return require(`../data/test-data.${targetEnv}.json`);
+}
+
+export function getCredentials(userType = 'default') {
+  const data = loadTestData();
+  const user = data.users[userType] || data.users.default;
+  return {
+    email: user.email,
+    password: process.env.TEST_USER_PASSWORD || '',
+  };
+}
+```
+
+### Buoc 7: Update package.json Script
+Them hoac update script trong `apps/web/package.json`:
+```json
+"functest:web:{feature-slug}": "npx playwright test e2e/features/{epic-slug}/{feature-slug}"
+```
+
+### Buoc 8: Generate Index
+Tao `apps/web/e2e/features/{epic-slug}/{feature-slug}/index.ts`:
+```typescript
+export * from './helpers';
+```
+
+## File Structure Output
+```
+apps/web/e2e/features/
+└── {epic-slug}/
+    └── {feature-slug}/
+        ├── {story-1-slug}.func.spec.ts
+        ├── {story-2-slug}.func.spec.ts
+        ├── helpers.ts
+        └── index.ts
+```
+
+## Selector Strategy (Playwright)
+- **Uu tien**: `data-testid` → `page.getByTestId('login-submit')`
+- **Text content**: `page.getByText('Welcome')`
+- **Role**: `page.getByRole('button', { name: 'Submit' })`
+- **Label**: `page.getByLabel('Email')`
+- KHONG dung CSS selectors truyen thong (`.class`, `#id`) tru khi bat buoc
+
+## Cross-Browser Testing
+- Chromium (bat buoc)
+- Firefox (bat buoc)
+- WebKit (bat buoc)
+- Config trong `playwright.config.ts` projects section
+
+## Test Data Convention
+- **Hardcoded values**: Truc tiep trong test
+- **Credentials**: `getCredentials()` → password tu process.env
+- **Environment data**: `loadTestData()` → tu test-data.{env}.json
+- **KHONG BAO GIO** hardcode passwords/tokens
+
+## Chay Tests
+```bash
+# Chay tat ca func tests cho feature
+yarn functest:web:{feature-slug}
+
+# Chay chi mot story
+npx playwright test e2e/features/{epic}/{feature}/{story}
+
+# Chay voi browser cu the
+npx playwright test --project=firefox e2e/features/{epic}/{feature}
+
+# Chay voi debug UI
+npx playwright test --ui e2e/features/{epic}/{feature}
+```
+
+## Nguyen tac
+- Script PHAI chay duoc ngay tu CLI
+- Moi describe block dung full FT ID
+- Helpers PHAI export de Layer 3 reuse
+- KHONG import tu Layer 3 (flows/)
+- Neu apps/web/ khong ton tai → bao loi graceful, KHONG tao
+- Test phai work tren tat ca viewports (mobile, tablet, desktop)

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

@@ -0,0 +1,76 @@
+# /tas-functest $ARGUMENTS
+
+Vai tro: SE / QA
+Generate Functional Test Specification tu mot User Story, lien ket test cases voi Acceptance Criteria (AC).
+
+## QUAN TRONG - Layer 2: Functional Testing
+- Functional tests (FT) nam giua Unit tests (Layer 1) va E2E tests (Layer 3)
+- FT test tung chuc nang/story rieng le, KHONG test flow lien ket giua nhieu features
+- Moi FT case PHAI reference AC-ID de traceability
+
+## Hanh dong
+
+### Buoc 1: Xac dinh Story
+1. $ARGUMENTS la Story ID hoac file path
+2. Neu khong co $ARGUMENTS: scan `docs/epics/**/Story-*.md` tim stories co status In Progress hoac Committed
+3. Doc Story file de lay:
+   - Tat ca Acceptance Criteria (AC-1, AC-2, ...)
+   - Epic/Feature/Story numbers (tu frontmatter hoac file path)
+   - Platform context (mobile/web/backend)
+4. Doc `root/tas.yaml` de lay project code (vd: "AL")
+
+### Buoc 2: Auto-detect Platform
+Tu Story context, xac dinh platform:
+- **Mobile**: Keywords "screen", "navigation", "React Native", "Detox"; paths `apps/mobile/src/features/*`
+- **Web**: Keywords "browser", "page", "Playwright", "React"; paths `apps/web/*`
+- **Backend**: Keywords "API endpoint", "service", "controller"; paths `src/Torus.*`, `tests/`
+- Neu khong xac dinh duoc: hoi user
+
+### Buoc 3: Generate FT Test Cases
+Doc template tu `.tas/templates/Func-Test-Spec.md`
+
+Naming format:
+```
+{PROJECT}_E{EPIC}_F{FEATURE}_S{STORY}_FT_{NNN}_{MODIFIER}
+```
+
+Voi moi AC, generate:
+- **BAT BUOC**: 1 Happy path test (H)
+- **NEN CO**: 1 Negative test (N) neu co error scenarios
+- **TUY CHON**: 1 Edge case test (E) neu co boundary conditions
+
+Moi test case PHAI co cot AC-ID trong bang mapping.
+
+### Buoc 4: Generate Test Data Requirements
+- Xac dinh data can thiet cho moi test case
+- Data hardcoded: ghi truc tiep trong scenario
+- Credentials: chi reference `process.env.TEST_USER_PASSWORD`, KHONG hardcode
+- Data per environment: reference `test-data.{env}.json`
+
+### Buoc 5: Output File
+Luu file tai:
+```
+docs/epics/{epic-dir}/{feature-dir}/Func-Test-{story-slug}.md
+```
+
+### Buoc 6: Prompting
+Sau khi generate, hoi user:
+- "Co edge case nao can them khong?"
+- "Co negative test scenario nao bi bo sot khong?"
+- "Co test case nao can danh dau P0 Critical khong?"
+- "Test data va fixtures can chuan bi gi them?"
+
+## Traceability Feature
+- Moi FT case gan AC-ID trong cot mapping
+- Khi AC thay doi: grep AC-ID trong Func-Test-*.md de biet FT nao can update
+- Trong test script, moi describe block co comment `// AC Reference: AC-{N}`
+
+## Status Flow
+Draft → Ready → Implemented → Verified
+
+## Nguyen tac
+- KHONG tao test code, chi tao specification (markdown)
+- Test code duoc tao boi `/tas-functest-mobile` hoac `/tas-functest-web`
+- Func-Test-Spec la input cho Layer 2 script generation
+- Moi AC phai co it nhat 1 FT case
+- FT dung type code `FT`, KHONG dung `E2E` hay `UT`