FSTS BA Analyst 產出文件規範
docs/ba/資料夾定義 BA Analyst Agent 的三類產出：Context Brief（前段）、Review Report（後段）、Domain Curation Report（獨立任務）。回到 FSTS 專案總覽。
Owner 與變更流程
- Owner：BA Analyst Agent（僅由 BA Analyst 建立與更新，PM / RD / QA 不得直接編輯）1
- 變更流程：透過
ba-analystagent 或/ba-review//ba-curateskill 產出1 - 存放位置：
docs/ba/1
三類產出檔
| 類型 | 用途 | 檔名格式 | 範例 |
|---|---|---|---|
| Context Brief（前段） | 給 PM 寫 Feature Spec 前的領域 Context | <feature-name>.context.md | customer-base-info.context.md2 |
| Review Report（後段） | 商業邏輯 Review 結果 | <feature-name>.review.md | customer-base-info.review.md2 |
| Domain Curation Report（獨立） | 領域整理專題報告 | curation-<topic>-<YYYYMMDD>.md | curation-cobol-fd-20260422.md2 |
<feature-name> 必須與 docs/features/<feature-name>/spec.md 的 feature 目錄名完全一致（kebab-case）。2
Context Brief 結構（Pre-PM）
在 PM 寫 Feature Spec 之前，BA 盤點領域 context：3
- Status：Ready for PM
- 相關商業規則（既有）：列出受影響的 BR-XXX 與其對此 Feature 的影響
- 相關術語：從
domain.md節錄術語 + 本 Feature 的應用 - 相關既有情境：從
scenarios.md節錄相似或差異的 S-XXX - 建議新增的 BR（草案）：草擬 BR-NEW-XXX，附 Why / How to apply，待 PM 定稿
- 建議情境編號規劃：主流程
S-{模組}-XXX/ 異常S-{模組}-ERR-XXX/ UI 驗證S-{模組}-VAL-XXX - 領域風險提醒：提醒 PM 注意的商業風險或邊界條件
- Delivered to PM at：交付時間戳
Review Report 結構（Post-RD）
RD 實作完成後，BA 對照 BR 進行商業邏輯 Review：4
| 欄位 | 說明 |
|---|---|
| Status | Approved / Changes Required |
| Review Round | 第 N 輪 |
| Review Summary | 整體評估：實作是否忠實反映 BR 意圖 |
| Business Rule Alignment Check | 表格：BR 編號、規則意圖、實作行為、對齊結果（✅/❌） |
| Domain Terminology Check | 前後端命名與術語表一致性 |
| API Contract Semantics Check | API 副作用與 domain.md API 語意一致性 |
| Document Sync Check | domain.md / scenarios.md 是否已更新 |
| Issues Found | 問題描述 + 違反的 BR 編號 |
| Required Changes | 具體要求 RD 如何修正 |
| Suggestions（非 Block） | 未來可考慮的改進 |
| Review Decision | Approved / Changes Required |
範例：「BR-004 TruncateBefore 需謹慎 → UI 缺少二次確認 dialog → ❌」4
Domain Curation Report 結構（獨立任務）
非 Pipeline 的獨立整理任務：5
- Task Type：Curation（獨立整理任務，非 Pipeline）
- 任務目標：使用者要求整理的主題與範圍
- 盤點前狀況：現有 BR 數量、涵蓋範圍、現有情境數量、相關既有文件
- 整理方法：資料來源（如 COBOL FD 樣本、上游券商文件）、比對方式
- 產出摘要：
- 新增 BR（BR-XXX 摘要）
- 新增術語
- 新增情境（S-XXX-XXX）
- 棄用 / 修訂項目
- 後續建議：建議後續由誰追蹤或確認
[推論] 此報告型態對應前述 Vibe Coding 開發框架的「Multi-Agent Pipeline」中 BA 在 Pipeline 外可獨立執行的 Curation 任務。15
相關規範參考
docs/agents/agent.ba-analyst.md— BA Agent 詳細指南6docs/pipeline/multi-agent-workflow.md— Pipeline 流程6docs/domain/domain.md、docs/domain/scenarios.md— 領域知識來源6
補充資訊
(未來 ingest 新來源會在此追加段落)