---
name: function-breakdown
description: Use when a raw customer request (Backlog ticket, email, requirement document set) must be split into a Function List before create-spec — classifies each part as a NEW function or a CHANGE to an existing function, assigns functionIds, scope, dependencies and the RAW paragraphs each function comes from. Used by the BA Lead (manual) and the BA Lead Agent of Light-out Agents (ba:lead).
keywords: function list, function breakdown, requirement split, change request, functionId, BA lead
---

# Function Breakdown — lập Function List từ yêu cầu thô (KIT-31)

> **Ai dùng:** BA Lead (manual) hoặc BA Lead Agent (`ba:lead`, Light-out Agents).
> **Khi nào:** trước `create-spec`. Một yêu cầu thô (ticket + Backlog Document, email, bộ tài liệu) có thể chứa nhiều chức năng; mỗi chức năng sau đó là một task `create-spec` riêng.
> **Human duyệt** Function List trước khi phân tích từng chức năng.

---

## 1. Đầu vào

- Yêu cầu thô, mỗi đoạn có mã `RAW-1`, `RAW-2`… (đoạn văn, mục danh sách, dòng bảng) để truy vết.
- Danh mục chức năng đã có của dự án: `AK-Docs/00.Project-Overview/Function-List.md` (bảng `F-ID | Feature Name | … | Status`), UC Spec trong `AK-Docs/02.BA-Specs/04.UC-Specs/F-xxx_*/`, chức năng đang được phân tích ở yêu cầu khác.
- `AK-Docs/00.Project-Overview/Glossary.md` và `custom/rules/domain-terminology.md`.

## 2. Phân loại trước khi tách

Với mỗi phần của yêu cầu, quyết định:

| Loại | Khi nào | functionId |
|---|---|---|
| `change` | Sửa, mở rộng, bỏ hành vi của một chức năng **đã có** (đã ký UC Spec, đã làm xong, hoặc đang làm) | Dùng **mã cũ**; ghi `changeSummary` (sửa gì so với hiện tại) và REQ/AC bị ảnh hưởng nếu biết |
| `new` | Hành vi chưa chức năng nào làm | Mã mới, bắt đầu từ mã lớn nhất trong danh mục + 1, theo thứ tự; **không** dùng lại mã đã có |

Loại của cả yêu cầu: `new-requirements` (toàn mới), `change-request` (toàn sửa), `mixed`.

Không chắc một đoạn là sửa hay mới → chọn khả năng cao nhất, ghi lý do: Human sẽ xem.

## 3. Tách chức năng

Một chức năng = một tính năng đặc tả, làm và nghiệm thu được độc lập. Với mỗi chức năng ghi:

| Trường | Nội dung |
|---|---|
| functionId, kind | Theo mục 2 |
| title | Tên ngắn theo thuật ngữ Glossary (với `change`: giữ tên cũ) |
| scope | Chức năng phải làm gì — trích từ yêu cầu, không thêm |
| outOfScope | Những gì không làm trong chức năng này |
| dependsOn | functionId (cũ hoặc mới) phải xong trước |
| priority | high / medium / low |
| hasUi | Có thêm hoặc đổi màn hình không |
| sourceRefs | Các `RAW-x` sinh ra chức năng |

Quy tắc:

- Mỗi đoạn yêu cầu **đòi hỏi một việc** phải thuộc đúng một chức năng. Đoạn không đòi hỏi gì (lời chào, bối cảnh) được phép không thuộc chức năng nào — liệt kê để Human kiểm.
- **Không** thêm chức năng khách không yêu cầu.
- Gom thuật ngữ nghiệp vụ mới (glossary) và business rule dùng chung cho nhiều chức năng (commonRules). Thuật ngữ chưa có trong Glossary: Human xác nhận rồi mới ghi vào Glossary.

## 4. Output

**Manual:** bảng trong `AK-Docs/06.Agent-Records/<yêu cầu>/Function-Breakdown.md` (hoặc trình bày cho Human duyệt), sau khi duyệt thì thêm dòng vào `Function-List.md` (Status `BA 🔵 · Dev ⬜ · QA ⬜` — định dạng và các mốc cập nhật sau đó: `custom/rules/function-list-status.md`).

| functionId | Loại | Chức năng | Phạm vi | Ngoài phạm vi | Phụ thuộc | Ưu tiên | UI | Nguồn |
|---|---|---|---|---|---|---|---|---|

**Light-out Agents (`ba:lead`):** trả output có cấu trúc theo schema của orchestrator (`requestType`, `functions[]`, `glossary[]`, `commonRules[]`, `rationale`). Orchestrator kiểm mã (trùng, sai định dạng, `new` dùng mã đã có, `change` dùng mã không có), ghi file và hỏi Human.

## 5. Tự kiểm

- [ ] Mọi `RAW-x` đòi hỏi một việc đều nằm trong `sourceRefs` của đúng một chức năng
- [ ] Không có chức năng `new` dùng mã đã có trong danh mục; không có `change` dùng mã không có
- [ ] `dependsOn` chỉ trỏ tới chức năng có trong danh sách hoặc trong dự án
- [ ] Tên và phạm vi dùng đúng thuật ngữ Glossary
