Skip to content

v1.5.0 — Workspace Mode: run the whole pipeline from the multi-repo parent folder

Choose a tag to compare

@dinhnguyenngoc dinhnguyenngoc released this 20 Jul 13:54
· 6 commits to main since this release

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 khai Mode: workspace → hành vi kit không đổi một ly. Đã verify bằng
sandbox 2-repo: /discover dừng hỏi xác nhận scope đúng thiết kế, /spec không còn
false-greenfield ở workspace root.

Added

  • CLAUDE.md §Workspace Mode — meta-mode workspace + 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 status repo không-đích sạch).
  • /discover Phase 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ệt Service 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 (arch plan secure build test
    review scan infra docs verify deploy fix-issue hotfix debug simplify
    inspect) — chỉ trỏ về §Workspace Mode; logic sống đúng một chỗ.
  • microservices-multirepo.md Pattern C — Workspace-kit — layout khuyến nghị cho
    cross-repo hằng ngày; A/B giữ nguyên cho kit-in-repo.

Changed

  • /spec Phase 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ị workspace vào bảng Mode (chỉ hợp lệ ở thư mục cha).
  • Mặt tiền: quick-start.md hàng /inspect bổ 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 → Mode nhận giá trị mới workspace — CHỈ hợp lệ ở profile thư mục
    cha (kèm Repos: 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.