Changelog BA-kit: 2026-03-23 to 2026-06-15

Tóm tắt ngắn

Giai đoạn này có các thay đổi lớn:

  • ba-stitch-sync (PR #49, #51, #52, #57): skill mới sync BA-kit screen canon → Stitch MCP. Anti-hallucination hardening qua 4 PR: per-zone negative space markers, field table priority rule, zone coverage gate, exact placeholder directive, per-zone ban table. State variant generation với generate_variants (REFINE + TEXT_CONTENT). 8 anti-hallucination bans cho state delta prompts.
  • ba-content-audit (PR #50, #53): skill mới cross-artifact format & cross-reference consistency audit. Context thrashing fix với 3-layer defense: output-limiting reads, incremental writes, on-disk indexing. ~97% context reduction (3.2MB → ~200K).
  • Cross-platform python3 bootstrap (PR #56): 3-layer defense cho Windows Git Bash, nơi python3 resolve vào Microsoft Store stub.
  • CVE fixes (PR #55): bump vitest 3.1.4→4.1.8 (CVE-2026-47429 CRITICAL 9.8) và playwright 1.52.0→1.55.1 (CVE-2025-59288 HIGH).
  • Pre-tool-use hook fix (PR #54): update pre-tool-use hook trong cả 2 installer.

Các thay đổi trước đó: UI Library Selection Gate, Control Type Library, validator coverage mở rộng, runtime mở rộng Codex/Antigravity, context budget enforcement, SRS canon-first, QC review post-SRS, shared rule/message guardrails, modular artifact source set, Vietnamese wording, cross-function impact, QC export bridge, collaboration workflow, project memory, pre-backbone options flow, PlantUML swimlanes, Community/Paid split.

2026-06-15: Harden state variant generation and anti-hallucination bans

Tóm tắt

PR #57 vá 4 lỗ hổng trong ba-stitch-sync: state variants giờ dùng generate_variants (REFINE + TEXT_CONTENT) qua HatterAgent thay vì generate_screen_from_text qua figaro_agent, base prompt không còn state descriptions để tránh figaro_agent shortcut, sửa generate_variants response parsing path, và mở rộng cross-screen consistency directive bao gồm branding.

Added

  • 8 anti-hallucination bans cho state delta prompts (brand, logo, buttons, links, styling, pre-filled values, fields, translation)
  • session_id tracking cho variant debug

Changed

  • State variants: generate_screen_from_text → generate_variants (HatterAgent thay figaro_agent)
  • Base prompt: loại bỏ state descriptions
  • generate_variants response parsing: fix path outputComponents[0].design.screens[0].id
  • Xoá invalid deviceType/designSystem params khỏi generate_variants calls
  • Cross-screen consistency directive: thêm branding consistency (app name, logo, header, footer)

Ý nghĩa thực tế cho BA

  1. State variants giữ nguyên layout. Không bị Stitch tự ý thay đổi bố cục.
  2. Base screen không bị trộn states. Mỗi prompt chỉ gen 1 screen.
  3. Anti-hallucination toàn diện hơn. Brand, logo, button, link — tất cả có ban directive.

Nguồn

2026-06-14: Cross-platform python3 bootstrap for Windows

Tóm tắt

PR #56 sửa lỗi BA-kit stop hooks thất bại trên Windows Git Bash vì python3 resolve vào Microsoft Store stub (WindowsApps/python3.exe). 3-layer defense: bootstrap_python3() trong install.sh tạo ~/bin/python3 wrapper, hooks viết lại dùng _PY fallback qua for _c in python3 python; do ... done, và cùng bootstrap cho CodeX runtime.

Fix

  • Layer 1: install.sh bootstrap_python3() — tạo wrapper khi python3 mặc định không hoạt động. macOS/Linux: no-op.
  • Layer 2: 4 hooks viết lại dùng _PY fallback — defense-in-depth kể cả khi wrapper bị xoá.
  • Layer 3: install-codex-ba-kit.sh cùng bootstrap.

Verification

  • Stop hooks exit 0 clean, ~/bin/python3 → 3.14.5 (Python thực)
  • macOS/Linux path không đổi

Files

FileChange
install.sh+58
scripts/install-claude-code-ba-kit.sh+90/-8
scripts/install-codex-ba-kit.sh+23

Nguồn

2026-06-14: Bump vitest to 4.1.8 and playwright to 1.55.1 (CVE fixes)

Tóm tắt

PR #55 bump 2 dev dependency trong reverse-web skill sau SkillSpector scan:

DependencyFromToCVE
vitest3.1.44.1.8CVE-2026-47429 (CRITICAL 9.8)
playwright1.52.01.55.1CVE-2025-59288 (HIGH)

49/49 unit tests pass. SkillSpector re-scan: score 100→13, CRITICAL→LOW, DO NOT INSTALL→SAFE.

Files

  • skills/reverse-web/package-lock.json
  • skills/reverse-web/package.json

Nguồn

2026-06-14: Fix pre-tool-use hook in installers

Tóm tắt

PR #54 cập nhật pre-tool-use hook trong cả install-claude-code-ba-kit.sh và install-codex-ba-kit.sh.

Files

  • scripts/install-claude-code-ba-kit.sh
  • scripts/install-codex-ba-kit.sh

Nguồn

2026-06-12: Prevent context thrashing in ba-content-audit

Tóm tắt

PR #53 fix /ba-content-audit tiêu thụ ~3.2MB context cho dự án 150+ file.

Problem: 3 levels of context waste

  • L1: Full-file reads bất kể kích thước
  • L2: Tất cả findings tích luỹ trong memory đến cuối mới write
  • L3: Grep output 20-40KB mỗi batch tràn context

Fix: 3-layer + module-batching

  • L1 — Output-limiting reads: frontmatter offset=0, limit=40, TOC-first 80 dòng, files >10KB không đọc full
  • L2 — Incremental writes: append findings per file
  • L3 — On-disk indexing: write ID index qua Bash, cross-reference qua grep -c
  • Module-batching: ≤60 files single-agent, lớn hơn multi-agent per module

Results

MetricBeforeAfter
Context (61 files)~800KB~73K tokens
Context (4 modules)~3.2MB~200K
Reduction—~97%

Verified

Opus sub-agent audit bnza-admin module: 63 files, 73K tokens, zero compaction, 4.6 min.

Files

  • skills/ba-content-audit/SKILL.md, references/audit-rules.md, references/first-audit-workflow.md, references/re-audit-workflow.md

Nguồn

2026-06-11: Screen state variant generation in ba-stitch-sync

Tóm tắt

PR #52 thêm state variant generation cho ba-stitch-sync:

feat: screen state variant generation

  • Load message list backbone để resolve MSG-* codes → canonical text
  • Extract documented screen states (error, empty, loading, success) với ASCII wireframes
  • Generate state variants per screen với state-specific prompts
  • State prompt sanitizer gate + cross-state consistency check
  • stitch-screen-map.json schema mở rộng: {default, states: {state_name: {...}}}

fix: use generate_variants + schema migration

  • Đổi generate_screen_from_text → generate_variants (REFINE + TEXT_CONTENT)
  • stitch-screen-map.json v1→v2 auto-migration (Step 2.1a)
  • Thêm --skip-states flag

Files

  • core/behavior/stitch-sync.md
  • skills/ba-stitch-sync/SKILL.md

Nguồn

2026-06-11: Harden stitch-sync against Stitch hallucination

Tóm tắt

PR #51 chống Stitch MCP tự ý thêm UI elements không có trong wireframe.

Root Cause

  1. Anti-hallucination directives quá chung → Stitch fill "gaps"
  2. ASCII wireframe và Field Table conflict về widget structure
  3. Không zone coverage check → empty zone bị fill
  4. Placeholder values không exact → Stitch bịa số

Fix

  • Per-zone negative space markers: mỗi zone có explicit ban khi empty
  • Field table priority rule: Field Table = STRUCTURE, wireframe = POSITIONS
  • Zone coverage gate (Check 5): verify 6 zones declared
  • Exact placeholder data directive: "do NOT invent"
  • Per-zone ban table: 7 zones × ban lists + 7 common invention patterns

Files

  • core/behavior/stitch-sync.md
  • skills/ba-stitch-sync/SKILL.md

Nguồn

2026-06-11: ba-content-audit — cross-artifact content audit skill

Tóm tắt

PR #50 thêm skill /ba-content-audit: read-only cross-artifact format & cross-reference audit.

Tính năng

  • Quét toàn bộ BA-kit lifecycle artifacts (intake → backbone → modules → compiled)
  • Report frontmatter compliance, mandatory section presence, cross-reference integrity
  • First-audit + re-audit với finding tracking (NEW/persistent/resolved)
  • Content-hash finding IDs cho re-audit comparison
  • Fix Commands section: map finding → actionable command

Files

  • skills/ba-content-audit/SKILL.md, references/audit-rules.md, references/first-audit-workflow.md, references/re-audit-workflow.md, template/audit-report-template.md
  • core/contract.yaml, docs/skill-catalog.md

Nguồn

2026-06-11: ba-stitch-sync — Stitch MCP design sync command

Tóm tắt

PR #49 thêm skill /ba-stitch-sync: downstream sync BA-kit screen canon → Stitch MCP.

Tính năng

  • Full workflow: preflight gates → design system bootstrap → screen generation → cross-screen audit
  • Step 0.3a: resolve Stitch projectId (list_projects/create_project)
  • Device type: tôn trọng --device flag (không hardcoded DESKTOP)
  • Behavior shard: core/behavior/stitch-sync.md với matching contract entry

Files

  • core/behavior/README.md, core/behavior/stitch-sync.md, core/contract.yaml
  • skills/ba-do/SKILL.md, skills/ba-stitch-sync/SKILL.md

Nguồn

2026-06-10: UI library gate enforcement + interactive prompt + DESIGN.md Section 10

Tóm tắt

PR #48 vá 3 lỗ hổng của gate 5.1a: DESIGN.md template giờ có Section 10 dạng bảng với TBD mặc định, init-control-library CLI chặn nếu chưa chốt, backbone hỗ trợ dual-path — chọn library ngay qua prompt (single-run) hoặc defer để research (two-run).

Added

  • DESIGN.md Section 10 bảng "Thư viện UI" với TBD mặc định, trạng thái chốt
  • init-control-library CLI gate enforcement: parse DESIGN.md, block nếu TBD

Changed

  • Step 5.1a: AskUserQuestion 8 options (6 library + none + "cần research"). Single-run ghi DESIGN.md + tiếp tục luôn. Two-run defer.
  • core/behavior/backbone.md: dual-path policy

Ý nghĩa thực tế cho BA

  1. DESIGN.md có sẵn chỗ điền. Section 10 dạng bảng, không phải tự nghĩ format.
  2. Không bypass được gate. init-control-library cũng bị chặn.
  3. Single-run cho team đã biết. Chọn ngay → xong 1 lần.
  4. Two-run cho team cần research. Vẫn defer được, nhưng là chủ động.

Nguồn

2026-06-10: UI library selection gate between DESIGN.md and control-type-library

Tóm tắt

PR #47 sửa flow backbone: DESIGN.md và control-type-library không còn được tạo cùng lúc. Backbone giờ dừng sau DESIGN.md, chờ user chốt thư viện UI (có thể mất vài giờ/ngày), rồi mới tạo control-type-library ở lần chạy sau.

Added

  • Gate 5.1a: đọc DESIGN.md → TBD/trống = DỪNG kèm gợi ý thư viện; none = qua; tên+version = qua
  • Step 5.2: tạo control-type-library, chỉ chạy sau gate passed

Changed

  • core/behavior/backbone.md: tách output backbone thành 2 step
  • skills/ba-start/steps/backbone.md: đánh số lại, thêm gate flow

Ý nghĩa thực tế cho BA

  1. Không còn baseline sai. User có thời gian research trước khi file được sinh.
  2. Gate rõ ràng. 3 trạng thái dễ hiểu, không đoán mò.
  3. Tương thích ngược. DESIGN.md có sẵn library → gate passed ngay.

Nguồn

2026-06-10: Backbone index validator coverage and path resolution

Tóm tắt

PR #46 sửa 3 vấn đề: validator không hard fail mù mờ nữa, phát hiện format inconsistency (FR-1 vs FR-01), và tách source-repo/project-repo path resolution trong tất cả CLI command.

Added

  • validate-shared-rule-message-registry CLI command — kiểm tra CR/MSG registry khớp module usage, có --write-index
  • format-sibling detection trong validate-index-quality.py
  • per-section ID extraction trong context-budget-bootstrap.py
  • source-repo vs project-repo path resolution trong ba-kit CLI

Changed

  • CLAUDE.md: Source Repo Fix Rule — sửa trong source repo, không sửa file đã cài
  • ID conventions: US-\{NNN\} → US-\{module\}-\{NNN\}, AC/UC tương tự
  • guardrail_common.py: mở rộng coverage patterns (BG, PORTAL, F, EP, R, MEM, A\{N\})
  • Step files: Glob → ba-kit resolve cho directory discovery
  • contract-behavior.md: dùng bash ls -d/find -type d cho slug/date resolution

Ý nghĩa thực tế cho BA

  1. Validator báo lỗi rõ ràng. Biết chính xác ID nào thiếu, section nào, format gợi ý.
  2. Format inconsistency được catch sớm. FR-1 vs FR-01 không còn báo missing.
  3. CLI chạy đúng mọi thư mục. Tách source/project repo path.
  4. US/AC/UC có module prefix. Không collision cross-module.

Nguồn

2026-06-10: Control Type Library và behaviour guardrails

Tóm tắt

PR #45 thêm Control Type Library — artifact cấp backbone với 20 control type chuẩn. Khi BA chọn thư viện UI (Shadcn, Ant Design), backbone tự "tỉa" (prune) behaviour trùng library default, chỉ giữ deviation. Kèm 6 guardrail script + postwrite hook.

Added

  • control-type-library-template.md — 20 control type chuẩn
  • 6 guardrail scripts: control-type compliance, message placement, CR coverage, terminology, freshness, compiled output verification
  • postwrite-guardrail.sh — tự động chạy guardrail sau mỗi lần ghi file
  • test-control-type-behaviour-guardrails.sh — 249 dòng test
  • doc-engine-shell.html & doc-engine-tailwind.html — HTML template compiled output
  • ba-kit CLI: 6 subcommand mới + init-control-library

Changed

  • core/contract.yaml: thêm control_type_library vào backbone outputs
  • check-screen-behaviour.py: thêm (default) keyword, cột Control Type, Field ID
  • skills/ba-start/steps/backbone.md: baseline pruning flow
  • Installer: wire 14 guardrail scripts cho 3 runtime

Ý nghĩa thực tế cho BA

  1. Không mô tả lại behaviour library đã làm sẵn. Chỉ mô tả deviation.
  2. Control type nhất quán toàn dự án. Mọi module dùng chung bộ từ backbone.
  3. Guardrail chạy tự động. Postwrite hook bắt lỗi sớm.
  4. Message placement đầy đủ. Mọi MSG-* phải có dòng trong bảng Message Placement.

Nguồn

2026-06-10: Update README layout

Tóm tắt

PR #44 tinh chỉnh README: mô tả xuống dưới badges, bỏ star/fork counters, sửa badge format.

Nguồn

2026-06-10: Update README badges and description

Tóm tắt

PR #43 thêm GitHub badge bakit-org/bakit, cấu trúc lại header.

Nguồn

2026-05-29: BA-to-QC export bridge command

Tóm tắt

PR #26 thêm lệnh ba-kit qc-export — cầu nối một chiều từ BA-kit sang QC-kit. Lệnh này đọc toàn bộ canon artifact của một module và tự động tạo ra bộ input đúng định dạng mà QC-kit mong đợi, với 6-section output cho mỗi UC và write-scope guardrails bảo vệ canon source.

Added

  • thêm script scripts/qc-export.py (~500 dòng Python) làm export engine.
  • thêm CLI route ba-kit qc-export --slug <slug> --date <YYMMDD-HHmm> --module <module_slug> [--external-output <dir>] [--usecase-list].
  • thêm skill definition skills/ba-qc-export/SKILL.md và template templates/qc-export-usecase-template.md.
  • thêm test script scripts/test-qc-export.sh (10 test case, 20/20 passing) và test fixture tests/qc-export/ (8 file).
  • thêm 8 path entries trong core/contract.yaml cho qc_export paths.
  • thêm routing trong core/workflows/do.md cho intent "xuất cho QC", "export QC", "qc handoff".

Changed

  • Write-scope guard (scripts/check-write-scope.py): thêm rule cho qc-export — output phải nằm trong 04_compiled/qc-kit/, cấm ghi canon. Dùng boundary-aware path matching.
  • Bridge note: cập nhật input framing (đọc UC canon trực tiếp, compiled SRS là fallback), output path plan-scoped, thêm phần Decisions.

Ý nghĩa thực tế cho BA

  1. Một lệnh duy nhất để chuẩn bị input cho QC. Không còn copy-paste thủ công hay định dạng lại tài liệu.
  2. Tất cả CR/MSG/BR codes được resolve tự động thành text đầy đủ. QC không cần đọc thêm file nào khác.
  3. Cross-function data được export tự động vào §4 Functional Integration với trạng thái Resolved/Pending/Mismatch.
  4. Write-scope guardrail đảm bảo export không bao giờ ghi đè lên canon artifact.
  5. Validation trước khi ghi: UC không hợp lệ bị báo lỗi và không được export.
  6. Hỗ trợ --external-output để export thẳng vào QC-kit repo, có validate chống ghi vào repo root.

Nguồn

2026-05-29: Cross-function impact declarations across BA-kit

Tóm tắt

PR #25 thêm khả năng khai báo mối quan hệ chéo giữa các use case — một UC phụ thuộc vào UC nào, và nó tạo ra dữ liệu gì cho UC khác dùng — qua 5 điểm chạm: UC template, QC review scoring, SRS assembly, impact analysis, và bridge export.

Added

  • thêm section ## Cross-Function Impact vào UC template với 2 bảng: Within Module và Across Modules.
  • thêm 3 loại dependency: Input, Output/Trigger, Shared State.
  • thêm design note docs/cross-function-impact-analysis-note.md và plan directory với 5 phase files.

Changed

  • QC UC Review KA #8: cập nhật scoring rubric để check ## Cross-Function Impact. UC không có section này score Partial.
  • SRS assembly: thêm Step 10.5 cross-function inlining khi compile UC.
  • ba-impact: thêm Cross-Function Propagation với Reverse Inbound Scan (luôn chạy) và Outbound Tracing (khi UC có khai báo dependency).
  • Bridge note: document §4 mapping — cross-function data export vào ### Functional Integration.
  • Compile receipt template: thêm section ## Cross-Function Inlining.

Ý nghĩa thực tế cho BA

  1. Khi viết UC, bạn khai báo rõ UC này cần gì từ UC khác và tạo ra gì cho UC khác. Không còn phải đoán.
  2. Khi một UC thay đổi, ba-impact tự động tìm tất cả UC bị ảnh hưởng — cả downstream lẫn upstream.
  3. QC review giờ đánh giá được cross-function completeness qua bảng dependency thay vì suy đoán từ text.
  4. Cross-module dependencies hoạt động ngay cả khi module bên kia chưa được viết, nhờ backbone feature ID làm mỏ neo.
  5. Khi export cho QC, cross-function data xuất hiện tự động trong §4 dưới dạng bảng Functional Integration.

Nguồn

2026-05-28: BA-facing output speaks more naturally in Vietnamese

Tóm tắt

PR #22 chỉnh lại lớp ngôn ngữ của BA-kit để output dành cho BA và stakeholder đọc giống tài liệu làm việc thật hơn, không giống log kỹ thuật hoặc bản dịch cứng.

Thay đổi này không đổi core workflow. Nó tập trung vào cách BA-kit gọi tên tài liệu, trình bày trạng thái, đóng gói output và viết phần tóm tắt SRS. Các cụm như source of truth, decision ledger, Artifact Emission Gates được thay bằng cách nói rõ nghĩa hơn bằng tiếng Việt, để người dùng hiểu nhanh đang đọc gì và cần làm gì tiếp theo.

Added

  • thêm wording-layer policy và terminology matrix cho artifact user_facing
  • thêm phần Tóm tắt dành cho BA và stakeholder vào SRS template
  • thêm template mới phục vụ wording/status output thân thiện hơn

Changed

  • đổi nhiều nhãn reader-facing sang tiếng Việt tự nhiên hơn, ví dụ source of truth thành tài liệu nguồn chuẩn
  • humanize các phần status, next-step display và delivery/package summary
  • localize badge, label, summary, metadata grid và toolbar wording trong packaged HTML output
  • cập nhật README, step-by-step guide, skill catalog và các template liên quan để dùng cùng terminology mới
  • cập nhật golden strings trong test để khóa wording mới

Ý nghĩa thực tế cho BA

  • Output BA-kit dễ đưa cho stakeholder đọc hơn, ít cần dịch lại sau khi generate
  • BA mới dễ hiểu trạng thái tài liệu, bước tiếp theo và artifact nào là bản cần đọc/sửa
  • SRS có phần tóm tắt mở đầu rõ hơn trước khi đi vào nội dung chi tiết
  • Package HTML và status report dùng cùng một cách gọi, giảm cảm giác mỗi màn nói một kiểu

Nguồn

2026-05-28: BA-start adopts modular artifact source sets

Tóm tắt

PR #21 chuyển BA-start/SRS từ legacy source-of-truth như srs-index.md, screens/, usecases/, user-stories.md và compiled srs.md sang source set rõ ràng theo module.

Source set mới gồm userstories/, usecases/, ascii-screen/ và srs/. Compiled srs.md vẫn là deliverable để đọc/review, nhưng khi module đã có source set thì BA phải sửa source trước rồi compile lại.

Added

  • thêm validators cho userstories/, usecases/, ascii-screen/, shared traceability và partial SRS compile receipt
  • thêm fixture greenfield cho kiến trúc artifact mới
  • thêm templates mới cho user stories, use cases, ASCII screens, SRS slices, ERD/flows/states và shared traceability

Changed

  • ba-start stories/SRS/wireframes/impact/package steps đọc và ghi theo source set mới
  • doctor-srs và contract sync kiểm tra source-set completeness thay vì phụ thuộc legacy index/canon files
  • QC review, Figma sync, package/status/next, context budget và token budget được cập nhật để dùng cùng layout mới
  • legacy templates như screen canon, use case canon, SRS index và user-story template được gỡ để tránh sinh path cũ

Ý nghĩa thực tế cho BA

  • Sửa module requirements trong userstories/, usecases/, ascii-screen/ và srs/, không sửa compiled srs.md như nguồn chính
  • doctor-srs báo rõ source family hoặc receipt nào còn thiếu trước khi package/sync Figma
  • Team nhiều BA dễ chia file ownership hơn vì stories, use cases, ASCII screens và SRS slices tách folder rõ ràng

Nguồn

2026-05-26: QC review now runs after SRS, inside each module

Tóm tắt

PR #19 dời qc-review sang đúng thời điểm dễ hiểu hơn: sau khi một module đã có srs xong. Thay vì quét quá sớm hoặc đọc tài liệu quá rộng, QC giờ ưu tiên đọc đúng bộ nguồn của module đó như srs-index.md, usecases/*.md, screens/*.md và screen-field-contract.yaml.

Report QC cũng không còn nằm ở chỗ chung khó lần. Nó được lưu ngay trong 03_modules/{module_slug}/qc-review/, nên mở module nào là thấy report của module đó luôn.

Changed

  • qc-review giờ được auto-trigger sau bước srs, thay cho các gate cũ kiểu pre-SRS, pre-wireframe
  • QC ưu tiên đọc bộ canon của module trước, rồi mới dùng compiled SRS hay wireframe cũ như bằng chứng phụ nếu thật sự cần
  • report và question backlog của QC được đưa vào đúng folder module, dễ tìm và dễ giao lại cho BA khác
  • runtime docs, skill docs và contract đều được viết lại để phản ánh flow mới
  • thêm parity fixtures f27 và f28 để khóa hành vi mới: sau srs thì QC chạy, còn wireframes thì không tự gọi QC nữa

Ý nghĩa thực tế cho BA

  • Viết xong srs của module rồi mới QC, nên kết quả review bám đúng tài liệu BA đang dùng thật
  • Khi QC báo lỗi, BA nhìn đúng file nguồn của module để sửa, không phải đoán đang lệch ở bản compiled hay wireframe cũ
  • Handoff nội bộ dễ hơn vì report nằm cạnh luôn thư mục module

Nguồn

2026-05-25: Shared rule/message guardrails and artifact folder layout

Phần này thuộc BA-kit Paid. Paid Docs là public để đọc hướng dẫn, nhưng repo tính năng thực tế vẫn là private.

Added

  • thêm templates/common-rules-template.md cho backbone-owned registry của reusable CR-*
  • thêm templates/message-list-template.md cho backbone-owned registry của reusable MSG-*
  • thêm templates/shared-rule-message-index-template.md để runtime đọc index trước khi mở full registry
  • thêm scripts/validate-shared-rule-message-registry.py để bắt undeclared CR/MSG codes, duplicate/collision, module-local definitions và screen field references sai
  • thêm folder layout rõ hơn cho srs-groups/, wireframes/, tool-lanes/figma-make/ và figma-sync/

Changed

  • core/contract.yaml cập nhật path contract cho shared rule/message registries và output folder mới
  • scripts/ba-kit, doctor-srs.py, check-screen-canon-schema.py và check-write-scope.py validate layout/references mới
  • Figma sync và Figma Make docs/skills đổi output path sang figma-sync/ và tool-lanes/figma-make/
  • SRS template giảm duplication bằng cách tham chiếu shared rule/message registry thay vì nhúng định nghĩa local không kiểm soát

Ý nghĩa thực tế cho BA

  • Shared validation rules và UI messages phải được khai báo ở 02_backbone/common-rules.md hoặc 02_backbone/message-list.md
  • Module SRS, screen canon và screen field contract chỉ reference CR-* / MSG-* đã khai báo
  • Nếu module cần rule/message mới, cập nhật backbone registry trước rồi rerun validator
  • shared-rule-message-index.md là entry point nhẹ để agent kiểm tra code trước khi mở registry đầy đủ
  • Folder layout mới tách source canon, legacy wireframes, Figma Make control pack và Figma sync reports

Nguồn

2026-05-25: SRS canon-first, ASCII wireframes, and Figma sync guardrails

Phần này thuộc BA-kit Paid. Paid Docs là public để đọc hướng dẫn, nhưng repo tính năng thực tế vẫn là private.

Added

  • thêm templates/screen-canon-template.md và templates/usecase-canon-template.md cho canon screen/use case theo module
  • thêm templates/shared-shell-contract-template.md, shared-shell-index-template.md và srs-compile-receipt-template.md
  • thêm templates/figma-sync-report-template.md và figma-mismatch-report-template.md
  • thêm skills/ba-figma-sync/SKILL.md, codex/skills/ba-figma-sync/SKILL.md và core/behavior/figma-sync.md
  • thêm hard guardrail scripts cho SRS canon schema, source-of-truth, SRS index consistency, write scope và doctor-srs
  • thêm docs/ba-kit-step-by-step-guide.md cho người mới dùng BA-kit Paid

Changed

  • scripts/ba-kit thêm helper cho SRS doctor, write-scope check, SRS index consistency và prerequisite checks
  • core/contract.yaml thêm SRS canon artifacts, shared shell artifacts và Figma sync outputs
  • core/authoring-guardrails.yaml thêm guardrails cho source-of-truth, command write scope và canon consistency
  • ba-start SRS/wireframe/status/package steps được cập nhật để ưu tiên canon và compile receipt thay vì legacy wireframe source
  • README.md, docs/getting-started.md, docs/skill-catalog.md và docs/runtime-hard-guardrails.md phản ánh flow mới

Ý nghĩa thực tế cho BA

  • Sửa screens/*.md, usecases/*.md, optional data/ hoặc flows/ trước; sau đó compile lại srs.md
  • srs-index.md và srs-compile-receipt.json giúp agent/reviewer biết đọc gì và compiled SRS khớp canon nào
  • shared shell giữ menu/layout ở system layer, giảm rủi ro mỗi module tự định nghĩa navigation
  • ba-figma-sync chỉ đồng bộ visual downstream và ghi sync/mismatch report; không sửa BA canon
  • guide từng bước public nằm ở /docs/paid/step-by-step-guide

Nguồn

2026-05-22: Figma Make wireframe guardrails

Phần này thuộc BA-kit Paid. Paid Docs là public để đọc hướng dẫn, nhưng repo tính năng thực tế vẫn là private.

Added

  • thêm docs/figma-make-lane.md và docs/figma-make-sample-bundle.md — docs giải thích lane, sample bundle và expected artifacts cho Figma Make handoff
  • thêm templates/screen-field-contract-template.yaml — machine-facing screen field contract để compile field behavior thành input ổn định cho tool lane
  • thêm templates/make-guidelines-template.md, make-prompt-pack-template.md, figma-make-shared-component-contracts-template.md, figma-make-shared-prompt-skeleton-template.md, figma-make-shared-rules-template.md, tool-lane-state-template.md — shared prompt/rules/components/state surfaces cho Step 9
  • thêm templates/prototype-conformance-checklist-template.md và prototype-conformance-report-template.md — checklist/report để review prototype output theo contract
  • thêm scripts/validate-tool-control-pack.py và generate-prototype-conformance-report.py — validator + report generator cho tool-control pack và prototype conformance
  • thêm docs/code-standards.md, docs/codebase-summary.md, docs/project-roadmap.md, docs/system-architecture.md — maintainer docs ship cùng PR

Changed

  • core/contract.yaml — thêm Step 9 tool-lane artifacts và contract entries cho Figma Make guardrails
  • core/behavior/wireframes.md, skills/ba-start/steps/{wireframes,srs-core,srs-wireframes}.md — nối flow mới vào SRS/wireframe path
  • scripts/test-contract-sync.sh — mở rộng validation cho contract sync mới
  • scripts/context-budget.py và core/token-budget.md — cập nhật context-budget/token-budget cho lane artifacts mới
  • templates/manifest.json — thêm template inventory cho Figma Make flow

Ý nghĩa thực tế cho BA

  • Step 9 không còn chỉ là prose handoff; BA có thêm contract machine-facing để truyền field behavior cho Figma Make ổn định hơn
  • prompt pack, shared rules và component contracts giúp giảm drift giữa nhiều màn cùng portal khi generate prototype
  • validator script giúp bắt mismatch sớm trước khi handoff/review thay vì đợi tới prototype output
  • prototype conformance checklist/report tạo review surface rõ ràng hơn để so prototype với source contract
  • hướng dẫn sử dụng public nằm ở /docs/paid/figma-make/usage

Nguồn

2026-05-19: Reverse-web — Playwright crawl engine + synthesis skill + 57 tests

Added

  • thêm skills/reverse-web/lib/crawl-engine.js — BFS crawl engine với 7 GuardrailViolation errors (G1–G7), passive network listener, domcontentloaded + MutationObserver wait strategy, incremental sitemap với atomic writes
  • thêm skills/reverse-web/lib/guardrails.js, dom-extractor.js, network-listener.js, evidence-index-builder.js, sensitive-scanner.js, sitemap-builder.js, robots-parser.js, wait-strategy.js — modular crawl engine components
  • thêm skills/reverse-web/scripts/crawl.js — CLI entry point với --continue mode và --clean flag có path containment guard
  • thêm skills/reverse-web/SKILL.md — synthesis skill: PII gate, evidence-index-first read, điền intake-form-template.md 8 phần tiếng Việt, L1 approval gate
  • thêm skills/reverse-web/references/evidence-to-intake-mapping.md và synthesis-prompts.md — traceability và extraction guidance
  • thêm 57 tests (49 unit + 8 integration) với local Express test server, setup script và vitest config

Ý nghĩa thực tế cho BA

  • chạy crawl.js để thu thập evidence từ website có sẵn thay vì browse thủ công
  • evidence-index.md là entry point cho session AI: đọc index trước, selective DOM/network/screenshots theo nhu cầu
  • SKILL.md hướng dẫn Claude điền thẳng vào intake-form-template.md, output feed trực tiếp vào ba-start lifecycle
  • 7 code-enforced guardrails (throw GuardrailViolation) đảm bảo crawl fail rõ ràng; --continue mode cho phép resume crawl bị gián đoạn

2026-05-18: QC UC Review — platform-parameterized quality gate engine

Added

  • thêm skills/qc-uc-review/SKILL.md — entry point cho QC UC Review skill với platform dispatch và scoring rubric
  • thêm skills/qc-uc-review/profiles/mobile.md, web.md, api.md — 3 platform profiles với edge cases riêng
  • thêm skills/qc-uc-review/references/ — scoring rubric, first-audit workflow, re-audit workflow
  • thêm skills/qc-uc-review/template/UC_readiness_review_template_v3.md — template chuẩn cho UC review output
  • thêm skills/qc-uc-review/CHANGELOG.md — independent semver versioning
  • thêm .github/CODEOWNERS — governance assign @qc-team
  • thêm core/behavior/qc-review.md — behavior shard cho qc-review command

Changed

  • core/contract.yaml — thêm qc-review command, 3 quality gates (pre_srs, pre_wireframe, pre_package), behavior shard mapping
  • core/contract-behavior.md — thêm lifecycle gate enforcement và auto-remediation loop contract

Ý nghĩa thực tế cho BA

  • chạy /qc-review --platform mobile|web|api để audit UC readiness trước khi tiến lifecycle
  • 3 quality gates tự động chặn progression nếu UC chưa đạt threshold
  • auto-remediation loop tự sửa gaps tối đa 2 lần trước khi escalate
  • platform profiles đảm bảo edge cases phù hợp context (gesture/offline cho mobile, navigation/session cho web, payload/auth cho API)

2026-05-18: Brainstorm skill — pre-intake idea clarification

Added

  • thêm skills/brainstorm/SKILL.md — entry point cho brainstorm skill với 7-section deep interview mode
  • thêm skills/brainstorm/references/example-brainstorm.md — ví dụ output brainstorm hoàn chỉnh
  • thêm 6 rule files: brainstorm-conventions, brainstorm-approval-gate, brainstorm-naming-conventions, brainstorm-keyword-detection, brainstorm-resolve-oqs, brainstorm-changelog
  • thêm templates/brainstorm-template.md — template chuẩn cho brainstorm output

Changed

  • core/workflows/do.md — thêm routing row để vague idea-stage text route sang /brainstorm
  • core/workflows/next.md — thêm pre-intake hint khi chưa có project, gợi ý /brainstorm
  • docs/skill-catalog.md — thêm brainstorm vào skill catalog

Ý nghĩa thực tế cho BA

  • khi BA có ý tưởng thô, chạy /brainstorm để interview sâu 7 phần trước khi vào intake
  • output brainstorm feed thẳng vào ba-start intake mà không cần reformat
  • ba-do tự nhận diện vague idea-stage text và route sang brainstorm
  • ba-next gợi ý brainstorm khi chưa có project nào tồn tại

2026-05-15: Reverse-to-document mode

Added

  • thêm core/behavior/reverse.md — behavior shard cho reverse command routing
  • thêm templates/reverse-baseline-lock-template.md — schema canonical cho reverse baseline lock file
  • thêm skills/ba-start/steps/reverse-status.md — step trả status của reverse session hiện tại
  • thêm scripts/scaffold-antigravity-certification.py để scaffold round certification Antigravity trong tương lai
  • thêm fixture f26 và golden xác nhận reverse-backed SRS bỏ qua design gate
  • thêm Antigravity manual certifications f21–f26, tất cả đều PASS

Changed

  • core/behavior/srs.md — thêm nhánh reverse để SRS step nhận ra khi đang trong reverse session
  • core/contract-behavior.md và workflows/{impact,next}.md — hook reverse vào lifecycle router và next-step recommendations
  • skills/ba-start/steps/reverse.md — cập nhật HITL focus-gate cho reverse flow
  • skills/ba-start/steps/srs-wireframes.md và srs.md — thêm SRS-without-design path khi chạy từ reverse session
  • scripts/reverse-preflight.py, -drift-check.py, -validate-index.py, -build-excerpts.py, -read-audit.py, -trace-audit.py, reverse_guardrail_common.py — hardened 6 module guardrail chuyên biệt cho reverse
  • scripts/runtime-parity-adapter.sh — sửa Codex exec invocation và stdin leak
  • scripts/runtime-parity-normalize.py — thêm compact-mode và canonical enum rules

Ý nghĩa thực tế cho BA

  • khi project đã có source code hoặc artifact có sẵn, BA chạy ba-start reverse để extract requirements ngược lên thay vì đi lại từ đầu theo forward flow
  • reverse session bỏ qua design gate và wireframe gate nhưng vẫn giữ HITL focus-gate để BA xác nhận phạm vi
  • drift-check cảnh báo khi source artifact thay đổi sau lần reverse gần nhất, tránh deliverable lệch thực tế
  • parity Codex/Claude Code/Antigravity đã được xác nhận trên f21–f26

2026-05-15: Runtime guardrails và index validation

Added

  • thêm guardrail-preflight.py, guardrail-build-excerpts.py, guardrail-audit.py và guardrail_common.py để quyết định read allowlist/denylist, excerpt path và audit ngoài model
  • thêm validate-index-quality.py để chỉ index đã qua validation mới được promote sang stale_status: current
  • thêm receipt templates cho impact, options, index validation và package snapshot
  • thêm fixture/golden parity mới cho frd, stories, package, status và next, cùng smoke tests guardrail/index quality

Changed

  • core/contract.yaml có output modes probe, delta, full cho adapter runtime thấp-token
  • core/contract-behavior.md chuẩn hóa lifecycle statuses, options decision-ledger gate, routeable backbone re-entry và producer-side index validation contract
  • installer/runtime adapter của Codex được cập nhật để ship guardrail bundle, re-run preflight theo action và inject packet compact thay vì broad context
  • status và next ưu tiên canonical artifact state, chỉ dùng PROJECT-HOME.md như dashboard compact

Ý nghĩa thực tế cho BA

  • khi index còn current, runtime có thể route từ index sang excerpt đúng phần thay vì đọc rộng cả artifact lớn
  • khi index stale/missing/contradictory, BA-kit trả block hoặc refresh command sớm hơn
  • parity giữa Codex, Claude Code và Antigravity chặt hơn vì cùng packet shape và cùng validator contract

2026-05-11: Runtime token shards

Added

  • thêm core/behavior/ với các behavior shard theo command: intake, backbone/options, impact, module authoring, SRS, wireframes, package/status/next
  • thêm mapping behavior_shards.<command> trong core/contract.yaml để runtime chỉ đọc shard cần thiết cho command hiện tại
  • thêm scripts/check-token-budget.py để chạy token budget check đa nền tảng, gồm cả Windows/PowerShell
  • thêm maintainer doc docs/runtime-token-optimization.md và implementation plan runtime-neutral token optimization

Changed

  • ba-start đọc theo thứ tự contract -> shared behavior -> command behavior shard -> step file, thay vì kéo nhiều policy vào mọi command
  • runtime policy files cho Codex, Claude Code và Antigravity cùng trỏ về contract + shard mapping chung
  • SRS và wireframe steps được rút gọn, còn rule dùng chung chuyển sang behavior shard tương ứng
  • templates/manifest.json có routing metadata cho grouped SRS template để agent không cần load full template khi chỉ cần một group

Ý nghĩa thực tế cho BA

  • BA-kit giữ cùng lifecycle, HITL gate và source-of-truth order nhưng giảm lượng instruction phải nạp ở từng command.
  • Maintainer có thể kiểm soát token budget trên Windows mà không cần Bash.

2026-05-11: Navigation schema guardrails

Added

  • thêm validate-navigation-consistency.py để đối chiếu Navigation Schema trong DESIGN.md với Screen Contract Plus.
  • thêm fixture test cho tình huống menu phẳng và menu nested, ví dụ Product Approvals so với Catalog > Approvals.
  • nối navigation consistency check vào contract-sync để core workflow có guardrail cơ học thay vì chỉ dựa vào prose.

Changed

  • Group C của SRS phải dùng paths.design_doc khi có UI-backed screens và không được tự suy luận active menu từ backbone.
  • Expected Active Menu Item phải khớp menu item hoặc active path đã khai báo trong Navigation Schema.
  • SRS, wireframe handoff và assembly đều chặn mismatch navigation trước khi tiếp tục.

Ý nghĩa thực tế cho BA

  • BA chốt menu toàn cục trong DESIGN.md; module chỉ snapshot lại schema đã duyệt.
  • Nếu module cần menu mới hoặc đổi từ menu phẳng sang nested menu, thay đổi phải đi qua impact/design refresh thay vì sửa âm thầm trong SRS.
  • Handoff wireframe có căn cứ rõ hơn để kiểm tra active menu, breadcrumb và hidden-navigation exceptions.

2026-05-11: Token optimization và compact internal artifacts

Added

  • thêm 00_source/chunk-index.md cho source extraction để agent chọn chunk theo heading, keyword và excerpt ngắn thay vì đọc raw source lớn.
  • thêm backbone-index.md, user-stories-index.md và srs-index.md như navigator cho downstream steps.
  • thêm artifact_profiles để phân loại output thành user_facing, agent_facing và machine_facing.
  • thêm ba-kit context-budget để audit read-context byte theo command và path profile.

Changed

  • downstream steps đọc index trước, rồi chỉ mở section/chunk liên quan khi cần.
  • internal templates như project memory/index/module shard được compact để không trở thành monolith thứ hai.
  • contract-sync có guardrail cho internal template size và freshness metadata.

Ý nghĩa thực tế cho BA

  • BA vẫn nhận deliverable đầy đủ ở các artifact chính, nhưng agent không cần nạp mọi file lớn để tiếp tục làm việc.
  • Các file nội bộ dùng để điều hướng, audit hoặc state sẽ ngắn hơn và dễ kiểm tra nhanh hơn.
  • Khi có CR hoặc impact analysis, agent có thêm route để xác định đúng phần bị ảnh hưởng trước khi rerun.

2026-05-07: Community-first site và split public docs

Added

  • thêm Community Docs và Paid Docs như hai khu public rõ ràng trong docs
  • thêm comparison bridge giữa Community và Paid

Changed

  • CTA chính trên bakit-site chuyển sang Get started for free cho Community
  • docs home chuyển từ một tree trộn chung sang surfacing rõ Community/Paid
  • Terms of Service chuyển thành boundary page cho private Paid repo thay vì primary funnel

2026-05-06: Pre-backbone options flow

Added

  • thêm step ba-start options để tạo option pack và comparison trước backbone khi intake cho thấy cần nhiều hướng solution (b6eda56)
  • thêm explicit decision path --select option-0x hoặc --skip để không sang backbone khi hướng đi vẫn chưa được khóa (b6eda56)
  • thêm recommendation gate từ intake để PROJECT-HOME.md và workflow có thể báo khi nào nên chạy options thay vì nhảy thẳng vào backbone (f2b1691)

Changed

  • cập nhật routing của ba-do để các intent như brainstorm solution, so sánh phương án, chọn hướng hoặc bỏ qua optioning được map vào ba-start options (708b5d4)
  • cập nhật ba-next và backbone gating để bước an toàn tiếp theo có thể là options khi optioning đang được recommend hoặc đang dở (708b5d4)
  • cập nhật README, Getting Started, Codex Setup và Skill Catalog trong core repo để command surface và lifecycle public bám đúng flow mới (67fa946)

Ý nghĩa thực tế cho BA

  • Nếu intake có nhiều hướng solution hợp lý, BA không cần ép viết backbone.md quá sớm.
  • Option pack giúp team so sánh 1-3 hướng chính trước khi khóa source of truth.
  • Khi đã chốt hướng, BA mới chạy backbone để downstream artifacts bám trên một quyết định đã rõ.

2026-05-05: PlantUML swimlanes và diagram rendering update

Changed

  • đổi chuẩn swimlane trong FRD và SRS từ Mermaid sang PlantUML để biểu diễn lane actor/system rõ hơn (e519c00)
  • giữ Mermaid cho sequence diagram, data flow diagram, ERD và các flow đơn giản không cần swimlane (e519c00, b0c592a)
  • cập nhật rule, config, template và docs của core repo để thống nhất guideline mới cho diagram syntax (e519c00, b0c592a)

Fixed

  • cập nhật md-to-html để render fenced block plantuml thành SVG-backed image trong packaged HTML, giúp stakeholder copy vẫn xem được diagram khi mở bằng browser (e519c00)
  • khôi phục tương thích --no-editor cho CLI packaging hiện tại để docs/test không bị gãy theo syntax cũ (e519c00)

2026-04-28: BA-friendly collaboration workflow

Added

  • thêm skill ba-collab cho Claude Code và Codex để route intent cộng tác bằng ngôn ngữ BA sang module ownership, review packet và optional GitHub handoff (dcb4b9f)
  • thêm workflow core core/workflows/collab.md với intent mapping, ownership checks, trạng thái module/review chuẩn và approval gate cho external side effects (dcb4b9f)
  • thêm template COLLAB-HOME.md, MODULE-HOME.md, PROJECT-HOME.md và module review packet để BA team theo dõi ai làm gì, trạng thái review, blocker và cross-module risk (dcb4b9f)

Changed

  • cập nhật ba-do để nhận diện các câu như “Tôi nhận module X”, “Gửi module X cho Lead BA review”, “Tạo PR cho module X” và route sang collaboration workflow (dcb4b9f)
  • cập nhật ba-start và project flow để tạo hoặc refresh PROJECT-HOME.md như dashboard BA-facing, nhưng vẫn giữ source of truth ở intake, backbone và module artifacts (dcb4b9f)
  • mở rộng contract behavior và contract.yaml để thêm path/state cho collaboration artifacts, module ownership, review status và GitHub handoff rules (dcb4b9f)
  • cập nhật docs setup, README và skill catalog để mô tả collaboration flow mới cho Claude Code, Codex và Antigravity (dcb4b9f)
  • cập nhật GitBook collaboration guidance để mỗi intent có ví dụ tương ứng cho Claude Code slash command, Codex $skill và Antigravity prompt workflow (dcb4b9f)
  • cập nhật Foundations để thêm PROJECT-HOME.md, COLLAB-HOME.md, MODULE-HOME.md, review packet, governance và source-of-truth hierarchy mới (dcb4b9f)
  • làm rõ NLP-first local Git sync: BA nói “Đồng bộ module X với main”, agent xử lý Git local nếu an toàn; publish actions vẫn cần approval rõ (dcb4b9f)
  • cập nhật installer/runtime generation để phân phối ba-collab và templates mới nhất quán giữa các runtime (dcb4b9f)

Fixed

  • giảm rủi ro BA Member tự commit/push/PR/merge PR khi chưa được approve bằng cách coi GitHub là transport layer optional, không phải workflow chính cho BA (dcb4b9f)
  • làm rõ escalation khi module change chạm backbone, DESIGN.md, hot/global memory, module khác hoặc shared decision; các thay đổi requirement phải route qua ba-impact trước (dcb4b9f)

2026-04-24: adaptive memory, activation parity và runtime verification

Added

  • thêm adaptive runtime memory architecture cho BA-kit, gồm project-memory.md compact mode và cây shard project-memory/ cho dự án phức tạp (8cbd2b9)
  • thêm các template memory mới cho compact summary, memory index, hot shards, warm module shards, cold archive, log, memory packet và file-back promotion record (8cbd2b9, 145c33b)
  • thêm activation contract với các mức Base, Modular, Program, dựa trên tín hiệu như số module, số owner, cross-module dependency và delegation slice count (8cbd2b9, 6200784)
  • thêm runtime parity harness, golden fixtures và adapter scaffold để kiểm tra behavior envelope giữa Claude Code, Codex và Antigravity (8cbd2b9, 145c33b)
  • thêm maintainer release checklist và runtime install smoke test cho rollout nhiều runtime (145c33b)

Changed

  • tách core/contract.yaml làm data layer canonical và core/contract-behavior.md làm behavior layer canonical, giúp path/threshold và policy intent rõ nguồn hơn (2c3f6c1, 6200784)
  • chuẩn hóa deterministic read scope theo từng command: summary trước, index sau, chỉ đọc shard liên quan thay vì nạp toàn bộ artifact tree (2c3f6c1, 145c33b)
  • siết contract cho granular artifact intervention, fail-closed behavior, active push-back và impact-first khi có correction có thể ảnh hưởng nhiều lớp source of truth (2c3f6c1, 10b3013)
  • mở rộng multi-BA governance: phân quyền Lead BA/module BA cho memory layer, quy tắc conflict escalation, file-back approval và archive policy (2c3f6c1)
  • cập nhật installer và CLI để phân phối memory/parity assets nhất quán cho Claude Code, Codex và Antigravity (145c33b)

Fixed

  • áp các core contract thay đổi bị thiếu ở Phase 01-03 vào AGENTS.md, CLAUDE.md, GEMINI.md, rules và step files để runtime không lệch hành vi (2c3f6c1)
  • sửa 5 issue review liên quan contract/token budget/step behavior trước khi khóa parity behavior (10b3013)
  • enforce deterministic activation parity để tránh runtime tự diễn giải threshold khác nhau (6200784)
  • cập nhật parity fixtures/goldens để bao phủ compact fallback, shard routing, optional log exclusion, activation freeze, explicit fallback và governance conflict (6200784, 145c33b)

2026-04-23: GitBook publishing split và documentation home

Changed

  • tách GitBook content thành các section home, documentation và changelog để documentation có thể được publish độc lập khỏi core BA-kit repo (cf2c555, f74067b, 15ca369)
  • bổ sung workflow guide về collaboration theo module và GitHub cho BA/non-technical users, giúp tài liệu vận hành teamwork dễ tiếp cận hơn (bca9861)
  • chuyển GitBook assets ra repo documentation riêng, sau đó dọn gitbook/ khỏi core repo để giảm nhiễu giữa product runtime và publishing site (8b24f76, bfcbbcc, c7e6899)

2026-04-07 to 2026-04-10: teamwork architecture và wireframe handoff chặt hơn

Added

  • thêm ba-do, ba-impact, và ba-next để hỗ trợ natural-language routing, impact analysis, và xác định bước BA tiếp theo thay vì buộc user gọi đúng subcommand từ đầu (afb82d6, ca4a5a7)
  • thêm helper ba-kit chunk-write để ghi artifact lớn theo từng phần, giảm rủi ro bị cắt output khi agent tạo SRS hoặc tài liệu dài (fe699f1)
  • thêm hỗ trợ Antigravity và hướng dẫn cài đặt tương ứng để BA-kit không còn bị giới hạn ở Claude Code và Codex (3a68d49)

Changed

  • refactor kiến trúc teamwork theo mô hình module với cấu trúc 03_modules, giúp BA Lead khóa core artifact trước rồi BA Member mới triển khai artifact theo module riêng (806f7f4)
  • chuẩn hóa Information Architecture và khóa IA sớm hơn trước khi đi vào wireframe handoff, giảm khả năng lệch điều hướng hoặc layout logic về sau (1796a75, 62d38c5)
  • migrate BA-kit sang Stitch MCP và siết Large Artifact Write Protocol để workflow artifact lớn ổn định hơn ở runtime mới (af43a34)
  • tối ưu contract architecture theo hướng machine-readable và tiết kiệm token hơn để agent đọc, route, và thực thi workflow đáng tin cậy hơn (3d802cc)
  • cập nhật renderer md-to-html để hỗ trợ generic PNG refs và mặc định tắt editor, phù hợp hơn với output review-ready thay vì editable by default (bf4e68c)

Fixed

  • đồng bộ lại manual wireframe handoff flow trong docs vận hành để bám đúng workflow thực tế sau các thay đổi kiến trúc (88303d6)

2026-03-30 to 2026-04-02: workflow hardening và khả năng vận hành thực tế

Added

  • thêm lệnh update BA-kit một bước và cơ chế update notice để người dùng có thể cập nhật toolkit đơn giản hơn (572679c, 3e674d2)
  • thêm doctor để tự kiểm tra tình trạng môi trường cài đặt và runtime (3e674d2)
  • thêm kỹ năng ba-notion để publish artifact từ BA-kit sang Notion (b3aacb3)
  • thêm hướng dẫn DESIGN.md ở cấp project để handoff cho wireframe agents có nguồn định hướng rõ ràng hơn (e45447d)

Changed

  • siết workflow contracts cho Claude và Codex, đặc biệt ở phần delegation context, rerun locking, và preflight cho SRS để giảm lỗi khi workflow chạy nhiều bước hoặc có sub-agent (3892a54, 2a39847, df2eab1, 7c094ea)
  • persist riêng wireframe input và wireframe map thay vì để chúng biến mất trong flow tạm thời, giúp handoff và traceability tốt hơn (9c54c4b)
  • thống nhất HTML packaging và thu hẹp package scope để output cuối nhất quán hơn và ít kéo nhầm nội dung không liên quan (fcc1ae9)
  • tối ưu BA-kit cho mô hình solo IT BA, tức là vẫn giữ đủ artifact nhưng giảm ma sát khi một người phải ôm discovery, analysis, và handoff (cbc2c98)
  • chuẩn hóa artifact outputs và convention của SRS để đầu ra bền hơn giữa các lần rerun (2238c3d)

Fixed

  • cải thiện package HTML rendering để output dễ review hơn (490c2f5)
  • tránh ghi đè BA-kit CLI đang chạy trong installer/update flow (015e51e)
  • harden các lệnh tooling để tránh collision biến shell và lỗi khi gọi updater (3a2d29d, 672ceb9)

2026-03-23 to 2026-03-26: nền tảng toolkit và runtime bundle đầu tiên

Added

  • bootstrap BA-kit như một toolkit riêng cho Business Analysis workflow (0bde4d7)
  • thêm Pencil-backed SRS screen specs và tự động wireframe generation để SRS có thể mang theo screen behavior rõ ràng hơn (f89289a, dfd91cc)
  • đổi mặc định để SRS trở thành deliverable chính khi có UI screens hoặc system interactions, thay vì chỉ dừng ở artifact nhẹ hơn (4107d62)
  • thêm UI-UX designer agent để hỗ trợ phần wireframe/design-oriented handoff (32a06ed)
  • thêm discovery context template và workflow tái sử dụng context cho các vòng discovery sau (1d423e1)
  • thêm bundle và installer cho Codex, giúp BA-kit có thể vận hành như một repo-native workflow trong Codex (4f240be)
  • thêm utility chuyển markdown sang HTML và hoàn thiện template để package cuối có thể xuất được review-ready artifact (da50c92)
  • thêm step-level subcommands cho ba-start, cho phép chạy từng giai đoạn thay vì luôn phải gọi cả lifecycle lớn (707e7a0)

Changed

  • tinh gọn kiến trúc skill bằng cách hợp nhất nhiều BA skills vào orchestrator ba-start, đồng thời gom rules, templates, và agent definitions để workflow nhất quán hơn (a4a40e0, 17a679c, 650846a, 5820a57)
  • refine UI workflow và editable outputs để artifact bàn giao rõ ràng hơn cho người dùng business hoặc design (d17d027)

Fixed

  • dừng suy diễn PNG path từ .pen names để tránh map sai asset khi export wireframe (73c4f13)
  • harden markdown export workflow để quá trình xuất tài liệu ổn định hơn (e15fc92)

Ghi chú phân loại

Các commit sau chủ yếu phục vụ GitBook site, asset publishing hoặc tách documentation khỏi core repo. Chúng được tóm tắt riêng ở mục 2026-04-23, nhưng không được tính là thay đổi core BA-kit runtime behavior:

  • cf2c555, f74067b, bca9861, 15ca369
  • 8b24f76, bfcbbcc, c7e6899

Nguồn