Changelog BA-kit: 2026-03-23 to 2026-05-05

Tóm tắt ngắn

Trong giai đoạn này, BA-kit đi từ một toolkit nền tảng sang một workflow BA có contract, memory, runtime parity và governance rõ ràng hơn cho cả solo BA lẫn teamwork theo module. Các thay đổi nổi bật tập trung vào 5 hướng chính:

  • mở rộng runtime support cho Codex và Antigravity
  • chuẩn hóa chuỗi artifact từ intake đến SRS và wireframe handoff
  • tăng độ an toàn khi chạy workflow dài hoặc artifact lớn
  • bổ sung skill và routing để xử lý change impact, next step, và teamwork tốt hơn
  • thêm project memory, activation contract và runtime parity harness để giảm drift giữa Claude Code, Codex và Antigravity
  • thêm workflow ba-collab để BA non-tech nhận module, gửi review, approve, integrate và tạo GitHub handoff có approval gate
  • đổi chuẩn swimlane sang PlantUML, đồng thời giữ Mermaid cho sequence/DFD/ERD và các flow đơn giản

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