Một checklist phải tick thật trước khi đi tiếp. Cổng chặn, không phải khuyên. Greenfield có 6 cổng, brownfield có 3.

nguồn buildflow/flow.sh

Bản ghi sha256 của đúng những byte bạn đã đọc. Không có nó thì cổng không mở. Ký xong mà sửa file thì chữ ký hết hiệu lực và cổng đóng lại.

sign <stage> OPERATOR ONLY (needs a TTY) … A gate does not pass without one.

nguồn buildflow/.claude/skills/flow/runner/flow.sh:7

Không phải “test xanh”. Là một URL bấm được, output của một lệnh curl, một dòng thật trong database. Nêu trước khi xây.

nguồn buildflow/_templates

Hook lỗi thì cho qua, không chặn. Một cái cổng kẹt cứng còn tệ hơn không có cổng.

nguồn buildflow/.claude/hooks/

Bỏ ý tưởng ở cổng scope là một lối ra hợp lệ, không phải thất bại. Bạn vừa tiết kiệm chính thời gian của mình.

No advance. Fix flow/…md first. (Killing the idea here is also a valid exit.)

nguồn buildflow/.claude/skills/flow/runner/flow.sh

Bắt đầu từ một lời hứa. Sáu cổng: 00-idea → 01-research → 02-scope → 03-prd → 04-adr → 05-contract.

nguồn buildflow/README.md

Bắt đầu từ bằng chứng. Ba cổng: 00-xray → 01-scope → 02-contract-delta. Card đầu tiên là characterization, không phải tính năng mới.

nguồn buildflow/BROWNFIELD.md

teach: bạn tự viết mọi artifact, AI chỉ gác cổng. work: AI soạn, bạn duyệt. Đổi ai cầm bút, không đổi ai ký.

nguồn buildflow/flow.sh

flow/05-contract.md — viết trước khi có dòng code nào. Backend xây theo nó, UI tiêu thụ từ nó. Không bên nào được ứng biến.

nguồn buildflow/_templates

Đóng băng danh sách lỗi trước khi sửa, rồi so lại sau. Báo cáo in [STILL OPEN] và [NEW] — cột thứ hai là cột đáng lo.

nguồn buildflow/flow.sh

Brief của một phiên làm việc. Một phiên, một card. /flow check là cổng ra.

nguồn buildflow/cards/

Mỗi card khai báo đúng một ô trên dòng Layer:. Diff chạm sang ô khác thì bị chặn. Card chạm hai ô = hai trách nhiệm = hai card.

nguồn buildflow/layers.conf

Danh sách file một card được phép chạm. Diff bước ra ngoài → /review-pass tự động ESCALATE.

nguồn autocode-kit/.claude/skills/review-pass/SKILL.md

Thư mục git riêng cho mỗi card, để nhiều executor chạy song song mà không giẫm chân nhau.

nguồn autocode-kit/.claude/skills/task-dispatch/SKILL.md

Card đầu tiên của brownfield. Ghim lại những gì không được phép vỡ — trước khi thêm bất cứ thứ gì mới.

nguồn buildflow/BROWNFIELD.md

Phần bọc quanh model: cổng, script, vòng review. autocode-kit có một harness là check_invariants.py.

nguồn autocode-kit/.harness/

Luật của dự án bạn, viết thành file. Vi phạm thì script exit 1. Kit ship rỗng — luật là của bạn, không phải của kit.

forbidden_pattern · forbidden_import · human_checkpoint · forbidden_path · required_path · required_unique_path

nguồn autocode-kit/.harness/check_invariants.py

Planner chia việc và chấm bài. Executor xây trong worktree riêng rồi báo về bằng PR.

nguồn autocode-kit/USAGE.md

Ở chế độ go/block, planner tự review rồi tự merge chính việc của executor mình — không có cổng người thứ hai.

in go/block mode the planner reviews and merges its own executors' work — there is no second human gate on the merge.

nguồn autocode-kit/USAGE.md

/mindful go chạy tối đa 10 vòng mỗi lần gọi, in [go N/10]. Phanh này để một lỗi state-machine không dispatch mãi không thôi.

nguồn autocode-kit/.claude/skills/mindful/SKILL.md

Skill là lời khuyên — model có thể nói vòng qua nó. Hook là luật: exit 2 và lệnh ghi file không bao giờ xảy ra.

skill là lời khuyên, hook là luật.

nguồn session-3/kits/README.md