Nemo12 HarnessCách repo vận hành với Claude Code

Kiểm chất lượng vừa đủ, làm thẳng trên main, mỗi web app một làn, file nào nằm ở đâu.

Làm thẳng trên main

Hệ thống test và QC

Một job CI, cổng chạy song song

Mỗi lượt CI là một job, tính tiền một lần. Pre-commit khoảng 4 giây, chỉ chạy cổng khớp file vừa sửa.

Hai tầng cổng

Cổng chặn giữ thứ người dùng cảm thấy được. Cổng báo cáo (sổ sách, hạn ngày) không bao giờ chặn deploy.

Không PR, không branch dài hạn

Commit, pull --rebase, push thẳng lên main. Hook ở máy là cổng cuối, CI gác rồi deploy.

Mỗi web app một làn

Mỗi program một app và một Worker trên learn.nemo12.com. Mỗi phiên Claude làm trong một thư mục riêng.

Docs và artifact cạnh code

PRD, SDD, prototype, danh mục asset nằm trong thư mục của chính app.

File nào nằm ở đâu

Code và asset nhỏ vào git, nội dung vào D1, media nặng vào R2, bản sinh không lưu.

Harness là gì

Harness là toàn bộ "bộ khung" quanh code giúp các phiên Claude Code làm việc an toàn và nhanh: luật trong CLAUDE.md, hook (đoạn code tự chạy trước commit, trước push, trước một lệnh), cổng kiểm (gate), CI trên GitHub Actions, skill và memory. Site này ghi lại các quyết định của chủ dự án về harness, viết cho người đọc, không phải cho máy.

Chi tiết kỹ thuật một nguồn nằm ở docs.nemo12.com và trong repo; mỗi trang ở đây link tới đó thay vì chép lại.

Ba nguyên tắc

Vừa đủ. Mỗi cổng chặn phải nói được cái gì hỏng cho người dùng nếu bỏ qua nó. Còn lại chỉ báo cáo.
Nhanh. Code đã đúng thì lên production trong vài phút, không chờ ngày gộp.
Máy chặn hơn luật chữ. Lỗi đã gặp hai lần thì phải có hook hoặc cổng, không chỉ một dòng ghi nhớ.