@educa-corp/sdd-framework 0.9.1 → 0.9.2

package/bin/qc-base-map.json

@@ -0,0 +1,595 @@
+{
+  "$comment": [
+    "BAN DO ANH XA upstream/qc-base -> framework (no #S2 cua docs/plans/qc-sync-command.md).",
+    "",
+    "VI SAO CAN: port khong phai copy. Anh xa khong 1:1 (qa-tc-analyst -> qc-analyze VA qc-plan),",
+    "file duoc ADAPT chu khong copy (path -> {paths.*}, them rao), va merge lan sau la merge BA CHIEU",
+    "— can BASE. File nay giu BASE do: moi entry `ported` ghi base_sha = ban upstream da port tu.",
+    "",
+    "STATE — bon gia tri, va gia tri thu tu la quan trong nhat:",
+    "  ported     da dua vao, co base_sha de merge lan sau",
+    "  planned    da quyet se dua, chua lam",
+    "  skipped    CO Y khong dua, co ly do ghi lai",
+    "  undecided  chua ai quyet  <- DAY LA HANG DOI VIEC",
+    "",
+    "File upstream KHONG co entry = bi bo quen trong im lang. Do la failure mode duy nhat",
+    "ban do nay ton tai de chan — va R16(a) trong bin/self-check.js la phan may canh.",
+    "",
+    "port_completeness: partial = co y chi port MOT PHAN (vd exhaustive-gap-scanner: lay 5 mandate,",
+    "bo phan dieu phoi vi steps/review-fanout.md da so huu). Khong co co nay thi lan --port sau",
+    "hieu phan thieu la 'ta co y xoa noi dung'."
+  ],
+  "upstream": {
+    "repo": "ui-automation-testing",
+    "snapshot": "upstream/qc-base",
+    "commit": "596149f50d24e00a2cd4348a0b4c190e01d5fd20",
+    "captured_at": "2026-08-24"
+  },
+  "map": [
+    {
+      "upstream": "agents/1-qa-io-contract.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/2-qa-orchestrator.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/3-qa-tc-analyst.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/4-qa-tc-designer.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/5-qa-tc-reviewer.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/6-qa-runner.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/7-qa-gate.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "agents/README.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "dinh nghia agent cua upstream; framework dung command + gate _agent_mode thay cho agent file"
+    },
+    {
+      "upstream": "commands/qa-auditor.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "slash-command rieng cua upstream; chua doi chieu voi 6 lenh qc-* cua framework"
+    },
+    {
+      "upstream": "commands/qa-exhaustive.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "slash-command rieng cua upstream; chua doi chieu voi 6 lenh qc-* cua framework"
+    },
+    {
+      "upstream": "commands/qa-review-script.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "slash-command rieng cua upstream; chua doi chieu voi 6 lenh qc-* cua framework"
+    },
+    {
+      "upstream": "commands/qa-system-audit.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "slash-command rieng cua upstream; chua doi chieu voi 6 lenh qc-* cua framework"
+    },
+    {
+      "upstream": "skills/qa-gate/auto-report-writer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-gate/coverage-evaluator.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-gate/gate-decision.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-gate/qa-report-writer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-gate/risk-matrix-builder.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-gate/styled-report-feat011.py",
+      "targets": [],
+      "state": "undecided",
+      "why": "script chay duoc, khong phai prompt — framework QC hien 100% markdown-first"
+    },
+    {
+      "upstream": "skills/qa-gate/styled-report-template.py",
+      "targets": [],
+      "state": "undecided",
+      "why": "script chay duoc, khong phai prompt — framework QC hien 100% markdown-first"
+    },
+    {
+      "upstream": "skills/qa-io-contract/injection-scanner.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-io-contract/intake-validator.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-orchestrator/doc-classifier.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-orchestrator/routing-planner.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-runner/script-writer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-runner/test-executor.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/acceptance-criteria.md",
+      "targets": [
+        "skills/qc/qa-analyst/acceptance-criteria.md"
+      ],
+      "state": "ported",
+      "base_sha": "516f35cf78102d27aa5639bfb2818274399800c0"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/api-test-plan.md",
+      "targets": [],
+      "state": "undecided",
+      "why": "B5=A: thuoc tram 2 (/qc-plan), khong phai tram 1. Xet lai o B6."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/business-rules.md",
+      "targets": [
+        "skills/qc/qa-analyst/business-rules.md"
+      ],
+      "state": "ported",
+      "base_sha": "0d5f01257c30182d1c98835303640775d360a3da"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/coverage-analyzer.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B6=b: KHONG the chay o tram 1 — chinh skill tu khai 'chua co TC nao thi coverage=0%, khong y nghia'. Thuoc tram 3/4, ngoai pham vi viec dang lam. De danh."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/cross-ref-engine.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Doi chieu 3 nguon tho — gio la §Doi chieu tai lieu ky thuat trong qc-analyze."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/data-flow.md",
+      "targets": [
+        "skills/qc/qa-analyst/data-flow.md"
+      ],
+      "state": "ported",
+      "base_sha": "fc0fc3d0f8010e3fb266c16b132eff1b23641a8f"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/dbml-parser.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Tuong ung §3 Mo hinh du lieu."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/exhaustive-gap-scanner.md",
+      "targets": [
+        "skills/qc/qa-analyst/exhaustive-gap-scanner.md"
+      ],
+      "state": "ported",
+      "base_sha": "b3f5aa112ec2fb93100d8945a3fa3d5fe904eb26",
+      "port_completeness": "partial"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/exploratory-charter.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B6=c: KHONG trung voi qa-designer/exploratory/charter.md — cung ky thuat, khac muc dich. Framework dung o tram 3 de THIET KE test tham do; upstream dung o tram 1 lam PHUONG AN DU PHONG khi khong co tai lieu de doc (legacy/take-over). Framework tram 1 dung SAU chuoi PRD->BDD->tech-doc nen tai lieu phai co. Lay khi nao framework thuc su dung cho du an tiep quan — va lay thi lay CA 3 CHE DO."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/feature-spec-parser.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: da duoc phu boi tai lieu qc-analyze DANG doc (PRD / design-spec). Khong can port. PRD + product-definition."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/figma-design-capture.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: da duoc phu boi tai lieu qc-analyze DANG doc (PRD / design-spec). Khong can port. design-spec §Tom tat Figma · §Design Token."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/flow-path-designer.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Tuong ung §5 Luong chinh."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/full-lane-dispatcher.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: steps/review-fanout.md da so huu co che quet song song. Xem B3."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/gap-verifier.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/openapi-parser.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Tuong ung §4 Hop dong API."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/risk-acceptance-analyzer.md",
+      "targets": [
+        "skills/qc/qa-planner/risk-model.md"
+      ],
+      "state": "ported",
+      "base_sha": "5eca5091acd30e063d20b63f12b04e2d1c78ac83",
+      "port_completeness": "partial",
+      "why": "B6=a: port Phase 3 (Risk Register) + Phase 5 (Uu tien/Entry-Exit) -> tram 2. Bo Phase 1/2/4 vi tram 1 da lam (spec-breakdown, DOC_GAPS+gap-verify, acceptance-criteria)."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/screen-spec-parser.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: da duoc phu boi tai lieu qc-analyze DANG doc (PRD / design-spec). Khong can port. design-spec §Component Inventory · §Screen States · §Actions & Navigation."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/spec-breakdown.md",
+      "targets": [
+        "skills/qc/qa-analyst/spec-breakdown.md"
+      ],
+      "state": "ported",
+      "base_sha": "4a5fb9334fef1fdc3ac5e899e0463c643af80dad"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/spec-issue-reporter.md",
+      "targets": [
+        "skills/qc/qa-analyst/spec-issue-reporter.md"
+      ],
+      "state": "ported",
+      "base_sha": "5b5c0c886e92b474e0a5a8157ba58a7c3ce4b3f8",
+      "why": "B9: luat viet cho DOC_GAP.template.md — /qc-analyze nap. Doi Critical -> Blocker.",
+      "port_completeness": "adapted"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/spec-issue-reporter/DOC_GAPS.template.md",
+      "targets": [
+        "skills/qc/qa-analyst/DOC_GAP.template.md"
+      ],
+      "state": "ported",
+      "base_sha": "c7ca6cfb798c609f18ffe20a38f64f95c76e1919",
+      "why": "B9: hop nhat lam template DUY NHAT cho file gap (ban 9 cot cu da bo). Co y khac upstream: muc nang nhat dung 'Blocker' thay 'Critical' vi qc-run-test doc dung tu do de dat qc_owner=po vao so trace.",
+      "port_completeness": "adapted"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/tdd-extractor.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Tuong ung §4.4 Logic handler + §9 Design decisions."
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/test-plan.md",
+      "targets": [
+        "skills/qc/qa-planner/test-plan.md"
+      ],
+      "state": "ported",
+      "base_sha": "f259b4d123c565a42ba6c6ec96980a8e4c66284f"
+    },
+    {
+      "upstream": "skills/qa-tc-analyst/ui-api-mapper.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "B5=A: framework da co tech-doc gop cap PRD ({paths.tech_docs_dir}/.../{TICKET-ID}-tech-design.md) phu cung thong tin. qc-analyze doc THANG tech-doc thay vi parse file tho — 1 thay doi thay cho 11 port. Chi tiet: docs/plans/qc-implementation-log.md B5. Tuong ung §4.5 Anh xa component UI."
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/flows/auth-sequence.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/flows/common-flows.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/flows/crud-sequence.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/references/common-headers.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/references/error-codes.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/references/http-status-codes.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/templates/auth-chain.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/api-testcase-designer/api/templates/endpoint.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/e2e-testcase-designer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/integration-testcase-designer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/manual-excel-testcase.md",
+      "targets": [],
+      "state": "skipped",
+      "why": "README upstream khai da bo nhanh manual-Excel (auto-pytest); file con sot lai"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/nfr-testcase-designer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/action-keywords-glossary.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/duplicate-check-procedure.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/implicit-scenarios.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/precision-rules.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/read-doc-gap-inputs.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/skill-decision-tree.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/shared/tc-metadata-format.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-designer/ui-testcase-designer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/api-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/e2e-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/exploratory-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/integration-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/nfr-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/script-e2e-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/script-exploratory-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/script-functional-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/script-integration-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/script-non-functional-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/shared/read-doc-gap-inputs.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/shared/review-file-template.md",
+      "targets": [],
+      "state": "undecided"
+    },
+    {
+      "upstream": "skills/qa-tc-reviewer/ui-test-reviewer.md",
+      "targets": [],
+      "state": "undecided"
+    }
+  ],
+  "$decisions": {
+    "B5": {
+      "date": "2026-08-25",
+      "question": "Framework co nhan truc lane UI/API/E2E cua doi QC khong?",
+      "answer": "A — KHONG nhan lane. qc-analyze doc THANG tech-doc gop cap PRD da co san.",
+      "why": [
+        "Framework da co MOT tech-doc hop nhat phu dung thong tin ma 11 lane skill di boi tu file tho.",
+        "File tho (openapi.yaml / *.dbml / tdd/) la TUY DU AN — co the khong ton tai. Tech-doc thi framework tu sinh, luon co.",
+        "Truc lane la truc THU BA chong len layer x platform da co — moi lan chay QC phai chon to hop, khong ai nho noi."
+      ],
+      "known_limit": "Tech-doc do AI viet TU PRD, nen chi bat duoc 'PRD lech tech-doc', KHONG bat duoc 'PRD lech he thong THAT dang chay'. Chi quan trong voi du an brownfield co openapi.yaml that. Duong nang cap = phuong an B: port dung 2-3 skill doc file tho khi gap nhu cau that.",
+      "also": "§12 GAP Register cua tech-doc: qc-analyze DOC de khong hoi lai, KHONG GHI vao. Ngoai le: muc loai `spec-defect` van la gap tai lieu."
+    },
+    "B6": {
+      "date": "2026-08-25",
+      "question": "Ba ky nang 'dung vai nhung dung sai tram' xu the nao?",
+      "answer": "a — chi bo sung cach tinh rui ro vao tram 2. (b) va (c) de danh.",
+      "findings": [
+        "risk-acceptance-analyzer TU KHAI output di vao TEST_PLAN.md = tram 2. Khong phai tranh chap.",
+        "coverage-analyzer TU KHAI khong chay duoc khi chua co TC nao = khong the o tram 1. Toi xep nham luc dau.",
+        "exploratory-charter KHONG phai trung lap — cung ky thuat, hai muc dich khac han. Toi bao sai luc dau."
+      ],
+      "note": "Framework co KHUNG bang rui ro (test-plan.md §6, 4 cot trong); doi QC co CACH DIEN. B6=a la ghep hai cai."
+    },
+    "B7": {
+      "date": "2026-08-25",
+      "question": "Hinh dang ket qua dau ra cua /qc-analyze?",
+      "answers": {
+        "1": "B — hai ban: DOC_GAPS.md (nguoi doc) + {UC-ID}-qa-findings.yaml (Review Board). MOT nguon du lieu, hai mat.",
+        "2": "A — --standard chi tra bang 10 cot. KHONG kem TEST_PLAN (thuoc tram 2).",
+        "3": "3/5 lang kinh: D2 xu ly loi · D3 giao dien · D4 du lieu & cau hinh. D1 va D5 TAT (trung voi cho khac).",
+        "4": "GRANULARITY=auto (khong ep min theo tung UC) — tiet kiem ~3 lan cho tinh nang nho.",
+        "5": "In dong Next -> /qc-plan o cuoi lenh (doi QC quen 1 lenh ra ca 2 file)."
+      },
+      "design_notes": [
+        "auto_fixable LUON false + KHONG co --resume: gap phat hien SAU khi code xong, tu sua PRD luc do la sua sau lung ca day chuyen.",
+        "File findings RIENG, khong ghi chung {prd-slug}-findings.yaml — ghi chung pha applied_to_version cua refine-prd.",
+        "VERIFY=off khi goi review-fanout: gap den tu CA 4 ky nang VA fan-out, phai gop truoc roi tham dinh MOT lan (T6 can thay toan bo tap).",
+        "REQUIREMENT_ANALYSIS.md GIU ca o che do --standard: tram 2 va tram 3 doc no."
+      ],
+      "cost": {
+        "measured": "14 lan chay that o repo doi QC: gap trung vi 12 (dai 2-28); cau hinh 4 nguon -> trung binh 9.4 gap; 13/14 lan ra ca TEST_PLAN.",
+        "estimated": "Bat 3 lang kinh ~3 lan token so voi khong bat. Sinh them ban findings ~+3-10%. Kich thuoc tai lieu NGUON van chua do duoc (submodule spec chua checkout)."
+      }
+    },
+    "B8": {
+      "date": "2026-08-25",
+      "question": "Bat lang kinh QC o buoc soat PRD, va chuyen 3 lang kinh len do — co toi uu hon?",
+      "answer": "BAT lang kinh QC o refine-prd. KHONG chuyen 3 lang kinh len. KHONG bo file findings o tram QC.",
+      "why": [
+        "Lang kinh QC goc chi hoi ve HINH THUC (AC co kiem chung duoc khong / co lap tang khong) — tra loi duoc tu PRD mot minh.",
+        "3 lang kinh cua tram QC KHONG chay duoc o thoi diem PRD: D3 can design-spec, D4 mot phan can tech-doc, doi chieu B5 can tech-doc — chua ton tai.",
+        "O thoi diem PRD khong phan biet duoc 'PRD thieu X' voi 'PRD de X cho design-spec'. So lieu: chi-PRD ra 14 gap, du 4 nguon ra 9.4.",
+        "Chi phi: +13% (PRD >=4 UC, da cham chan 12 luong) den +33% (PRD nho). So voi de o tram QC la +300% cua mot lan chay lon."
+      ],
+      "note": "Loc hai tang: tang re (hinh thuc) chay o PRD, tang dat (noi dung) chay o QC tren dau vao da sach hon."
+    },
+    "B9": {
+      "date": "2026-08-25",
+      "question": "Neu mac dinh da ghi 2 file, --standard de lam gi nua?",
+      "answer": "BO --standard. Nang mac dinh len khuon 10 cot cua doi QC. Doi ten file DOC_GAPS.md -> DOC_GAP.md.",
+      "why": [
+        "Khong co cong cu nao doc file gap: grep toan repo doi QC ra DUNG 1 lan, va la mot dong comment trong file test.",
+        "Cot thu 10 (Giao cho doi) KHONG duoc buoc sau doc — no la thong tin cho NGUOI, khong phai khoa lien ket.",
+        "Ban 9 cot thieu dung hai thu PO can (cot Giao cho doi + o cau hoi 4 phan). Giu ban kem lam mac dinh = de nguoi khong biet co co nhan ban kem.",
+        "Hai template = hai cho phai bao tri, roi chung lech nhau — dung benh viec nay dang chua.",
+        "Mot che do ma khac biet duy nhat la 'ghi it file hon' thi khong phai che do."
+      ],
+      "kept_from_framework": "Tu 'Blocker' (khong doi sang 'Critical') vi qc-run-test doc dung tu do de dat qc_owner=po.",
+      "filename": "DOC_GAP.md — bo chu S cho khop tu vung doi QC; khong hau to UC-ID vi thu muc {qc_dir}/{UC-ID}/{platform}/ da mang. Day cung la 1 trong 2 kieu doi QC dung that (4/14 file)."
+    },
+    "B10": {
+      "date": "2026-08-26",
+      "question": "D5 (doi chieu cheo tai lieu) — bat lai khong? Quyet dinh tat o B7 co dung?",
+      "answer": "BAT LAI, THU HEP con 2/4 cap. Quyet dinh tat o B7 la SAI.",
+      "scope_on": [
+        "PRD <-> design-spec/",
+        "bdd/{platform}/ <-> design-spec/"
+      ],
+      "scope_off": [
+        "PRD <-> bdd/  (review-context B1 da lam)",
+        "PRD/bdd <-> tech-docs/  (qc-analyze §Doi chieu tai lieu ky thuat da lam)"
+      ],
+      "why_the_original_decision_was_wrong": [
+        "Ly do tat ban dau 'trung nhieu' DUNG MOT NUA: D5 phu BON cap, chi HAI cap da co nguoi lam.",
+        "Hai cap con lai deu dinh design-spec/ — artifact DUY NHAT trong feature package ma khong tai lieu nao doi chieu NOI DUNG voi no.",
+        "generate-bdd chi kiem 'Built from PRD' = SO PHIEN BAN. Cung phien ban ma noi dung lech thi lot.",
+        "Sai vi suy tu AN TUONG thay vi dem danh sach. Bang kiem chung 31 cau hoi la thu dang le phai lam TRUOC khi quyet."
+      ],
+      "cost": "Re hon mot lang kinh thuong: chi so 2 cap, va design-spec/ thi tram QC DA DOC tu truoc (nam trong danh sach nguon o Gate) — khong nap them file nao. Cau hinh hien tai ~3.5x.",
+      "trap": "design-spec/ (giao dien Designer ve) KHAC tech-docs/ (hop dong he thong). Hai ten tieng Viet nghe gan giong nhau; doc nham la hieu nguoc ket luan. tech-docs/ da duoc B5 phu."
+    }
+  }
+}