v1.5.0 — Workspace Mode: run the whole pipeline from the multi-repo parent folder
Bản này thêm Workspace Mode — MỘT bộ kit đặt ở thư mục cha của sản phẩm nhiều repo
(myproject/.claude) dùng chung cho mọi repo con: phiên làm việc mở ở workspace, mọi
lệnh tự xác định repo đích rồi ghi output vào đúng repo đó; repo con chỉ giữ CONFIG
(PROJECT_PROFILE.md), không cần copy kit vào từng repo. Backward-compatible tuyệt
đối: không khaiMode: workspace→ hành vi kit không đổi một ly. Đã verify bằng
sandbox 2-repo:/discoverdừng hỏi xác nhận scope đúng thiết kế,/speckhông còn
false-greenfield ở workspace root.
Added
CLAUDE.md§Workspace Mode — meta-modeworkspace+Repos:registry cho profile
thư mục cha; scope-resolution 4 bước (xác định repo đích — không chắc thì HỎI → đọc
per-repo profile → mọi path/git theo repo đích → cross-repo: chốt contract trước,
provider → consumer); workspace disk-check gắn mọi gate (artifact không rơi ở workspace
root,git statusrepo không-đích sạch)./discoverPhase 0 — Workspace scope check — detect-once-then-declare: ≥2 git repo
con + root không có business code → liệt kê, hỏi xác nhận + duyệtService id→ ghi
registry → lặp Phase 1–4 per repo, output vào từng repo.- Khối Workspace Mode chuẩn trên 16 lệnh (
archplansecurebuildtest
reviewscaninfradocsverifydeployfix-issuehotfixdebugsimplify
inspect) — chỉ trỏ về §Workspace Mode; logic sống đúng một chỗ. microservices-multirepo.mdPattern C — Workspace-kit — layout khuyến nghị cho
cross-repo hằng ngày; A/B giữ nguyên cho kit-in-repo.
Changed
/specPhase 0 Mode Auto-Detection — thêm workspace precondition: resolve repo đích
trước, 3 tín hiệu (ARGS/CODE/DISCOVERY) dò BÊN TRONG repo đích — chặn false-greenfield
khi CODE probe chạy ở workspace root (nơi không có build manifest)./discover-system— danh sách service đọc từRepos:registry (canonical); dò thư
mục hạ xuống làm cross-check → cờ⚠️ unregistered repo/ dangling registry row.microservices-multirepo.md— chính-xác-hoá nguyên tắc: "Do NOT lump N repos into
a single /discover run" → "không gộp N repo vào MỘT Profile" (workspace mode vẫn
per-repo: mỗi repo một profile, một discovery riêng).PROJECT_PROFILE.md(template) — thêm tình huống dùng thứ 3 (sản phẩm nhiều repo)- giá trị
workspacevào bảng Mode (chỉ hợp lệ ở thư mục cha).
- giá trị
- Mặt tiền:
quick-start.mdhàng/inspectbổ sung ví dụ tra version tính năng
("export CSV được thêm ở version nào, gồm những scenario gì?") + chỉ nguồn đọc
(SPEC.md§Revision History ·CHANGELOG.md/RELEASE_NOTES).
⚠️ Upgrade notes (behavior changes)
- Không khai
Mode: workspace→ không có gì thay đổi — repo đơn / hai mode
greenfield·brownfield giữ nguyên 100% hành vi. /discoverở một thư mục cha chứa ≥2 git repo con (không có business code riêng)
giờ DỪNG HỎI xác nhận workspace thay vì khảo sát thẳng thư mục đó — flow tự động cũ
dựa vào hành vi cũ sẽ dừng sớm hơn (đúng thiết kế: never guess silently).Project Profile → Modenhận giá trị mớiworkspace— CHỈ hợp lệ ở profile thư mục
cha (kèmRepos:registry); tooling parse Profile cần biết enum mới.- Sản phẩm multi-repo theo Pattern C: không copy kit vào repo con nữa — repo con chỉ
còn.claude/PROJECT_PROFILE.md; phiên làm việc mở ở workspace root và duyệt hooks
(/hooks) một lần tại đó.
Changelog đầy đủ (kèm v1.4.0 trở về trước): CHANGELOG.md.