# MASTER SKILL — HUẤN LUYỆN TEAM (bản public tổng quan)
## Techgon Agent · mô hình đội AI có kiểm soát

> Đây là bản MÔ TẢ public. Bản vận hành đầy đủ (checklist nội bộ, prompt vai, lệnh điều phối) thuộc lớp private theo `PUBLIC_REDACTION_POLICY.md`.

## Triết lý

AI không được tự do code. Mọi việc đi trong khung: **rules → scope → evidence → security gate → rollback gate**. Code "chạy được" nhưng sai luật = thất bại. *Human-directed. AI-assisted. Governance-controlled.*

## 5 vai (Roles)

| Vai | Vai trò 1 dòng |
|---|---|
| Orchestrator | Nhận việc, phân loại rủi ro, khóa phạm vi, gác cổng chất lượng |
| Planner | Spec ngắn + tiêu chí hoàn thành đo được + kế hoạch đường lùi TRƯỚC khi code |
| Developer | Backup → sửa đúng phạm vi → tự kiểm chứng file đã ghi (write-verify) |
| Reviewer/QA | Soát diff độc lập: logic, bảo mật, hồi quy — kết luận bằng bằng chứng |
| E2E Tester | Kiểm thử như người dùng thật, thu evidence, không evidence không Done |

Task nhỏ: một agent đóng tuần tự 5 vai. Task lớn: tách nhiều agent — và có thể thêm lớp **AI Reviewer độc lập** (Claude/ChatGPT) do Product Owner điều phối.

## Phân loại rủi ro S / M / L

- **S** — chỉnh nhỏ (text/style/một hàm) → quy trình rút gọn nhưng đủ cổng.
- **M** — đổi logic/query/nhiều file → đủ 4 cổng, test rộng.
- **L** — schema/auth/refactor nền/deploy lớn → bắt buộc Git + staging + rollback; thiếu thì TỪ CHỐI làm.

## 4 Cổng chất lượng (Quality Gates — mức mô tả)

1. **Plan Gate** — chưa có kế hoạch đường lùi (rollback plan) thì chưa được code.
2. **Implementation Gate** — backup trước khi sửa; ghi file xong phải đọc lại từ ổ thật.
3. **Review Gate** — review trên diff thật so với bản gốc, kèm bằng chứng.
4. **Release/Test Gate** — smoke test + verify sau deploy; **không có bằng chứng thì không có "Done"**.

## Vòng học (Learning Loop)

Error → Lesson → Rule → Checklist → Prompt → Next Task. Mỗi lỗi chỉ được xảy ra một lần; mọi task kết thúc bằng **After Action Review** (xem `AFTER_ACTION_REVIEW.md`). Mô hình thay đổi → tăng version (`MODEL_VERSION_HISTORY.md`).

## Bắt đầu làm việc

Agent: đọc `agent-entry.md` → `runtime-context.json` → snapshot dự án (local) → Project Lock. Bản đồ đọc-khi-nào: `governance-manifest.json`.