Software factory v2 với Claude Code: từ GitHub issue tới PR
Bản v2 của software factory trong Claude Code: Fable làm intake, review theo risk, gate tất định, chạy song song từ GitHub issues tới PR.
✓ Đã duyệt độc lập · cập nhật 14/11/2026 · 32 min
1. Software factory v2: những gì thay đổi
Video được Anthropic tài trợ (theo mô tả video).
Alexander Galea mở đầu: hôm nay anh build một software factory tốt hơn bằng Claude Code. Ở phiên bản trước, anh đã dựng một software factory cơ bản có thể sống ngay bên trong project của bạn. Theo lời anh (video đăng ngày 09/11/2026), mọi người có vẻ thật sự thích nó, thích rất nhiều, và cũng có rất nhiều góp ý hay về cách làm cho factory đó tốt hơn. Trong video này, anh đã làm đúng việc đó.

Theo Alexander (video đăng ngày 09/11/2026), bản mới dùng GitHub issues, tự gửi PR, chạy nhiều job song song từ một orchestrator duy nhất, dùng Fable và Haiku, và có thêm một số bước tất định (deterministic) để factory cho ra code chất lượng cao hơn. Ở phần thực hành, anh sẽ cài factory vào một project của chính anh và cho thấy cách dùng nó. Anh khuyến khích người xem làm theo cùng anh ở phần đó.
Anh nhắc lại phiên bản đầu (v1): một software factory dạng module, sống bên trong project của bạn, được điều khiển bằng các subagent của Claude Code. Anh nói video này có mọi thứ bạn cần (video đăng ngày 09/11/2026).
Những gì mới trong v2, theo lời anh (video đăng ngày 09/11/2026): có một bước intake dùng Fable; routing tốt hơn dùng các agent Haiku, và việc routing này linh động hơn; có nhiều tính tất định hơn được đưa vào, để chạy nhiều test hơn dọc theo pipeline và giúp factory đáng tin cậy hơn. Factory chạy trên GitHub issues: đầu vào là issue, đầu ra là một PR được đẩy lên project GitHub. Và có observability tốt hơn, theo dõi chi phí, thời gian cho mỗi job và những thứ tương tự.
2. Sơ đồ factory: từ GitHub issue tới PR
Để thật sự hiểu những điểm mới đó, Alexander mở sơ đồ luồng của factory. Đầu vào là một GitHub issue, hoặc nhiều issue: factory có thể nhận nhiều issue cùng lúc và xử lý tất cả chúng với nhau (theo video đăng ngày 09/11/2026).
Các issue đi vào bước intake, chạy bằng Fable. Đây là bước mới của phiên bản này: Fable nghĩ xem issue có đáng build hay không, xác định scope của nó trong bối cảnh project, đánh giá risk, và có thể từ chối feature hoặc yêu cầu thêm thông tin từ một người (theo video đăng ngày 09/11/2026).

Tiếp theo là bước viết spec và bước build. Theo Alexander (video đăng ngày 09/11/2026), đây vẫn là hai bước tách biệt, nhưng có lẽ chúng có thể được gộp thành một bước.
Từ đó, code được đẩy qua một gate. Đây là bước tất định mới. Ý tưởng, theo lời anh (video đăng ngày 09/11/2026), là anh thật sự muốn kiểm chứng rằng những gì software factory làm ra là đúng; đây là một bước rẻ có thể chạy trên bản build để đảm bảo mọi thứ ổn. Nếu không ổn, job quay lại builder.
Khi qua được gate, job đến với các reviewer. Có code review, chạy bằng Haiku, hoặc bằng Sonnet nếu thay đổi được coi là risky. Mức risk đó quay về bản đánh giá mà Fable làm ở đầu pipeline. Anh làm vậy vì muốn cho thấy cách dùng agent bên trong software factory để định hướng cho các bước sau, và có thể để tối ưu chi phí của factory (theo video đăng ngày 09/11/2026). Job cũng đi tới các reviewer khác, tất cả chạy song song.
Tuỳ kết quả của các review, job có thể bị đẩy lại cho builder sửa. Khi đã qua code review, job tới bước approver: bước này quyết định thay đổi có thể merge tự động hay cần một người review, để khép vòng software factory và đưa feature vào codebase (theo video đăng ngày 09/11/2026). Trên sơ đồ còn một khu vực chi tiết hơn về cách hệ thống vận hành, nhưng anh để phần đó cho đoạn sau của video.
3. Orchestrator, deterministic spine và các lệnh /factory
Lúc này Alexander muốn tập trung vào cách thật sự dùng hệ thống với Claude Code. Mọi thứ bắt đầu từ một orchestrator: đó là một phiên Claude Code anh sẽ mở lên. Bên trong phiên đó, anh gõ /factory run. Từ đó, theo anh (video đăng ngày 09/11/2026), nó sẽ bắt đầu sinh ra các subagent, tức các background agent trong Claude Code, làm những việc khác nhau trong hệ thống.
Hệ thống còn có một "deterministic spine" (xương sống tất định). Anh giải thích: anh có những script thật như checks.sh, script gate, script route và script job. Đây là các lệnh shell đi kèm factory, và chúng làm những việc tất định để đẩy job đi qua pipeline, qua chính cái factory (theo video đăng ngày 09/11/2026).

/factory run và thành orchestrator cho mọi job; tối đa concurrency job cùng lúc (mặc định 3); mỗi agent là một background subagent; agent trả lời bằng một dòng, chi tiết nằm trong file của nó; trạng thái nằm trong file nên một lần chạy mới sẽ resume sau khi crash. "Guardrails": label factory là ranh giới tin cậy; nội dung issue tới agent dưới dạng dữ liệu được trích dẫn; chỉ push các branch factory/*, không bao giờ deploy; giới hạn số vòng mỗi job, một PR mỗi issue.Phần deterministic spine trên mind map ghi:
factory/checks.sh the repo's checks, exit 0 or not factory/bin/gate runs checks.sh -> GATE: PASS | FAIL factory/bin/route risk + surfaces -> agents, models factory/bin/job only writer of job.json Scripts refuse illegal moves: no review without a passing gate, no merge without APPROVE.
Các lệnh, theo khung "Commands" trên mind map:
/factory run # run (or resume) processing all issues /factory run <n> # run for one issue /factory <anything> # talk to the factory
Alexander giải thích (video đăng ngày 09/11/2026): có /factory run, và /factory run N với N là một số, ví dụ một GitHub issue cụ thể bạn muốn xử lý. Bạn cũng có thể truyền vào bất cứ thứ gì, một chuỗi tuỳ ý, để làm việc trong bối cảnh factory bên trong project. Tất cả những thứ này đi kèm skill mà anh sẽ hướng dẫn cài trong video.
Đi kèm còn có một dashboard để xem mọi thứ di chuyển qua factory. Một điều quan trọng khác: factory có sẵn concurrency, xử lý tối đa ba job cùng lúc. Đây là một mục cấu hình bạn có thể đổi sau khi đã cài factory vào project (theo video đăng ngày 09/11/2026).
4. Cài factory vào project Note Wall
Bắt đầu cài đặt. Alexander có một prompt để copy và paste vào project của chính bạn, nhằm làm theo anh trong phần demo. Anh copy nó rồi chuyển sang terminal (demo trong video đăng ngày 09/11/2026).

checks.sh bằng test, lint, typecheck và build của project; điều chỉnh các reviewer theo stack; tạo các label GitHub và kiểm tra checks.sh pass trên main.Nội dung prompt trên mind map:
Install this software factory in this project from the reference repository: https://github.com/zazencodes/zazencodes-season-3/tree/main/src/software-factory-claude-code-v2
Anh đang ở trong một project tên là Note Wall App: một ứng dụng ghi chú đơn giản, có thể viết vài thứ lên đó, chỉ vậy thôi. App này cũng nằm trên GitHub, và theo anh (video đăng ngày 09/11/2026) điều đó quan trọng vì issues và pull requests là thành phần cốt lõi của software factory.
Anh mở Claude Code và dùng Claude để cài software factory. Anh paste prompt vào: nó nói "cài software factory này vào project này", và đây là reference repository, một link tới source code của video. Khi mở link đó, bạn thấy prompt nằm ngay trong source code. Bạn cũng sẽ thấy thư mục .claude và thư mục factory; cả hai sẽ xuất hiện trong project của bạn sau khi cài xong (theo video đăng ngày 09/11/2026). Rồi anh cho chạy.
5. Những gì được cài vào project
Khi cài xong, Alexander mở Note Wall App trong Vim để xem những gì đã được thêm vào (demo trong video đăng ngày 09/11/2026). Hai thứ chính: thư mục .claude, bên trong có nhiều file agent, tức phần mô tả cách các subagent trong factory làm việc; và skills. Trong skills có một skill mới được cài là factory, với một file SKILL.md mô tả toàn bộ hành vi của factory.
Nhưng đó chưa phải tất cả code bạn vừa nhận. Còn có thư mục factory, nơi chứa mọi phần code mà factory phụ thuộc. Theo anh (video đăng ngày 09/11/2026), thứ đáng chú ý là các file trong bin: chúng chịu trách nhiệm nhận và đẩy mọi thứ đi qua factory dưới dạng job. Có checks.sh, làm các kiểm tra tất định kiểu CI/CD cổ điển khi mọi thứ đi qua factory. Có một file cấu hình để chỉ định hành vi của factory, và một file dashboard để quan sát factory.

factory/checks.sh chạy npm ci rồi lint, typecheck, test và build, và pass trên main; factory/config.json thêm tests/* vào protected paths để job được thêm test mới nhưng không sửa test cũ, các mục khác giữ mặc định (concurrency 3, merge commits); các agent intake, security, UI, UX reviewer và approver được chỉnh theo Note Wall; AGENTS.md có section "Software factory" mới, CLAUDE.md link tới nó; .gitignore bỏ qua /factory/jobs/ và /.worktrees/; eslint.config.js bỏ qua .worktrees.Quay lên phần trả lời, Alexander chỉ ra có nhiều thứ Claude nói đã thay đổi cho Note Wall: cả một loạt điều cho thấy software factory mà anh cung cấp, tức template, đã được điều chỉnh theo project của bạn. Điểm lớn, theo anh (demo trong video đăng ngày 09/11/2026): checks.sh sẽ chạy các test thật của project. Và AGENTS.md có một section mới tên "Software factory", tức factory được ghi rõ cách dùng ngay trong file agents. Section đó trong AGENTS.md của Note Wall ghi:
## Software factory /factory run builds every open GitHub issue labeled factory through intake → spec → build → gate → review → approve, one PR per issue. State is in factory/jobs/ (gitignored); factory/bin/job is its only writer. Checks: factory/checks.sh (same as npm ci + npm run check). Dashboard: `cd factory && python3 -m http.server`, then open http://localhost:8000/dashboard.html. Each job works in its own git worktree, a full checkout of the repo at .worktrees/<job-id> (gitignored). A tool run from the repo root that doesn't read .gitignore sees those copies too; exclude .worktrees/ in its config (ESLint already does). Give each worktree its own WALL_DATA_FILE when running the dev server there.
6. Chạy lần đầu: queue rỗng và label factory
Alexander thoát ra, mở một phiên Claude mới để thật sự demo factory. Anh đang dùng Opus 5.5 với effort thấp (demo trong video đăng ngày 09/11/2026).
Anh thử chạy factory ngay lúc đó bằng /factory run. Claude kiểm tra factory/bin/job queue, tức chạy một script bên trong factory để xem có gì trong queue. Kết quả trả về rỗng, không có gì đang diễn ra (demo trong video đăng ngày 09/11/2026).
Vậy anh sang GitHub để đưa việc vào queue cho factory. Project có sẵn một loạt issue đang mở, nhưng chúng không có đúng label, nên sẽ không được factory nhận cho tới khi anh gắn label một cách tường minh. Theo Alexander (video đăng ngày 09/11/2026), đây là một biện pháp an toàn anh đưa vào factory: nhiều người khác nhau có thể thêm issue vào project của bạn, nhưng bạn muốn tự chọn issue nào được factory xử lý.
Anh bắt đầu với một issue, tên là "Dark mode". Anh vào phần labels và thêm label factory. Nếu bạn không thấy label này, bạn có thể tự tạo nó: theo anh (video đăng ngày 09/11/2026), label này không có sẵn trong project của bạn trừ khi bạn tự tạo. Gắn xong, label hiện lên trên issue.
Anh quay lại factory và chạy lại đúng lệnh cũ. Lần này nó nhận issue và bắt đầu xử lý qua factory: nó tạo một job, và job feature dark mode đang ở bước intake. Dashboard cũng đã được bật (demo trong video đăng ngày 09/11/2026). Trên đó, issue số 1, dark mode, đang ở bước intake, do Fable xử lý. Anh muốn Fable làm bước đầu tiên của factory vì với anh, đó là một bước thật sự quan trọng để hiểu chuyện gì đang diễn ra trong bối cảnh project (theo video đăng ngày 09/11/2026).
7. Intake của Fable và spec
Job chuyển sang spec writer. Alexander click vào thẻ job trên dashboard để xem thêm thông tin. Theo anh (demo trong video đăng ngày 09/11/2026), sẽ có nhiều file khác nhau được tích luỹ dần khi task đi qua factory. Vừa rồi spec đã được tạo, và đó là thứ spec writer viết ra.

intake.md của job Dark mode trên dashboard (demo trong video đăng ngày 09/11/2026): "DECISION: ACCEPT", risk low, rescoped no, kèm phần Summary, Scope và Why. Cột trái liệt kê các file của job: issue.md, intake.md, spec.md.Nhưng trước đó, Fable đã viết bản intake này: Fable quyết định chấp nhận issue, và đánh giá nó là risk thấp. Thay đổi chỉ chạm tới UI như một surface. Bản intake có một đoạn tóm tắt những điều lớn bạn muốn biết, rồi một agent log đầy đủ với thêm thông tin về những gì Fable đã nghĩ về feature này (demo trong video đăng ngày 09/11/2026).
Theo Alexander (video đăng ngày 09/11/2026), điều này thật sự quan trọng trong một factory: hiểu agent đã nghĩ gì khi đẩy việc của bạn đi qua factory. Nó rất quan trọng cho việc debug và phân tích hiệu quả của factory theo thời gian, nên cần giữ lại tất cả thông tin này từ mỗi job.
8. Builder là một subagent bạn có thể vào xem
Lúc này job đã sang giai đoạn builder. Alexander quay lại Claude để xem chuyện gì đang xảy ra. Anh thấy builder là một agent nằm ở phía dưới; đó là một subagent trong Claude Code. Anh có thể bấm Enter để đi vào nó, xem subagent đang nghĩ gì, và có thể lái (steer) nó. Anh gõ thử một câu hỏi kiểu "bạn đang làm gì vậy?" (demo trong video đăng ngày 09/11/2026).
Theo Alexander (video đăng ngày 09/11/2026), mức tương tác này với agent thật ra không phải là mục đích của software factory; anh chỉ muốn cho thấy bạn làm được điều đó với Claude Code. Anh quay lại agent chính.
Agent chính này là orchestrator, và về nguyên tắc nó có thể mở thêm các job khác cùng lúc. Nhưng lúc này anh theo dõi một task duy nhất từ đầu tới cuối (demo trong video đăng ngày 09/11/2026).
9. Gate, review và vòng tự sửa
Bản build vừa xong, và job đã sang giai đoạn review. Điều đó có nghĩa là nó đã qua gate, bước tất định mà job phải đi qua, nơi chạy một số test, linting và những thứ tương tự (demo trong video đăng ngày 09/11/2026). Alexander mở lại sơ đồ trong Obsidian: đây là phần job vừa đi qua, gate đã có dấu tích xanh, và giờ job đang đi qua các reviewer. Quay lại terminal, anh chỉ vào lý do gate chuyển xanh.
Reviewer UX vừa approve, vậy phần đó đã xong. Còn chờ code review và UI review, rồi job sẽ đi tiếp phần còn lại của pipeline. Nhưng code review vừa fail: ô code review chuyển màu cam. Điều đó có nghĩa job bị đẩy về giai đoạn builder, kèm feedback, và sẽ phải đi qua pipeline lần nữa. Theo Alexander (demo trong video đăng ngày 09/11/2026), đây là lúc thấy được khía cạnh tự sửa, đệ quy của pipeline.
Anh click vào code review để xem thêm. Verdict là một "readability gap". Theo anh (demo trong video đăng ngày 09/11/2026), reviewer này về cơ bản đang rất khó tính về một chi tiết và đẩy job lại vì không thích cách một thứ đang hoạt động.
Anh lưu ý: code review đang dùng Haiku, hoặc chỉ dùng Sonnet nếu được xác định là risky. Anh sẽ quay lại điểm này sau, vì hoá ra dùng các model như Haiku ở giai đoạn này của pipeline có thể không phải ý hay. Theo Alexander (video đăng ngày 09/11/2026), các model này không phải lúc nào cũng hiểu code tốt bằng builder, nên có thể tạo ra một động lực thật sự tệ khi code review do một agent kém thông minh hơn builder agent thực hiện.
Quay lại, anh thấy UI review cũng fail. Vậy job bị đẩy lại và sẽ qua một vòng review nữa: sau khi build xong và qua gate, các reviewer phải review lại, dựa trên feedback mà các reviewer đã đưa cho builder. Và đúng vậy, các reviewer đã vào vòng review tiếp theo. Lần này code review chuyển xanh, rồi UI agent cũng pass, và job vào giai đoạn approve (demo trong video đăng ngày 09/11/2026).
Approver sẽ quyết định thay đổi có thể merge tự động hay cần một người review trước khi merge. Theo Alexander (video đăng ngày 09/11/2026), đây là một điều hay mà factory làm được, vì nó cho phép hành vi tự chủ hơn rất nhiều: nếu là một feature đơn giản có thể merge mà không cần người xem, điều đó tiết kiệm thời gian của con người. Thứ đó có giá trị, và đó là việc anh muốn factory làm cho mình.
10. PR được merge tự động, kéo code về máy
Và quả thật job đã xong. Một PR đã được tạo cho thay đổi này và đã được merge, tức nó đã thật sự vào code production (demo trong video đăng ngày 09/11/2026).

vite.config.ts để chạy thêm client/theme.test.ts. Dashboard bên dưới có job Dark mode ở cột Done.Alexander mở GitHub. Issue Dark mode, số 1, có những gì bước intake đã viết vào. Lịch sử ghi: sáu phút trước, một pull request được mở, rồi issue được đánh dấu completed (demo trong video đăng ngày 09/11/2026).
Anh vào PR gắn với issue đó. Ở đây có tất cả commit mà software factory đã tạo, và phía dưới là dòng "Pull request successfully merged and closed". Theo anh (demo trong video đăng ngày 09/11/2026), hệ thống đã quyết định việc này không cần anh chú ý, đây là thứ có thể merge tự động. Nhưng toàn bộ lịch sử của quá trình đều nằm trong GitHub, điều mà anh cho là rất mạnh cho observability. Ở trang code, anh thấy commit merge pull request, được làm một phút trước, và giờ nó đã nằm trong codebase.
Giờ anh kéo các thay đổi từ remote về. Chạy git status, anh thấy một số file thay đổi ở local: đó là các file và thư mục được thêm hoặc sửa khi cài software factory, mà anh chưa từng add và commit. Anh commit chúng với message "Add zazencodes software factory" (demo trong video đăng ngày 09/11/2026).
Anh lưu ý mình đang ở branch main, làm việc trên main. Anh chạy git pull để kéo thay đổi từ main về. Anh tưởng sẽ phải dọn vài chỗ merge, nhưng git đã auto-merge nên mọi thứ ổn; có một vài conflict với file agents nhưng đã được xử lý. Các thay đổi kéo về gồm nhiều sửa đổi ở style và theme, cho feature dark mode (demo trong video đăng ngày 09/11/2026).
Anh chạy npm run dev và mở lại app: giờ app có dark mode, bật mặc định, giao diện đã tối (demo trong video đăng ngày 09/11/2026).
11. Đưa bốn issue vào factory cùng lúc
Sau khi đã cho thấy cách đưa một issue đi qua toàn bộ factory, Alexander muốn làm điều đó cho nhiều issue cùng lúc. Có bốn issue đang mở; anh chọn tất cả và gắn label factory cho cả bốn một lượt. Rồi anh quay lại Claude để xử lý tất cả cùng lúc (demo trong video đăng ngày 09/11/2026).
Nếu chạy /factory run, factory sẽ xử lý mọi thứ cùng nhau. Nhưng anh cũng có thể gõ /factory run kèm một con số để xử lý riêng issue đó, và anh muốn demo điều này trước. Issue số 4 tên là "Different fonts". Anh gõ số 4. Claude xem queue, đọc tất cả issue từ GitHub, tìm đúng issue và báo đang intake issue số 4, Different fonts. Trên dashboard, Different fonts đang ở bước intake, Fable đang xem xét nó (demo trong video đăng ngày 09/11/2026).
Giờ tới các issue còn lại. Vì phiên này là orchestrator, anh có thể tiếp tục dùng nó: dùng orchestrator để tương tác với các job đang có trong factory, hoặc để tạo job mới. Anh gõ /factory run để xử lý mọi thứ còn lại: nó kéo tất cả issue và đẩy chúng qua factory, và các job lần lượt xuất hiện ở bước intake (demo trong video đăng ngày 09/11/2026).
Anh chỉ ra chỉ có ba job đang chạy, vì concurrency của factory được đặt là ba. Anh hỏi Claude concurrency đang được đặt bao nhiêu; câu trả lời trên màn hình: concurrency là 3, nằm ở factory/config.json, cả ba slot đang được dùng (different fonts, colored sticky notes, change display name), và issue số 5 được giữ lại cho tới khi một job xong (demo trong video đăng ngày 09/11/2026).
Một điểm mới khác: factory đo thời gian các job. Job dark mode có thời gian tám phút, là thời gian để nó đi hết factory. Factory cũng ghi chi phí: Alexander đọc con số 3,40 đô cho job này, còn bản tóm tắt của orchestrator ghi $3.41 theo giá API tương đương. Anh nói nó không thật sự tốn của anh 3,40 đô để chạy qua factory: với anh nó miễn phí, anh chỉ dùng gói Claude của mình (theo video đăng ngày 09/11/2026). Tuy vậy, con số này cho một ý niệm về mức đắt của các job khi so sánh chúng với nhau, và có thể dùng để tối ưu factory: làm nó hiệu quả hơn bằng cách nhìn vào chi phí job và tìm cách đẩy nó xuống. Vì thế anh coi đây là một bổ sung quan trọng cho factory.
12. Needs human, feedback và review theo mức risk
Có một job đang ở trạng thái "needs human", tức thực chất đang tạm dừng. Và vì vậy, factory đã tự động bắt đầu intake cho issue cuối cùng, tên là "Multiple walls" (demo trong video đăng ngày 09/11/2026).
Alexander tập trung vào job cần người review. Có hai cách làm việc này. Cách thứ nhất là click vào job trên dashboard và xem các file đang được ghi bền vững (durably) vào factory: anh thấy bước build bị chặn, và có một file decision.md giải thích vì sao builder bị chặn. Nhưng anh nói đây không phải cách anh làm việc với factory. Anh sẽ nói chuyện với Claude ở phía trên: phiên đó là orchestrator, nó quản lý mọi thứ, nhưng khung chat của nó khá rảnh để anh trao đổi. Hoặc anh có thể mở một phiên Claude Code mới trong cùng project, và miễn là dùng skill factory, anh có thể hỏi bất cứ điều gì (theo video đăng ngày 09/11/2026).

tests/store.test.ts, mà các file trong tests/ được bảo vệ khỏi builder. Bên dưới, decision.md trên dashboard đưa ra hai lựa chọn cho người: (a) cho job sửa file test đó, hoặc (b) đổi spec để font là tuỳ chọn, có giá trị mặc định.Anh hỏi chuyện gì đã xảy ra với task different fonts, vì nó cần anh quyết định. Câu trả lời: intake đã chấp nhận issue với scope hẹp hơn; nó không thật sự biết phải làm gì với font, mặc định là kiểu chữ viết tay (handwriting), và nó cần ý kiến của anh. Anh nói vì đây là video và anh không thật sự bận tâm, anh trả lời: "yeah, cứ làm gì bạn muốn, cho nó chạy tiếp đi" (demo trong video đăng ngày 09/11/2026).
Như vậy anh đã đưa ra quyết định, và factory sẽ nhận lại job. Trên dashboard xuất hiện file feedback1.md; click vào, nó ghi đúng câu anh vừa trả lời. Rồi job đi tiếp: nó quay về giai đoạn building. Trong lúc đó, job colored sticky notes đang chờ UI review rồi sẽ được build xong (demo trong video đăng ngày 09/11/2026).
Job multiple walls được gắn mức high, tức một feature có risk cao. Đây là label do Fable đặt cho các feature; những nhãn nhỏ này là thứ anh thêm từ bước intake ban đầu. Theo Alexander (video đăng ngày 09/11/2026), anh để Fable quyết định, và dựa trên thông tin đó, factory điều chỉnh hành vi khi đẩy job đi tiếp.
Anh chỉ ví dụ: job change display name có code, UX và UI review, nhưng không có security reviewer, còn job kia (colored sticky notes) thì có. Lý do là job đó có mức độ medium nên được giao thêm bước security review, còn change display name ở mức low nên không có (demo trong video đăng ngày 09/11/2026). Anh nói đây là hành vi anh thêm vào để minh hoạ cách làm cho software factory linh động, về thực chất là một directed acyclic graph động, và điều này có thể giúp factory hiệu quả hơn. Anh sẽ nói thêm về hiệu quả ở phần suy nghĩ cuối.
13. Tắt orchestrator rồi chạy lại: factory bền tới đâu
Alexander dọn lại màn hình. Anh có hai phiên Claude đang chạy. Phiên bên phải anh chỉ dùng để tương tác với factory, nên tắt nó đi cũng được: bỏ hẳn nó đi thì không có gì trong factory thay đổi (theo video đăng ngày 09/11/2026).
Nhưng phiên orchestrator thì khác: nó có cả loạt subagent gắn với nó, và một shell, chính là thứ đang serve dashboard. Anh nói không có lý do gì Claude phải làm việc đó, anh có thể tự serve bằng tay. Anh thử tắt phiên này bằng Ctrl+C, và toàn bộ background agent dừng lại: tất cả bị dừng hẳn. Theo anh, điều đó không tốt (demo trong video đăng ngày 09/11/2026).

Vậy anh gõ /factory run. Lệnh này xem trạng thái hiện tại: nó xem queue, quay lại GitHub kiểm tra chuyện gì đang diễn ra, rồi khởi động lại tất cả các agent. Theo Alexander (demo trong video đăng ngày 09/11/2026), theo nghĩa đó factory khá bền (durable).
Anh chắc chắn mình vừa mất một chút công việc: những gì các subagent cũ đang làm dở thì giờ đã có subagent mới thay, và chúng bắt đầu lại từ đầu. Mọi công việc đang chạy dở bị xoá sạch, và được chạy lại. Cụ thể, bước UI review đang chạy lúc đó bị phá và phải chạy lại. Anh nói làm vậy không phải ý hay, nhưng factory khá bền: anh đã dừng nó và khởi động lại được, và mọi thứ lại tiếp tục được đẩy qua (demo trong video đăng ngày 09/11/2026).
Giờ mọi thứ đã dồn lại trên dashboard: một số job cần review, và hai job đã xong. Trên GitHub, anh thấy ba pull request đang mở cho các job đó và hai PR đã đóng. Trong source code cũng thấy thay đổi đã được kéo vào: commit "Merge pull request #7", change display name (demo trong video đăng ngày 09/11/2026).
14. Hỏi factory về từng job, và skill TLDR
Alexander nói anh rất thích ý tưởng có thể quay lại factory với một phiên hoàn toàn sạch trong project, chỉ cần chạy lệnh factory là có lại toàn bộ bối cảnh từ bên trong nó (theo video đăng ngày 09/11/2026). Anh hỏi chuyện gì đang xảy ra với job different fonts, vì job này cần anh quyết định. Câu trả lời: job fonts bị kẹt vì một quy tắc của factory, không phải vì bản thân feature, và nó cần anh quyết định.
Anh giải thích: different fonts bị chặn vì một vấn đề trong chính software factory của anh. Anh đã sửa factory: anh bảo nó "này, tự sửa mình đi, job này lẽ ra không bao giờ bị chặn, lẽ ra phải build tiếp được". Anh nói thẳng với người xem: khi viết yêu cầu đó, anh còn dặn thêm cập nhật cả factory V2 trong repo zazencodes season 3, nên factory bạn cài sẽ có bản sửa này (theo video đăng ngày 09/11/2026). Job được nhận lại và giờ đang quay về giai đoạn builder.
Tiếp theo là các job khác. Vì đã nạp factory, anh hỏi thẳng: còn issue số 5 thì sao? Có chút nhiễu vì job khác đang chạy, nhưng đây là câu trả lời, và có khá nhiều thứ trong đó. Anh có một skill, skill riêng của anh, tên là TLDR: nó chỉ làm ngắn output của agent (theo video đăng ngày 09/11/2026). Anh trả lời orchestrator rằng anh tin nó sẽ xử lý job này đúng cách, cứ làm đi.
Tiếp, anh hỏi về job colored sticky notes. Câu trả lời cho biết test mới cho màu không chạy, và hỏi có gửi job lại để sửa không. Anh đồng ý (demo trong video đăng ngày 09/11/2026).
Các job đang hiện là cần người review, nhưng anh đã đẩy chúng đi tiếp rồi. Refresh dashboard, anh thấy một job đã đổi trạng thái và đang được build. Multiple walls thì vẫn nằm đó. Anh hỏi nên làm gì với multiple walls, issue số 5. Câu trả lời: job số 5 được cố ý để chờ, chờ các task khác xong. Theo Alexander (demo trong video đăng ngày 09/11/2026), orchestrator có một kiểu hiểu biết chung về những gì đang diễn ra trong hệ thống: nó chờ job này cho tới khi các job kia xong, rồi mới merge PR này vào. Anh thấy điều đó hợp lý.
Anh chỉ ra các bản TLDR liên tục xuất hiện là từ skill của anh, và anh có thể bảo nó dừng: anh gõ yêu cầu ngừng xuất TLDR (demo trong video đăng ngày 09/11/2026).
Giờ mọi thứ đã xong, trừ job multiple walls cuối cùng. Anh hỏi lại và dùng TLDR cho job đó. Câu trả lời: job bị đứng (stalled), chờ anh đồng ý với thay đổi định dạng của wall, còn một vòng nữa là merge. Anh trả lời: được, cứ làm gì bạn muốn và merge nó vào. Câu trả lời còn có link, anh có thể click để mở thẳng PR (demo trong video đăng ngày 09/11/2026).

data/wall.json rồi gọi factory/bin/job feedback 5, tạo feedback-1.md cho job 005-multiple-walls, vòng 3. Bên dưới, PR #10 "Multiple walls with shareable links" có mục "For the human" nhờ quyết định có chấp nhận thay đổi định dạng dữ liệu lưu trữ hay không (demo trong video đăng ngày 09/11/2026).Anh đoán agent đang lo việc vứt bỏ một ít dữ liệu. Đây chỉ là một app thử, anh không bận tâm, nên anh trả lời cứ xoá dữ liệu đi ngay, đó chỉ là dữ liệu test, không quan trọng. Anh rất thích chi tiết này: agent thật sự ghi lại những phản hồi đó. Có factory/bin/job feedback, một hàm trong factory chuyên ghi feedback từ người dùng một cách tường minh, và có rất nhiều hàm như vậy; anh sẽ cho xem ngay sau đây (demo trong video đăng ngày 09/11/2026).
15. App sau cùng và checks.sh
Trước hết, Alexander cho xem phiên bản cuối của app sau khi kéo hết thay đổi về. Giờ có thể đổi màu sticky note: anh chọn màu đỏ cho một note. Và anh cũng đổi được tên của mình (demo trong video đăng ngày 09/11/2026).
Rồi anh quay lại mind map để đi qua các phần chi tiết. Các kiểm tra tất định do checks.sh đảm nhận. Đây là thứ kiểm tra và fail một cách tất định nếu project không đáp ứng những điều cần có, ví dụ nếu không pass test. Theo anh, nó rất đơn giản: chỉ là một file bash (theo video đăng ngày 09/11/2026).

factory/checks.sh của Note Wall mở trong Neovim (video đăng ngày 09/11/2026).Nội dung file trên màn hình:
#!/usr/bin/env bash # The repo's checks. Exit 0 only when the branch is fit to review. # # The gate runs this script from the main checkout with the job's worktree as # the working directory. Keep it fast, deterministic and non-interactive: no # watch modes, no prompts, nothing that rewrites files. set -euo pipefail npm ci --prefer-offline --no-audit --no-fund npm run lint npm run typecheck npm test npm run build
File này chạy qua tất cả các lệnh npm vì đây là một project npm. Nếu bạn có loại project khác, bạn sẽ chạy những test khác ở đây. Ở Note Wall, nó chạy linting, type check, npm test, rồi chạy build: thật sự build project để chắc mọi thứ hoạt động. Theo Alexander (video đăng ngày 09/11/2026), nếu có gì sai ở đây, job thậm chí không tới được các reviewer, vì gate được đặt ngay trước chúng.
16. job.json: trạng thái tất định của mỗi job
Phần tiếp theo trên mind map: job.json điều khiển mọi stage. Đây là một file nằm trên máy của bạn, đại diện cho job khi nó đi qua factory. Và file này chỉ được ghi, chỉ được cập nhật, bởi factory/bin/job. Theo Alexander (video đăng ngày 09/11/2026), đây không phải thứ "vibe" do Claude Code tự cập nhật: Claude Code gọi factory/bin/job để cập nhật file JSON này.

job.json điều khiển các stage intake → spec → build → gate → review → approve → merging → merged. Intake NEEDS-INFO hoặc REJECT dẫn tới needs-info hoặc rejected; gate FAIL và review CHANGES quay về build; approve ESCALATE dẫn tới needs-human. Một file mỗi job (stage, round, intake, agents, gate, reviews, PR, cost); chỉ factory/bin/job ghi nó; nó từ chối các bước không hợp lệ (không review khi gate chưa pass, không merge khi chưa APPROVE); agent trả lời một dòng và orchestrator gọi bin/job để đẩy job đi; một lần /factory run mới resume mọi job từ file của nó.Anh mở file job để cho thấy điều đó rõ ràng: anh đọc dòng ở đầu file, nói rằng nó là thứ duy nhất ghi vào job.json của mỗi job. Có các lệnh như job queue, xem queue có gì. Đi theo queue vào code, anh nói có thể hơi rối, nhưng sẽ thấy nó nhìn vào GitHub để xem chuyện gì đang diễn ra ở đó. Rồi có job create, job advance, job merge: đây là những thứ chịu trách nhiệm đẩy mọi thứ qua pipeline (demo trong video đăng ngày 09/11/2026). Phần Usage trong file trên màn hình:
Usage: job queue what /factory run should do with each labeled issue job create <issue> new job for an open `factory` issue; prints the job id job advance <job> <stage> move a job to <stage>, or refuse job merge <job> APPROVE → sync with the base branch, gate, merge the PR job feedback <job> needs-human → build, with your feedback (stdin) as feedback-<k>.md job reject <job> needs-info or needs-human → rejected, with your reason (stdin) as rejection.md job agents <job> <json> record the routed agent set (called by factory/bin/route) job sync <job> refresh reviews, gate and cost from the job's files job summary [<job>...] table of jobs: issue, stage, PR, cost, time <job> is a job id (004-dark-mode) or an issue number (12).
Rồi anh cho xem các job thật. Chúng không hiện trong cây thư mục của editor vì đang bị git ignore. Vào thư mục factory trong terminal, có thư mục jobs: đây là nơi chứa dữ liệu thật của những thứ trong factory. Theo Alexander (video đăng ngày 09/11/2026), bạn nên biết dữ liệu này chỉ nằm trên máy của bạn: nó bị git ignore, không được backup lên GitHub. Nếu muốn lưu giữ nó, bạn có thể tự build thêm một phần để lưu riêng. Anh nói đó là điều anh sẽ làm: build thêm một thứ lưu dữ liệu này lên Google Cloud Storage, và anh sẽ chỉ cần bảo Claude "mình muốn lưu mấy thứ này lên Cloud Storage, dựng một workflow để làm việc đó", và Claude sẽ lo cho bạn.
Đây là dữ liệu cứ hiện ra trong factory suốt video, gồm cả round one, round two, round three. Khi anh nhìn vào bên trong, chính các file markdown nằm trên máy anh là thứ cung cấp nội dung cho các file hiện trên dashboard. Và có job.json (demo trong video đăng ngày 09/11/2026).
File job.json là file được các script trong bin chỉnh sửa. Khi mind map ghi rằng chỉ factory/bin/job ghi nó, theo Alexander (video đăng ngày 09/11/2026), đó là thứ làm cho software factory bền và đưa job đi đúng qua vòng đời của factory. Điểm lớn là file này được xử lý theo lập trình: Claude không tự sửa nó, Claude chạy các hàm để cập nhật nó. Anh hy vọng điều đó đã rõ, vì nó thật sự quan trọng với cách factory hoạt động.
17. Suy nghĩ cuối: độ phức tạp, chi phí, production và cloud
Alexander nói anh đã đi qua gần hết mọi thứ, rồi chia sẻ vài suy nghĩ cuối về những gì vừa build và hướng anh muốn đi tiếp. Trước hết, theo anh (video đăng ngày 09/11/2026), đây chắc chắn là một bước cải tiến so với software factory trước của anh: có nhiều thứ anh đã nghĩ kỹ hơn, và anh thích cách phiên bản này hoạt động hơn bản trước. Tuy nhiên, nó cũng phức tạp hơn, và độ phức tạp không phải lúc nào cũng đi kèm cải tiến. Vì thế anh khuyến khích bạn nhìn vào factory này và tự hỏi làm sao đơn giản hoá nó một chút cho mình mà vẫn có được hiệu năng mong muốn.
Điều tiếp theo là chi phí. Factory đang theo dõi chi phí, hay đúng hơn là chi phí ước tính nếu trả theo giá token. Anh nhắc lại là anh không trả theo giá token, nên cần nhớ điều đó; nhưng nó vẫn là một mốc so sánh tốt để tối ưu chi phí theo thời gian và so chi phí giữa các job (theo video đăng ngày 09/11/2026). Có thể bạn muốn thử dùng các model rẻ hơn như Haiku ở một số chỗ trong pipeline, ví dụ ở các giai đoạn review. Tuy nhiên, theo Alexander (video đăng ngày 09/11/2026), nếu làm vậy mà các reviewer fail vì dùng Haiku và không thật sự suy nghĩ thông minh về vấn đề, rồi chúng đẩy việc lại cho builder, điều đó thật ra có thể làm tốn nhiều tiền hơn. Đó là điều anh sẽ cẩn thận. Có thể approver là một agent Haiku, nhưng rồi lại phải hỏi: mình có muốn giao quyết định đưa feature vào codebase cho Haiku không? Anh nói anh không biết mình có muốn vậy không.
Anh rất thích việc factory dùng GitHub issues và pull requests. Một điều hay có thể làm, theo anh (video đăng ngày 09/11/2026): theo dõi các chỉ số hiệu năng của hệ thống production thật, rồi tự động đẩy chúng thành GitHub issues, để factory nhận vào. Nếu muốn thêm một lớp giám sát sau khi triển khai, sau khi deploy lên production, bạn có thể làm điều đó qua chính factory này, qua hình thức GitHub issues. Bạn có thể cho bất kỳ hệ thống nào khác đẩy GitHub issues vào project, gắn label factory, rồi issue được nhận và đẩy qua hệ thống. Như vậy, theo anh, không cần thêm lớp nào để gắn các thứ như observability: GitHub issues về cơ bản đã lo việc đó.
Điều cuối anh muốn nói là dùng factory trong production. Theo Alexander (video đăng ngày 09/11/2026), đây là lời phàn nàn lớn về software factory: "ừ, hay đấy, nhưng phải điên lắm mới cắm cái này vào hệ thống production thật". Và anh đồng ý. Đây là một video 30 phút về cách software factory hoạt động và cách tự build một cái. Anh không bảo bạn lấy code anh cho xem hôm nay, cắm vào hệ thống production, nhắm mắt lại và để agent cày qua mọi issue, build app của bạn theo cách đó.
Anh nghĩ đó là thứ bạn có thể làm theo cách anh đã cho xem: kiểm soát nó, quan sát nó, kiểm tra xem nó chạy ra sao. Đó là thứ bạn có thể bắt đầu. Và theo Alexander (video đăng ngày 09/11/2026), anh nghĩ phát triển phần mềm nói chung sẽ đi tới một tầng trừu tượng trông như thế này: ít xoay quanh các coding agent harness như hiện nay, như cách Claude Code đang hoạt động, mà ở một tầng cao hơn, kiểu một "Super Claude Code", nơi bạn quản lý ở trên tầng agent harness, giống như những gì thấy trong video này. Vì vậy anh nghĩ khái niệm software factory rất quan trọng để hiểu. Anh nghĩ những gì anh cho xem hôm nay có thể là nền tảng cho một thứ chạy được trong hệ thống production, và bạn cần suy nghĩ rất kỹ về việc điều đó nên diễn ra thế nào với chính bạn.
Về bước tiếp theo cho software factory của anh: điều lớn anh đang nghĩ là làm sao cho nó chạy trên cloud. Anh không muốn chạy nó trên máy mình nữa, anh muốn nó tự động chạy ở đâu đó. Theo Alexander (video đăng ngày 09/11/2026), anh nghĩ Agent SDK của Claude sẽ là hướng đi cho việc này, và đó là điều anh đang cân nhắc.
Anh cảm ơn mọi người đã xem.
Nguồn và liên kết 5 nguồn
- Tên gốc: Build a Better Software Factory with Claude Code
- Sự kiện: YouTube
- Video gốc: https://www.youtube.com/watch?v=RiaTyJ2POVo youtube.com
- Kênh YouTube ZazenCodes (Alexander Galea): youtube.com/channel/UC4wbCxRPSrkbp5BNsNczbIQ youtube.com
- Source code của factory trong video, thư mục software-factory-claude-code-v2 (README có prompt cài đặt, sơ đồ vòng lặp và các lệnh; đọc ngày 14/11/2026): github.com/zazencodes/zazencodes-season-3 github.com


