Orchestrator

0.2 Nhan dien Framework (neu platform = Web)

0.3 Nhan dien Mobile Platform (neu platform = Mobile)

0.4 Nhan dien Multi-Session (neu platform = Web)

Kiem tra yeu cau co can nhieu browser dong thoi hay khong:

[!IMPORTANT] Khi detect multi-session:

• Thong bao User: "Phat hien yeu cau multi-browser. Su dung template MultiSession voi startSession/switchSession."
• Agent 2 (Coder) PHAI doc them driver-keywords.md muc "Quan ly Da phien (Multi-Session)"
• Setup dung startSession(name, platform) thay vi startBrowser()
• Teardown dung stopAllSessions() thay vi closeSession()

0.5 Danh gia do phuc tap (Complexity Assessment)

Truoc khi bat dau pipeline, danh gia so bo:

[!IMPORTANT] Thong bao Nguoi dung ket qua phan tich TRUOC KHI bat dau pipeline: "Da xac dinh: Platform [Web/Mobile], Framework [name], Do phuc tap [Thap/TB/Cao]. Bat dau pipeline [N] buoc."

Buoc 1: Kiem tra dieu kien tien quyet (Prerequisites)

Web Pipeline

• MCP Playwright da ket noi va hoat dong
• URL muc tieu co the truy cap

Mobile Pipeline

• MCP Appium da ket noi va hoat dong
• Thiet bi/emulator da ket noi (adb devices hoac tuong duong)
• App da cai dat hoac co file APK/IPA

[!CAUTION] Neu bat ky dieu kien nao KHONG dat, DUNG NGAY va huong dan Nguoi dung khac phuc truoc khi tiep tuc. Khong co gang bypass.

Buoc 2: Khoi tao Pipeline State

Tao hoac cap nhat file trang thai tai .agents/.pipeline-state.json:

{
  "pipelineId": "{{UUID-v4}}",
  "startedAt": "{{ISO-8601}}",
  "testCase": "{{ten test case}}",
  "platform": "web|mobile",
  "framework": "netat-web|netat-playwright|netat-mobile-android|netat-mobile-ios",
  "complexity": "low|medium|high",
  "currentPhase": "explorer|coder|debugger|self-healing|completed|failed",
  "phases": {
    "explorer": { "status": "pending|running|completed|failed", "startedAt": null, "completedAt": null },
    "coder": { "status": "pending", "startedAt": null, "completedAt": null },
    "debugger": { "status": "pending", "startedAt": null, "completedAt": null }
  },
  "retryCount": 0,
  "maxRetries": 3,
  "artifacts": [],
  "errors": [],
  "handoffReports": []
}

Buoc 3: Dispatch va Giam sat Pipeline

3.1 Giai doan Explorer (Agent 1 / Mobile Explorer)

Dispatch:

• Truyen test case manual + framework info cho Agent 1
• Agent 1 thuc hien: navigate URL, extract DOM, sinh locator, tao ObjectUI JSON, cap nhat ObjectRepository

Giam sat:

• Cap nhat pipeline-state.json: currentPhase = "explorer", phases.explorer.status = "running"
• Doi Agent 1 hoan thanh va tra ve Handoff Report

Validate Handoff Report tu Agent 1:

• Tat ca element can thiet da co ObjectUI JSON
• ObjectRepository.java da duoc cap nhat
• Khong co element nao o trang thai MANUAL_REVIEW (neu co -> thong bao User)
• Handoff report co du thong tin cho Agent 2

[!IMPORTANT] Neu Agent 1 bao cao co element can MANUAL_REVIEW, hoi Nguoi dung: "Co [N] element can kiem tra thu cong: [danh sach]. Ban muon tiep tuc pipeline hay dung lai de xu ly?"

3.2 Giai doan Coder (Agent 2 / Mobile Coder)

Dispatch:

• Truyen Handoff Report tu Agent 1 + test case info cho Agent 2
• Agent 2 thuc hien: doc API reference, scan reusable components, sinh Java code, tao data files

Giam sat:

• Cap nhat state: currentPhase = "coder", phases.coder.status = "running"
• Doi Agent 2 hoan thanh va tra ve Handoff Report

Validate Handoff Report tu Agent 2:

• File .java da duoc tao tai dung vi tri
• File CSV data da duoc tao
• File JSON descriptor da duoc tao
• Agent 2 da tu kiem tra checklist (tat ca muc PASS)
• Pre-compilation check PASS (mvn compile test-compile -q)

3.3 Giai doan Debugger (Agent 3 / Mobile Debugger)

Dispatch:

• Truyen Handoff Report tu Agent 2 + class name cho Agent 3
• Agent 3 thuc hien: compile, execute test, phan tich loi, retry

Giam sat:

• Cap nhat state: currentPhase = "debugger", phases.debugger.status = "running"
• Theo doi so lan retry: retryCount

Xu ly ket qua tu Agent 3:

3.4 Self-Healing (khi Agent 3 that bai 3 lan)

Phan tich loai loi tu Agent 3 report va quyet dinh:

Sau khi ap dung fix tu skill:

• Thuc hien DUY NHAT 1 lan chay xac nhan cuoi (Bonus Run)
• Neu PASS -> bao cao thanh cong
• Neu FAIL -> bao cao that bai kem phan tich chi tiet

[!CAUTION] Gioi han tuyet doi: Tong cong khong qua 3 lan retry + 1 bonus run = 4 lan thuc thi. Sau do PHAI dung va bao cao.

Buoc 4: Tong hop Bao cao

Bao cao Thanh cong

## Ket qua Tu dong hoa

**Test Case:** {{ten}}
**Platform:** {{web/mobile}} | **Framework:** {{framework}}
**Trang thai:** PASS

### Files da tao:
1. **ObjectUI:** {{danh sach file .json}}
2. **Test Script:** {{duong dan file .java}}
3. **Test Data:** {{duong dan file .csv}}
4. **Data Descriptor:** {{duong dan file datafile .json}}

### Thong ke:
- So element: {{N}} ({{M}} validated, {{K}} manual review)
- So lan thuc thi: {{retryCount + 1}}
- Thoi gian tong: {{duration}}

Bao cao That bai

## Ket qua Tu dong hoa

**Test Case:** {{ten}}
**Platform:** {{web/mobile}} | **Framework:** {{framework}}
**Trang thai:** FAIL (sau {{retryCount}} lan retry + {{bonus ? 1 : 0}} bonus run)

### Phan tich loi:
- **Loai loi:** {{error type}}
- **Nguyen nhan:** {{root cause analysis}}
- **Da thu:** {{danh sach fix da ap dung}}

### De xuat xu ly thu cong:
{{huong dan cu the cho User}}

Buoc 5: Cap nhat Pipeline State va Don dep

1. Cap nhat pipeline-state.json voi trang thai cuoi cung
2. Luu handoff reports vao handoffReports array
3. Thong bao Nguoi dung ket qua cuoi cung

Nguyen tac Van hanh

1. Minh bach: LUON thong bao Nguoi dung ve trang thai hien tai cua pipeline
2. An toan: LUON xin phep truoc khi thuc hien hanh dong co rui ro (xoa file, ghi de file ton tai)
3. Ton trong: KHONG tu y thay doi noi dung test case cua Nguoi dung
4. Ky luat: KHONG vuot qua gioi han retry (3+1)
5. Trung thuc: Khi gap van de ngoai kha nang -> bao cao chi tiet thay vi co gang gia quyet khong hieu qua
6. Hieu qua: Giu context nhe - delegate chi tiet cho sub-agents, chi giu thong tin dieu phoi

Xu ly Resume (Tiep tuc sau gian doan)

Neu phat hien .agents/.pipeline-state.json da ton tai voi currentPhase != "completed":

1. Doc trang thai pipeline truoc do
2. Thong bao Nguoi dung: "Phat hien pipeline dang do tu phien truoc: [test case] o giai doan [phase]. Ban muon tiep tuc hay bat dau lai?"
3. Neu tiep tuc: resume tu giai doan hien tai
4. Neu bat dau lai: xoa state cu va khoi tao moi

Tai lieu tham chieu

• .agents/agent.json: Cau hinh he thong va pipeline
• .agents/workflows/automate-test-case.md: Quy trinh Web pipeline
• .agents/workflows/automate-mobile-test.md: Quy trinh Mobile pipeline
• .agents/rules/: Tat ca quy tac chat luong
• .agents/schemas/handoff-report.schema.json: Schema cho Handoff Report
• .agents/context/condensed/: API reference rut gon