Thiết kế tổng thể · đã chốt · cập nhật 21/11/2026 · M1–M7 code xong, chờ kiểm thật

Phoenix 2: việc nào cũng có đường vào

Phoenix hiện chạy tốt khi dự án đi từ P0 đến P7. Việc nhỏ phát sinh giữa chừng, dự án có sẵn cần polish, và kiến thức muốn dùng lại cho dự án sau đều phải chen vào cùng một chuỗi phase. Agent con cũng chưa có model riêng theo việc. Phoenix 2 chạy mọi phiên qua phoenix code, chia việc thành 3 luồng đi chung 8 bước, nhận được repo có sẵn, gom kiến thức về một kho chung, cho cả đội xem tiến độ trên Monitor Server, và đọc tài liệu từ 25Brain.

Hôm nay: một chuỗi duy nhất 3 việc nhỏ phát sinh lúc đang P6 hotfix · chỉnh UI · bug QA báo kẹt cần phase, cổng, đủ hồ sơ Task đi theo thứ tự P0 → P7. Autopilot dừng sau Polish (autopilot.mjs:114). Task không có phase thì không tạo được (tasks.mjs:79).
Hiện trạng

8 điểm nghẽn, có dòng code làm chứng

Đã giữ nguyên các phần đang chạy tốt: chia task, monitor, autopilot, cổng có bằng chứng, test case, recipe và Telegram.

01 · việc nhỏ

Task nào cũng phải có phase

Thêm task vào phase đã xong thì phase đó bị kiểm lại và cổng phải duyệt lại.

tasks.mjs:79-80 · autopilot.mjs:237
02 · việc nhỏ

Autopilot dừng là không giao gì nữa

Việc sau Polish phải chạy tay bằng phoenix.mjs run.

autopilot.mjs:114
03 · việc nhỏ

Sửa 1 dòng, hồ sơ đầy đủ

Phải có Output kèm code block, Knock-on, outputs, structure check, và ASM nếu đang ở P6.

tasks.mjs:196-213, 243-248
04 · việc nhỏ

Chế độ trực tiếp không để lại gì

Không ghi task, decision hay recipe. Những lỗi hay lặp lại nhất cũng không có bản ghi.

brief.mjs:33-37 · pomode.mjs
05 · dự án có sẵn

adopt chỉ nhận Creator 3.x

Repo Axmol, Next.js hay Go có sẵn không nhận vào được.

adopt.mjs:85-87 · new-project.mjs:99
06 · dự án có sẵn

Phải dựng lại cả chuỗi mới sửa được

Phải tạo task RE, GDD và replay trước. Dự án chỉ cần polish vẫn phải qua P1 đến P5.

adopt.mjs:293-306, 386
07 · kiến thức

Kiến thức nằm riêng từng máy

Đường dẫn skill là đường dẫn tuyệt đối. 55/111 recipe còn ở dạng .proposed.md. Chỉ 12 recipe có nhãn.

server.mjs:228-232 · references/recipes
08 · model

Model khai 2 nơi, agent con không chọn được

Model khai ở cả roles.json và frontmatter. Agent con chạy model mặc định của phiên. dev.md mặc định vẫn mô tả Creator.

roles.json · re.md:4 · dispatcher.mjs:19-20
Tham khảo · đọc qua gh ngày 16/11/2026

7 repo cùng giải một bài: việc vào theo cỡ

Cả 7 repo đều chia việc thành 2 đến 4 cỡ. Chỉ cỡ lớn nhất phải chạy toàn bộ quy trình. Nhãn A/B/C cho biết ý đó dùng cho phần nào của đề xuất.

obra/superpowers

318k ★ · v7.0.2
  • A Bước "Size the Work" chia việc thành 2 cỡ. Việc phình ra giữa chừng thì dừng lại, nâng lên cỡ lớn hơn.
  • C Chọn model theo độ khó: việc 1–2 file dùng model rẻ, kiến trúc và review cuối dùng model mạnh nhất.

BMAD-METHOD

55k ★ · v6.12.4
  • A Đơn vị việc là 1 phiên bmad-build, khoảng 500 dòng. Có 4 tầng, việc hiển nhiên thì sửa thẳng.
  • B Ghi khối <!-- bmad:context --> trong AGENTS.md. Chỉ ghi lỗi đã thấy agent mắc.
  • C _bmad/custom/*.toml cho cả team, *.user.toml cho từng người, external_sources trỏ tới MCP.

github/spec-kit

150k ★ · v1.4.0
  • A Extension bug có 3 bước assess → fix → test, kết luận verified / partial / failed.
  • B Constitution chỉ ghi luật đã đúng trong repo. Spec đầu tiên chỉ mô tả 1 thay đổi nhỏ.
  • C Bundle đóng gói theo vai, catalog JSON nội bộ có bước duyệt.

Fission-AI/OpenSpec

75k ★ · v2.0.0
  • A Mỗi thay đổi nằm trong changes/<id>/. Archive gộp delta ADDED / MODIFIED / REMOVED vào specs/.
  • B Spec bắt đầu rỗng và lớn dần qua từng thay đổi. Không viết bù spec cho cả hệ thống.
  • C Stores là repo git riêng. Dự án khai references:, agent nhận chỉ mục 1 dòng mỗi mục.

GSD (open-gsd/gsd-core)

11.6k ★ · v1.21.0
  • A /gsd-fast chạy inline. /gsd-quick ghi vào bảng trong STATE.md, không đụng ROADMAP.
  • B map-codebase chạy 4 agent song song, viết 7 file trong codebase/.
  • C Bài học dùng chung toàn cục, mỗi lần nạp tối đa 10 mục vào planner.

Tencent/LoopForge

4.1k ★ · v0.4.0
  • A Vai khai đầu vào, đầu ra, quyền ghi. Bằng chứng có mốc hash, kết luận nộp 1 lần, chặn duyệt cũ, phân loại lỗi CLI.
  • B Agent giả theo kịch bản để test luồng không gọi model. Hash file đã cài, dừng khi gặp file người dùng sửa.
  • C Hàng đợi knowledge.md có duyệt, mẫu có phiên bản không sửa được, luật nạp theo dấu hiệu repo.

mattpocock/skills

39 skill · 19/11/2026
  • A grilling: hỏi theo vòng, mỗi câu kèm đáp án đề xuất. diagnosing-bugs: dựng lệnh tái hiện đỏ trước khi đoán.
  • B tdd: test ở seam đã thống nhất. to-tickets: task lát dọc có cạnh chặn.
  • C domain-modeling: GLOSSARY.md + ADR. retro: lỗi cơ học thì thêm check, không thêm luật.
RepoĐường cho việc nhỏNhận codebase có sẵnKiến thức dùng chung
Superpowers2 cỡ, chạy plan inlineTheo pattern sẵn có, không mapPlugin marketplace
BMAD1 phiên build, khoảng 500 dòngKhối context trong AGENTS.mdcustom toml, modules
spec-kitExtension bug, preset leanConstitution chỉ từ sự thật trong repoPreset, bundle, catalog riêng
OpenSpecMột vòng cho mọi cỡSpec delta lớn dầnStores và references:
GSDfast / quick / quick-batch4 mapper viết 7 fileGlobal learnings, giới hạn số mục nạp
mattpocock/skillsquick sửa lỗi theo 6 pha chẩn đoánGLOSSARY.md, ADR khi chốtReview 2 trục, retro đề xuất check
LoopForgesmall → SOLO, rejectTo + maxReworksVai khai inputs, outputs, accessHàng đợi knowledge.md, phiên bản không sửa
Phần A · gỡ điểm nghẽn 8

Mở phiên bằng phoenix code, giao agent theo nhóm model

Mọi phiên Claude Code, kể cả agent do monitor mở, chạy qua launcher phoenix. Launcher trỏ Claude Code tới PhoenixProxy, nên một phiên gọi được cả Claude, Cursor, GPT và Kimi. Phoenix dò danh sách model, gán nhóm model cho từng vai, rồi sinh file agent có model cụ thể. Agent con không còn dùng model mặc định của phiên.

Người dùngphoenix code Claude Codesession chính phoenix.mjs envGET /v1/models .claude/agents/<vai>@<nhóm>.md + thẻ model Agent(subagent_type: vai@nhóm) PhoenixProxy 192.168.0.5:8317đọc <CCR-SUBAGENT-MODEL> trong prompt agent, gửi tới đúng model
ViệcLệnh
Cài (macOS/Linux)curl -fsSL http://192.168.0.5:8317/install.sh | sh
Cài (Windows)irm http://192.168.0.5:8317/install.ps1 | iex
Lưu API keyphoenix key
Mở phiênphoenix code trong thư mục dự án
Model khácphoenix code --model gpt-6.2-sol
Tham số Claude Codephoenix code -- --resume
Xem model, nhóm/model trong phiên
Bước DòCách dò
Trong Claude CodeCLAUDECODE=1, CLAUDE_CODE_ENTRYPOINT
Qua launcherANTHROPIC_BASE_URL trùng địa chỉ proxy
Cursor CLI, CodexTên tiến trình cha
Model gọi đượcGET /v1/models, ghi .phoenix/env.json, giữ 1 giờ
Thành viên hỏngProxy trả model not allowed thì lấy thành viên kế tiếp

Launcher đặt ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, bật gateway model discovery và chạy Claude Code với --dangerously-skip-permissions. Monitor mở agent bằng phoenix code -- -p … --agent <vai>@<nhóm>. Phiên phoenix code không dùng được artifact claude.ai vì đăng nhập bằng key proxy.

Danh sách model ngày 19/11/2026

Nhà cung cấpId dùng trong thẻGiao task code
Anthropicclaude-opus-5-5 claude-opus-4-8 claude-sonnet-5-5 claude-haiku-5-5 claude-fable-5-2Có, context 1M
Cursorcursor/auto cursor/grok-4.7Có, context 200k
OpenAI APIgpt-6.2-sol gpt-6.2-astraCó, 500k và 272k
Moonshotkimi-k3.1-pro kimi-k2.8-codeCó, context 1M
ChatGPT webchatgpt-web/gpt-image-2.5 gpt-image-2, 4 model chatChỉ sinh ảnh
Gemini webgemini-web/gemini-4-neon -hydrogen -argonKhông

Dùng id gốc như bảng. Picker /model hiện model ngoài Claude dưới id dạng claude-fable-5-dd-…, id đó không dùng trong file agent.

Nhóm model và vai

analysis · combo

Phân tích

Session chính, PO, tech-lead, bản hiểu dự án. Alias opus.

20/11: claude-opus-5-5
coding-medium · combo

Code thường

dev, qa, game-design, product-design, devops, data-bi. Alias sonnet.

20/11: cursor/auto · claude-sonnet-5-5 (chia vòng)
coding-low · combo

Code nhỏ

Agent con của quick, tra cứu. Alias haiku.

20/11: claude-haiku-4-5-20251001
review-code · combo

Review code

Reviewer, khác model với analysis, kèm open-code-review. Không có alias, dùng thẻ CCR.

20/11: claude-opus-4-6
frontier · combo

Nhà cung cấp khác

Lượt Làm lại cuối khi Claude đã fail 2 lượt. Alias fable.

20/11: kimi-k3.1-pro
re

RE APK

Vai re-apk: APK Unity IL2CPP, Cocos.

cursor/auto → cursor/grok-4.7
art-gen

Sinh ảnh

Vai art-game khi cần ảnh mới.

chatgpt-web/gpt-image-2.5 → gpt-image-2
AgentNhómThang Làm lại
Session chính, PO, tech-leadanalysis
dev-*, qa-*, game-design, product-design, devops, data-bicoding-mediumcoding-medium → analysis → frontier
Agent con của quickcoding-lowcoding-low → coding-medium → analysis
reviewerreview-codeLuôn khác model với người làm
re-apkrecursor/auto → cursor/grok-4.7 → analysis
art-game (sinh ảnh)art-gen

Từ 20/11/2026 proxy mở 5 combo gọi thẳng bằng tên (analysis, coding-medium, coding-low, review-code, frontier), proxy tự chia vòng. Nhóm re và art-gen không có combo nên Phoenix tự chọn thành viên. models.json khai combo và members dự phòng; vai khai group và ladder trong role.json.

Tạo agent con với model cụ thể

# .claude/agents/re-apk@re.md — phoenix.mjs env sinh, không viết tay
---
name: re-apk@re
description: Phân tích APK Unity IL2CPP và Cocos.
tools: Read, Grep, Glob, Bash, Edit, Write
---
<CCR-SUBAGENT-MODEL>cursor/auto</CCR-SUBAGENT-MODEL>

(AGENTS.md của vai re-apk)
Ai giaoCách gọi
Session chínhCông cụ Agent, subagent_type: "re-apk@re", không truyền model
Monitorphoenix code -- -p … --agent re-apk@re, không truyền --model
Làm lạiGiao cho file của nhóm kế tiếp, vd re-apk@analysis
Vai runtime cursorcursor-agent --model <id>, cần agent login

phoenix.mjs env sinh 1 file cho mỗi nhóm trong group và ladder của vai, thẻ ghi thành viên đang chọn. File nằm trong .gitignore. Nhóm có alias gọi được bằng tham số model; nhóm review-code, re, art-gen chỉ gọi được qua thẻ. Hướng dẫn nằm trong SKILL.md mục "Mở phiên và giao agent" và references/models.md.

Mỗi run có thư mục cấu hình riêng (CLAUDE_CONFIG_DIR=.phoenix/runs/<run>/home), chỉ symlink skill vai được dùng, nên agent song song không ghi đè nhau. File agent mang disallowedTools theo access của vai: reviewer chỉ ghi báo cáo, QA chỉ ghi test.

Lỗi khi chạy agent: lỗi hạ tầng không đốt thang model

Run fail thì phân loại trước khi quyết định Làm lại. Chỉ lỗi chất lượng mới lên nhóm model kế tiếp. Quota, giới hạn tốc độ hay model không gọi được thì đổi sang thành viên khác cùng nhóm.

MãDấu hiệuXử lý
AUTH_FAILED401, invalid api keyDừng, báo chạy phoenix key
RATE_LIMITED429, rate limitChờ lùi dần 10 s · 2^n, tối đa 5 lần, rồi đổi thành viên cùng nhóm
QUOTA_EXCEEDEDquota, insufficientĐổi thành viên cùng nhóm
MODEL_UNAVAILABLEmodel not allowed, not foundĐánh dấu trong env.json, đổi thành viên cùng nhóm
CONTEXT_LIMITcontext, too longGiao lại với brief rút gọn, cùng nhóm
NETWORK_ERRORECONNREFUSED, timeoutThử lại 1 lần, rồi báo proxy không tới được
CLI_START_FAILEDThoát trước dòng jsonl đầu tiênChạy lại phoenix.mjs env, báo trên monitor
MISSING_RESULTThoát 0 nhưng thiếu đầu ra bắt buộcLỗi chất lượng: Làm lại theo thang
QUALITYKiểm trả partial hoặc failedLàm lại theo thang
failure.md

Mỗi run fail ghi 3 mục: bằng chứng (mã lỗi, 8 dòng stderr đầu, 20 dòng cuối, lệnh), điều chưa biết, bước tiếp. Giữ 8 dòng đầu để lần thử lại không che lỗi đầu tiên. Không đoán nguyên nhân khi thiếu bằng chứng.

thời gian

Mỗi run ghi thời gian chạy (hợp các khoảng agent chạy, không cộng trùng khi song song), thời gian chờ người và tổng thời gian.

chi phí

Bảng giá theo id model trong models.json. Thiếu giá hoặc thiếu token thì chi phí là "chưa rõ", không ghi 0. Monitor hiện chi phí theo nhóm kèm % run tính được giá.

điểm sức khoẻ

0–100 tính từ jsonl: Làm lại 25, thời gian 20, gọi tool lặp 20, token 15, lỗi lặp 10, đủ đầu ra 10. Dưới 70 thì harvest đưa run vào danh sách xem lại.

Phần B · gỡ điểm nghẽn 1–4

Ba luồng việc, một bộ bước

quick là việc nhanh: 1 agent con làm xong trong 1 phiên, không tạo task trên monitor. Làn này nhận sửa lỗi nhỏ, chỉnh UI, đổi text, chỉnh số. change là thay đổi vừa, có CHANGE.md, kiểm tự động và review khác bên, chạy cả khi autopilot đã dừng. project chạy chuỗi phase. Cả 3 luồng đi cùng 8 bước, bước giống nhau mang cùng tên.

quick≤ 3 file, ≤ 300 dòng Làm lại theo nhóm model · hết thang hoặc phình ra ↓ Nâng luồng change≤ 20 file, ≤ 2000 dòng Làm lại theo nhóm model · hết thang hoặc phình ra ↓ Nâng luồng projectmàn, tính năng lớn

Ô mờ là bước bỏ qua. quick và change chỉ có 1 việc nên không có bước Chia. Thời gian một vòng chấm chạy chỉ để so sánh tương đối.

Bước (id)Nghĩaquickchangeproject
0 Dò probeBiết CLI nào, model nào gọi đượcĐọc .phoenix/env.json do phoenix.mjs env ghi. Xem Phần A
1 Nhận intakeGhi yêu cầu, chọn luồng sơ bộBrief 5 dòngCHANGE.md mục Yêu cầuKick-off: PRD/GDD, workflow, blueprint
2 Hiểu understandBản hiểu, duyệt, ra cỡ thật≤ 10 dòng, session chính duyệt≤ 10 dòng, người giao duyệtDự án ≤ 1 trang, người dùng duyệt. Mỗi task ≤ 10 dòng
3 Chia planCắt việc thành phần giao đượcbỏ quabỏ quaPO cắt task theo phase
4 Giao assignChọn vai, nhóm model, mở agentAgent conRun trong .phoenix/runs/Dispatcher của autopilot
5 Làm buildSửa, test, commit có trailerQuick: qk-nChange: idCommit theo task
6 Kiểm verifyTự chạy lại test, kiểm tự động, review khác bênSession chính chạy lại test, đếm diffchange check + reviewerTask QA + cổng phase
7 Chốt closeGhi bản ghi, nhả khoá1 dòng CHANGES.mdarchive/, giữ logTask done, cổng đạt, release + harvest
Làm lại retryKiểm fail vì chất lượngGiao lại cho nhóm model mạnh hơn. Xem thang
Nâng luồng promoteViệc lớn hơn ngưỡngthành changethành projectkhông có

Id bước dùng làm trạng thái trong file, tên cột trên monitor và tiêu đề tin Telegram. Kết luận bước Kiểm dùng chung: verified, partial, failed.

Thử chọn luồng

Luồng đề xuất quick

    Ngưỡng đã chốt: quick ≤ 3 file và ≤ 300 dòng. change ≤ 20 file và ≤ 2000 dòng, 1 tới 3 run. Chạm vùng nhạy cảm thì ít nhất là change. Chỉnh trong .phoenix/sizes.json. Bước Nhận chọn sơ bộ, bước Hiểu chốt theo danh sách file trong bản hiểu.

    Bước Hiểu, chung cho 3 luồng

    Bước này chỉ đọc code. Bản hiểu sai thì sửa ở đây rẻ hơn sửa code đã viết.

    1 · bản hiểu

    Mục tiêu nói lại bằng lời của agent, file sẽ đụng, "Xong khi" kiểm được, seam kiểm (nơi đặt test, bắt được gì, bỏ sót gì), ngoài phạm vi, giả định, câu hỏi. Dùng đúng từ trong GLOSSARY.md.

    2 · hỏi theo vòng

    Sự thật trong repo thì agent tự tra, không hỏi. Quyết định xếp thành cây: mỗi vòng hỏi hết các câu đang hỏi được, đánh số, kèm đáp án đề xuất, "đồng ý" là nhận đáp án.

    3 · cổng tự động

    "Xong khi" kiểm được, có ≥ 1 seam, câu hỏi mở = 0. Thuật ngữ vừa chốt ghi ngay vào GLOSSARY.md.

    4 · cỡ thật

    Danh sách file cho ra cỡ thật. Vượt ngưỡng thì Nâng luồng trước khi sửa dòng nào.

    Luồng quick: giao agent con, không lên monitor

    Session chính là người điều phối duy nhất. Không có run file, task hay khoá scope. Một agent con làm cả Hiểu lẫn Làm (tiếp tục bằng SendMessage), nên agent không đọc lại code.

    Người dùng Session chính Agent con Repo yêu cầu 1 Nhận: brief, mở agent nhóm coding-low 2 Hiểu: bản hiểu ≤ 10 dòng (chỉ đọc) lệch thì hỏi lại 4 Giao: SendMessage "duyệt, làm đi" 5 Làm: sửa, test, commit trailer Quick: qk-n báo cáo: file, số dòng, lệnh + kết quả, Quyết định 6 Kiểm: chạy lại test, đếm diff, kiểm vùng nhạy cảm 7 Chốt: 1 dòng docs/CHANGES.md
    Tình huốngXử lý
    Kiểm failLàm lại: coding-low → coding-medium → analysis. Hết thang mới Nâng luồng thành change, brief thành CHANGE.md, commit đã có giữ nguyên.
    Diff thật vượt ngưỡngNâng luồng ngay, review như change.
    Chạm vùng nhạy cảmLà change ngay từ bước Nhận, dù chỉ 1 dòng.
    2 việc quick cùng lúcChạy song song khi không trùng file. Trùng file thì chạy lần lượt.
    Monitor tắtVẫn chạy. Monitor chỉ đọc CHANGES.md để hiện danh sách việc gần đây.

    Luồng change: trạng thái là id bước

    Run dùng lại .phoenix/runs/ sẵn có (pid, trạng thái, thời gian chạy, log jsonl), không tạo thư mục .runs/ mới.

    lệch: sửa yêu cầu Làm lại: coding-medium → analysis → frontier 1 Nhậnintake 2 Hiểuunderstand 4 Giao · 5 Làmbuild 6 Kiểmverify 7 Chốtclosed verified waitingcâu hỏi, không tính giờ lostpid chết, nhả khoá Nâng luồngproject / cắt nhỏ Bước 3 Chia bỏ qua. Frontmatter giữ vòng đời, chỉ lệnh phoenix.mjs change ghi. Run file giữ trạng thái sống. Monitor ghép 2 nguồn.
    #phoenix.mjs change check (trước reviewer)
    1File trong commit Change: <id> nằm trong scope. Ngoài scope phải có dòng Quyết định
    2Số file, số dòng dưới ngưỡng change
    3Tự chạy lại "Cách kiểm" và test dự án, không dùng số trong REPORT
    4Mỗi dòng "Xong khi" có bằng chứng: lệnh + đầu ra, hoặc ảnh
    5REPORT ghi phần code test đã chạm
    Kết luận KiểmKhi nào
    verifiedĐủ mọi dòng Xong khi, test xanh, không quyết lén. Sang Chốt
    partialĐạt một phần, không hỏng chỗ khác. Làm lại phần thiếu
    failedTest đỏ, hỏng chỗ khác, ngoài scope không ghi, hoặc quyết lén. Làm lại kèm lỗi
    humanCần người quyết phạm vi hay đánh đổi. Dừng ở inbox, không tính lượt

    Luồng project: cùng bộ bước, chạy ở 3 tầng

    Tầng dự án chạy Dò, Nhận, Hiểu một lần. Tầng phase lặp Chia, Kiểm, Chốt cho mỗi phase. Tầng task lặp Hiểu, Giao, Làm, Kiểm, Chốt cho mỗi task, giống một change nhỏ. Phase, cổng và autopilot giữ như hiện tại.

    Tầng dự án · P0 0 Dòphoenix.mjs env 1 Nhậnkick-off 2 Hiểu dự ánUNDERSTANDING.md người dùng duyệt 1 lầnlà cổng ra P0, cùng npm test + build Tầng phase · lặp P1 → P6 3 ChiaPO cắt task Tầng task · mỗi task, tối đa 3 song song mỗi vai 6 Kiểm phasecổng gates.mjs 7 Chốt phasesang phase sau còn phase → quay lại Chia task fail → Làm lại theo nhóm model 7 Chốt dự án: release + harvestautopilot dừng sau P6, người dùng chạy release Việc nhỏ giữa phase đi quick hoặc change,không thành task, không mở lại cổng đã đạt.
    BướcTầngViệcAi · nhóm modelPhase
    0 DòDự ánphoenix.mjs env lúc mở monitor, ghi .phoenix/env.jsonMonitorTrước P0
    1 NhậnDự ánKick-off: loại dự án, goal, workflow, blueprint, nguồn (APK, GDD, PRD, repo) → DECISIONS.mdNgười dùng + PO · analysisP0
    2 HiểuDự ándocs/UNDERSTANDING.md ≤ 1 trang: mục tiêu, phạm vi, nguồn, tiêu chí release, rủi ro, câu hỏi. MớiPO · analysis, người dùng duyệtP0
    3 ChiaPhaseCắt task cho phase hiện tại, mỗi task có vai và Xong khi kiểm được. Tối đa 3 lượt cắtPO · analysisĐầu mỗi phase
    2 HiểuTaskMục ## Hiểu yêu cầu ≤ 10 dòng trong file task, cổng tự động như quick. MớiAgent vai · nhóm của vaiMỗi task
    4 GiaoTaskDispatcher tra nhóm → model gọi được, tối đa 3 agent song song mỗi vaiAutopilotMỗi task
    5 LàmTaskSửa, test, commit, viết output taskAgent vaiMỗi task
    6 KiểmTaskTask QA theo màn hoặc nhóm. Task code có review khác bên. Kết luận verified / partial / failed. MớiQA · coding-medium, reviewer · reviewMỗi task
    6 KiểmPhaseCổng phase có bằng chứng. Autopilot tự duyệt cổng đạt, kế hoạch review luôn chờ người dùngAutopilot, người dùngCuối phase
    7 ChốtPhase / dự ánSang phase sau. Hết P6 Polish thì dừng. Release do người dùng, harvest mở MR lên hubNgười dùng + người triển khaiP7 / Release

    Kết luận partial và failed ghi quay_ve: understand khi bản hiểu sai, build khi code sai. Hết lượt Làm lại thì dừng chờ người ở inbox, không tự đóng là fail.

    Chẩn đoán lỗi: có lệnh đỏ rồi mới đoán

    PhaViệcXong khi
    1 Vòng phản hồiDựng 1 lệnh tái hiện: test, script CLI, curl, qa:play, replay logĐã chạy, đỏ đúng triệu chứng, nhanh, ổn định, agent tự chạy được
    2 Thu nhỏCắt dần đầu vào, bước, cấu hìnhBỏ thêm phần nào cũng xanh
    3 Giả thuyết3–5 giả thuyết xếp hạng, mỗi cái kèm dự đoánGhi task log trước khi đo
    4 ĐoMỗi lần 1 biến, log gắn [DEBUG-id]Biết giả thuyết đúng
    5 SửaTest hồi quy ở seam đúng trước, rồi sửaĐỏ rồi xanh; không có seam thì ghi là phát hiện
    6 DọnGỡ [DEBUG-, bỏ code thửCommit ghi giả thuyết đúng

    Dùng cho quick sửa lỗi, task chẩn đoán của autopilot (đã áp: references/diagnose.md) và Làm lại khi chưa rõ nguyên nhân. PO cắt task theo lát dọc (core → view → test, kiểm được riêng); refactor rộng chia 3 bước thêm dạng mới, chuyển nơi gọi, bỏ dạng cũ. Review chia 2 reviewer song song: trục Spec và trục Chuẩn (CODING_STANDARDS.md + danh sách code smell). Change ở dự án app chạy trong worktree riêng.

    Giao việc và báo cáo

    mẫu brief cố định

    Vai, Việc, Đầu vào, Đầu ra (đường dẫn, bắt buộc hay không), Bằng chứng phải nộp, Lần thử, Lỗi lượt trước. Dùng chung cho quick, change và task.

    chỉ trích phần cần

    Brief chép đúng các mục khai trong role.json.inputs. Agent chỉ mở file gốc khi phần trích thiếu hoặc mâu thuẫn.

    báo cáo ≤ 500 ký tự

    status, verdict, next, đường dẫn đầu ra, 1–3 ràng buộc. Session chính và PO chọn bước tiếp từ đây, không đọc lại cả file trạng thái.

    luật theo dấu hiệu

    Luật chung luôn nạp. Luật Go, SQL, frontend, Axmol, Unity chỉ nạp khi repo có go.mod, thư viện, đuôi file tương ứng.

    trợ lý chỉ đọc

    Vai phụ explorer (coding-low, access read) tìm code và tài liệu cho bước Hiểu. Không review, không sửa.

    Bằng chứng không giả được

    4 Giaoghi hash đầu ra 6 Kiểmđầu ra phải đổi verdict.jsonnộp 1 lần · sha256 diff 7 Chốttính lại sha256 không đổi = chưa nộp lần 2 báo lỗi khác = code đổi sau duyệt Mọi lệnh kiểm báo 1 trong 4 trạng thái: passed, failed, blocked, not-run. Test chưa chạy không được ghi là đạt.

    Duyệt và thông báo

    Cơ chếCách làm
    Chặn duyệt cũYêu cầu duyệt ghi (bước, lượt, số lần Làm lại). Lúc bấm, lệch với trạng thái hiện tại thì từ chối và hiện trạng thái mới
    Nút TelegramDuyệt, Làm lại, Trả về bước…, Bỏ qua. Nút sinh từ trạng thái hiện tại. Bấm thì kiểm đúng chat, đúng dự án, tin dưới 24 giờ, hành động còn hợp lệ
    Bỏ tin nhắc cũNgay trước khi gửi, run đã xong, trạng thái đã đổi hoặc lượt đã tăng thì bỏ tin. Gửi lỗi thử lại lùi dần 10 s · 2^n, tối đa 5 lần
    Agent tự tóm tắtKhối ```notification JSON (title, summary) cuối báo cáo. Thiếu thì lấy 300 ký tự đầu. Không gọi thêm model
    Mẫu tin an toànBiến trong danh sách cố định, thay 1 lượt. Mọi tin qua hàm che token, key trước khi gửi

    Nhánh, giao code và bài học

    tên nhánh

    change/<id>-<yyyymmdd>, task/<id>-<yyyymmdd>. quick commit thẳng lên nhánh đang làm.

    tìm MR

    gh pr list --head hoặc glab mr list --source-branch. Không dò link trong log. Nhiều repo: tất cả đóng mới là đóng.

    gộp nhánh chính

    Autopilot gộp nhánh chính trước mỗi lượt Giao. Xung đột thành thẻ chặn kèm tối đa 8 đoạn xung đột, repo đó dừng nhận việc mới.

    bài học có / không

    Chốt của mọi change và task ghi bài học: có | không — lý do. Có thì viết docs/knowledge/<id>.md cho hàng đợi harvest. Không quyết theo cỡ việc.

    Làm lại: lên nhóm model trước, Nâng luồng sau

    Kiểm fail vì chất lượng thì Làm lại bằng nhóm mạnh hơn. Lượt mới nhận bản hiểu đã duyệt, diff hiện tại và lỗi lượt trước.

    lượt 1lượt 2lượt 3hết thang Bỏ qua thang, Nâng luồng ngay: diff vượt ngưỡng, chạm vùng nhạy cảm, hoặc bản hiểu cho thấy việc lớn hơn ngưỡng.

    Thang áp cả cho bước Hiểu: bản hiểu bị bác 1 lần thì lượt sau viết bằng nhóm kế tiếp. Với quick, đổi nhóm là gọi Agent mới bằng file <vai>@<nhóm> của nhóm đó, vì SendMessage giữ model cũ. Mỗi lượt ghi nhóm + model vào CHANGES.md hoặc run-summary.json để harvest chọn nhóm khởi đầu cho vai.

    Nền của luồng change là artifact "Luồng change": giữ CHANGE.md làm nguồn sự thật, Quyết định ba phần, review khác bên, khoá scope, agent không tự đặt verified. Phoenix thêm bước Hiểu, kiểm tự động, số cụ thể cho agent chết (pid chết → lost, jsonl im 15 phút → cảnh báo), thời hạn 90 phút mỗi run, tối đa 3 run, và dùng .phoenix/runs/ sẵn có.

    Rủi ro còn lại: nhiều change cùng cây làm việc thì test có thể chạy trên code dở của change khác. change check chạy lại test lúc kiểm và báo commit làm đỏ. Đỏ lặp do change khác thì cho chạy lần lượt.

    FileĐổi gì
    tools/lib/env.mjs (mới)Dò CLI và launcher, gọi /v1/models, chọn thành viên nhóm, ghi env.json, sinh <vai>@<nhóm>.md có thẻ CCR-SUBAGENT-MODEL
    tools/lib/changes.mjs (mới)CHANGE.md, vòng đời theo id bước, khoá scope, check, archive
    tools/lib/sizes.mjs (mới)Đọc sizes.json, đếm cỡ theo trailer, kiểm vùng nhạy cảm
    tools/phoenix.mjsenv, change new | understand | start | check | verdict | archive, quick log
    monitor/lib/dispatcher.mjsMở agent qua phoenix code -- -p … --agent <vai>@<nhóm>, bỏ modelOf, ghi nhóm + model vào run
    monitor/lib/autopilot.mjsGiao change kể cả khi autopilot dừng. Thang Làm lại theo nhóm
    tools/lib/tasks.mjsTask có mục Hiểu yêu cầu, kết luận Kiểm có quay_ve, dòng bài học
    tools/lib/evidence.mjs (mới)Mốc hash đầu ra, kết luận nộp 1 lần, kiểm sha256 lúc Chốt
    tools/lib/failures.mjs (mới)Bảng mã lỗi, failure.md, điểm sức khoẻ run
    tools/lib/brief.mjsMẫu brief cố định, trích mục đầu vào, nạp luật theo dấu hiệu
    monitor/lib/telegram.mjsNút duyệt, kiểm lại lúc bấm, bỏ tin cũ, che khoá
    ui/monitorCột theo id bước, danh sách quick, thẻ model gọi được
    CLAUDE.md (3 bản), SKILL.md, references/models.mdMở phiên bằng phoenix code, bộ bước chung, chọn luồng, mẫu brief và bản hiểu, bảng vai → nhóm
    Phần C · gỡ điểm nghẽn 5–6

    join-project.mjs: nhận repo có sẵn ở mọi stack

    node <skill>/scripts/join-project.mjs <repo> --mode auto|maintain|resume. Join chỉ thêm file trên nhánh phoenix-join, nên không cần git sạch và không cần RE, GDD hay replay. Bốn agent đọc repo song song rồi viết 7 file mô tả. Agent sau đó làm việc theo luật đã đúng sẵn trong repo, có README và CI làm bằng chứng.

    Repo có sẵnGo · Axmol · Next.js Dò stackstacks.yaml AGENTS.mdphoenix:context maintainM0 → M1 → M2 Spec bắt đầu rỗng, lớn dần qua từng change (OpenSpec)
    M0 · Onboard

    Map codebase, viết khối context, chạy test hiện có để ghi mốc. Cổng codebase đạt khi đủ 7 file và test mốc chạy được.

    M1 · Backlog

    Các change nối tiếp nhau, không có điểm kết thúc. Phase này không có cổng chung, mỗi change tự kiểm.

    M2 · Release

    Gom các change thành changelog và build phát hành. Cổng release giống workflow app.

    --mode resume

    Dự án đang làm dở: tìm dự án đang ở phase nào rồi chạy tiếp từ đó. Port Creator 3.x làm dở vẫn qua adopt-project.mjs hiện có.

    Chế độ resume: dự án đang triển khai dở

    maintain dành cho sản phẩm đã xong. resume dành cho dự án còn tính năng chưa làm. --mode auto chọn resume khi có tài liệu kế hoạch (GDD, PRD, backlog) và còn mục chưa có trong code.

    Repo làm dở+ GDD/PRD/backlog join 1-54 mapper, baseline Mapper tiến độgit log, nhánh, TODO PROGRESS-MAPdone/partial/missing Người dùngduyệt bản hiểu nhập theo bản đồ task doneimportedviết hồi tốtài liệu thiếuchangepartial · wiptask mớimissing Autopilot chạy tiếptừ phase đầu tiên chưa đủ
    Trong bản đồPhoenix tạoGhi chú
    Phase đủ đầu raTask done sinh từ git log và code. Cổng vào inbox kèm bằng chứng, nhãn importedNgười dùng duyệt 1 lần, cổng không chạy lại
    Code có, tài liệu thiếuTask nhỏ "viết hồi tố từ code"Chỉ viết phần phase sau cần đọc, không chặn phase sau
    Tính năng partial1 change mỗi mục, scope là file của mục đóĐi luồng change
    Tính năng missingTask project trong phase tương ứngNhư dự án mới
    Việc dở chưa commitChange ch-wip-<nhánh>, owner là người đang làmKhông commit hộ. Người dùng chọn giao agent hay để người làm tiếp

    Bước khởi tạo chỉ thêm file trên nhánh phoenix-join, không sửa code. Không có tài liệu kế hoạch thì bản hiểu hỏi người dùng mục tiêu còn lại và hạn, câu trả lời thành PRD hoặc GDD tối thiểu. Game làm theo màn thì nhập từng màn: màn xong là task done, màn dở là change. Bản đồ sai thì sửa PROGRESS-MAP.md rồi chạy join-project.mjs --mode resume --apply, lệnh chỉ thêm, không xoá task.

    Phần D · nhiều người, nhiều máy

    Agent chạy ở máy từng người, cả đội xem trên Monitor Server

    Mỗi người mở phoenix code trên máy mình, cạnh thiết bị và toolchain của máy đó. Git đồng bộ dữ liệu dự án và làm khoá nhận việc. Monitor ở mỗi máy tự gửi tóm tắt lên Monitor Server trên Mac mini. Server biết dự án có mấy người tham gia, ai đang làm phần nào. Server chỉ để xem: không chạy agent, không giao việc, không ghi vào repo.

    Máy A · Anphoenix code + monitordev-axmol · task P4-07Android root Máy B · Bìnhphoenix code + monitorqa-game · change ch-12macOS, iOS GitLabtask · claim · cổng Monitor ServerMac mini · Tailscaleai online · đang làm gìbước · nhóm modelchi phí · cổng chờchỉ xem git push pull 5' sự kiện tóm tắt · 10 s sự kiện tóm tắt · 10 s

    Máy chỉ gửi tóm tắt: không code, không diff, không log đầy đủ. Mất mạng thì sự kiện xếp hàng trong .phoenix/outbox.jsonl và gửi bù, id <máy>-<số> chống trùng.

    Nhiều người cùng dự án qua git

    LuậtCách làm
    Nhận việc bằng pushGhi claimed_by: người@máy vào file task (hoặc owner trong CHANGE.md), commit lên nhánh chính, push ngay. Push bị từ chối thì người khác vừa nhận: pull, chọn việc khác
    Không trùng scopeTừ chối nhận việc có scope trùng việc đang có người nhận
    1 autopilot mỗi dự án.phoenix/autopilot-owner có commit. Người khác giao tay được, không tự giao
    Mỗi mục một file.phoenix/gates/<phase>.json, docs/decisions/<id>.md. Bảng tổng hợp sinh lại. CHANGES.md dùng merge=union
    Mỗi việc một nhánhCode vào nhánh chính qua MR. Pull và gộp nhánh chính trước mỗi lượt Giao
    Nhận lại việc bỏ dởClaim quá 24 giờ không commit và người nhận offline thì phoenix.mjs claim <id> --takeover, ghi lý do
    Việc cần thiết bịTask khai needs (vd android-root), chỉ máy có thiết bị trong env.json nhận được

    Monitor Server hiện gì

    An · máy A
    P4-07 UI màn Shop · 5 Làm · coding-medium
    online
    Bình · máy B
    ch-12 sửa combo · 6 Kiểm · review
    online
    Chi · máy C
    claim P4-09 · commit cuối 3 giờ trước
    offline
    TrangNội dung
    Tất cả dự ánPhase, số người online, việc đang chạy, cổng chờ duyệt
    Một dự ánTừng người: online/offline (mất heartbeat 5 phút), việc đang nhận, bước, nhóm model. Bảng task có cột người nhận
    Một ngườiViệc đang làm ở mọi dự án, việc xong 7 ngày qua
    Chi phíTheo dự án, người, nhóm model, % run tính được giá
    Sự kiện máy gửiTrường
    heartbeat · 60 sngười, máy, dự án, phiên bản Phoenix, số run đang chạy
    claim, releaseid việc, luồng, tiêu đề, scope
    stepid việc, bước, vai, nhóm model, model
    run_endkết luận, mã lỗi, thời gian chạy và chờ, token, chi phí hoặc "chưa rõ"
    gate, blockedphase, cổng chờ ai; lý do bị chặn (xung đột nhánh, câu hỏi, thiếu thiết bị)

    Claim, task và cổng lấy từ git. Sự kiện chỉ bổ sung trạng thái đang chạy, lệch thì hiện theo git kèm dấu "máy chưa đồng bộ". Danh tính lấy từ token của người (phoenix.mjs server join <url>), dự án nhận ra bằng git remote. Mỗi dòng có link mở monitor của máy đó qua Tailscale khi máy online. Duyệt vẫn làm ở monitor máy hoặc nút Telegram. Nhiều dự án trên 1 máy: mỗi monitor tự lấy cổng trống từ 4700, ~/.phoenix/slots.json giới hạn số agent cả máy theo priority.

    Quy ước giao diện: 5 màu trạng thái có bản sáng và tối, chỉ dùng cho trạng thái thật. Huy hiệu dạng viên, chấm thở khi đang chạy. Trạng thái rỗng có biểu tượng, tiêu đề, 1 dòng mô tả. Lỗi tải có khung đỏ role="alert". Hover chỉ đổi màu. Chuyển động tắt khi prefers-reduced-motion. Giao diện chỉ hiện trạng thái server trả, không tự suy.

    Phần E · kho trung tâm Server LAB

    phoenix-hub: vai trò, kiến trúc mẫu, bài học

    Hub là một repo git đặt trên GitLab công ty (git.skylinkmedia.asia, nơi đang chứa waterpack và block-crush), không cần viết server riêng. Git lo phiên bản, merge request lo bước duyệt, nhóm GitLab lo phân quyền. Server LAB là Mac mini M4 đặt ở văn phòng, tách khỏi máy Ubuntu chạy brain. Mac mini giữ một bản clone hub, job launchd pull 5 phút một lần, và chạy Monitor Server. Mỗi dự án ghim commit hub trong .phoenix/hub.lock, nên hub thay đổi không làm lệch dự án đang chạy.

    vòng tái sử dụng mỗi dự án để lại tài sản phoenix-hub (GitLab)roles/ · blueprints/ · recipes/ Kick-off: đề xuất 3 blueprintblueprint suggest ← PRD/GDD Dự án chạy, ghim hub.lockrole + blueprint + recipe Polish/Release: harvest→ merge request vào hub CEO / TL duyệt
    phoenix-hub/
      models.json      # nhóm model, §A
      roles/              # kho AGENTS theo vai
        dev-axmol/
          role.json        # runtime, group, ladder, skills, mcp
          AGENTS.md        # luật vai → .claude/agents
          knowledge/*.md   # API hay dùng, bẫy, checklist
          lessons.md       # bài học có nguồn dự án
        po-game/  game-design/  tech-lead/
        dev-go-backend/  qa-game/  # 18 vai
      blueprints/         # kiến trúc mẫu
        puzzle-sort-axmol/
          blueprint.json   # thể loại, stack, cỡ, điểm
          ARCHITECTURE.md  STRUCTURE.md
          DECISIONS.md     starter/ | ref.json
      recipes/            # 112 recipe, bắt buộc nhãn
      stacks/  domains/   # chuyển từ knowledge/
      catalog.json        # chỉ mục 1 dòng mỗi mục
    // roles/dev-axmol/role.json — nơi DUY NHẤT khai nhóm model
    {
      "runtime": "claude",
      "group":  "coding-medium",          // nhóm trong models.json
      "ladder": ["coding-medium", "analysis", "frontier"],
      "stacks": ["axmol-2.11"],
      "mcp": ["brain:search", "brain:ask"],
      "access": "write",          // read | report | write | test-write
      "inputs":  ["CHANGE.md#Hiểu yêu cầu"],
      "outputs": [{ "path": "REPORT.md", "required": true }],
      "inject": { "lessons": 10 }
    }
    Hubroles/dev-axmol/role.json
    Dự án ghi đè.phoenix/roles/dev.json
    Cá nhân, không commit~/.phoenix/roles/dev.user.json
    Harvest thu gìLấy từThành gì trong hub
    Kiến trúcSTRUCTURE.md, ARCHITECTURE.md, DECISIONS.md, cây thư mục codeBlueprint mới, hoặc bản cập nhật của blueprint dự án đã dùng
    Bài học vaiSolution và Knock-on trong task, các run fail rồi sửa được, ASSUMPTIONS.mdMục mới trong lessons.md của vai, mỗi mục tối đa 3 dòng và ghi nguồn
    RecipeCác recipe trong docs/recipes có scope: genericrecipes/ (dùng lại collect.mjs, chỉ đổi đích sang hub)
    Số liệuThời gian mỗi phase, số run, tỉ lệ cổng failblueprint.json.stats, dùng để xếp hạng khi đề xuất blueprint

    Bài học chỉ được ghi khi đã thấy agent mắc lỗi đó thật (cách BMAD "record"). Duyệt 2 bước. Người đang triển khai dự án duyệt bản nháp harvest trong inbox monitor, bỏ mục sai và che tên khách hàng. Sau đó merge request vào hub do CEO hoặc Tech lead chính duyệt (CODEOWNERS 2 người, cần 1 duyệt). Harvest còn đọc log run và đề xuất cải tiến môi trường agent: lỗi cơ học thì thêm check vào npm test, chỉ việc cần phán đoán mới vào CODING_STANDARDS.md, rút gọn CLAUDE.md, bỏ luật không đổi hành vi.

    Hàng đợi harvest, sửa hub có giới hạn

    docs/knowledge/title · source · kind candidateharvest gom pendingngười triển khai publishedMR gộp · CEO / TL rejected + lý do
    5 loại sửa

    Bài học chỉ đổi hub bằng: thêm mục lessons.md, nối luật vào AGENTS.md, đổi group/ladder, thêm/bỏ 1 cổng, đổi 1 trường commands. Mỗi loại có giới hạn giá trị. Không sửa tự do.

    sửa bản sao trước

    Áp vào .phoenix/roles/<vai>.json của dự án. Chạy ổn qua 1 mốc mới thành merge request lên hub.

    phiên bản không sửa

    Mục đã phát hành chỉ ra version mới. Gửi kèm baseVersion, hub mới hơn thì báo xung đột. Dự án nâng bằng phoenix.mjs hub upgrade, có diff.

    tham số recipe

    {{params.x}}, tối đa 20, kiểu string/int/number/bool. Thiếu hoặc lạ thì từ chối. Thay 1 lượt.

    đẩy có id cố định

    Id đặt trước lần gửi đầu. 429/5xx thử lại tối đa 5 lần, 4xx không thử, 409 đọc lại bản đã có. --check kiểm offline.

    Nhóm vai18 vai đợt đầuViệc chính
    Sản phẩmpo-game, po-app, game-design, product-designGDD/PRD, SPEC màn, test case, UX/UI app
    Kỹ thuậttech-lead, dev-axmol, dev-cocos-creator, dev-unity, dev-go-backend, dev-nextjs, dev-tauri, devopsTech lead chọn blueprint, duyệt kiến trúc, review cuối bằng nhóm review
    Chất lượngqa-game, qa-web, reviewerChạy test case, so ảnh, review code
    Nội dungart-game, re-apkAsset, phân tích APK Unity IL2CPP và Cocos
    Dữ liệudata-biSố liệu dự án, nối BI của brain

    6 blueprint khởi đầu theo engine

    Hiện chỉ Axmol có khung game đầy đủ. Unity và Phaser đã có khung ở 2 skill khác trên máy, chỉ cần chuyển vào hub. Mọi blueprint game giữ cùng cách tách lớp của Axmol: core/ logic thuần có test, view/ hiển thị, app/ khởi động và QA.

    BlueprintHiện trạngNguồnViệc cần làm
    game-axmol● Đủtemplate/.variants/axmolChuyển nguyên sang hub
    game-cocos-creator● Mỏngtemplate/game: Boot.scene, QA, core/ và view/ rỗngThêm core mẫu có test, view mẫu, GUIDE, STRUCTURE
    game-unity● Chưa cóUnityGameBase của skill port-unityStack unity-6, workflow qua Unity MCP, QA runner C#
    game-phaser-h5● Chưa cóH5GameBase của skill h5portStack phaser, QA bằng trình duyệt
    app-saas-admin● Có starterNext.js + Go, gói saas-adminViết ARCHITECTURE + STRUCTURE
    app-booking● Có starterTauri + Go, gói bookingNhư trên

    stacks.yaml hiện chỉ cho 1 engine game. Khoá game đổi thành danh sách, kick-off hỏi engine rồi mới đề xuất blueprint.

    Chọn dự án, nhận cấu trúc. Thiếu thì thêm mẫu theo chuẩn chung

    Khung mẫu là tài nguyên chung trong hub. Kick-off chọn loại dự án, hub trả cấu trúc khớp. Chưa có khung khớp thì phân tích một dự án mẫu, sắp lại theo khung gần nhất, kiểm đủ 8 tiêu chí rồi mới đưa vào hub.

    Chọn loại dự ánengine · thể loại · nền tảng Hub chấm điểmcatalog.json Nhận cấu trúcSTRUCTURE · starter · lock có khung khớp chưa có Phân tích mẫu4 mapper của join Sắp theo khungblueprint gần nhất Check8 tiêu chí MRCEO / TL vào hub
    #Tiêu chí chung của mọi blueprintCách kiểm
    1blueprint.json đủ trường: id, kind, stack, platforms, tags, version, source, commands, statsSchema
    2Tách lớp: core/ logic thuần không gọi engine, view/ hiển thị, app/ khởi động và QAThư mục, grep import engine trong core
    3Đủ ARCHITECTURE, STRUCTURE, DECISIONS, GUIDEFile và mục bắt buộc không rỗng
    4commands khai build, test, run, qa. Tool Phoenix chỉ gọi qua đâySchema
    5core/ có unit test xanhChạy commands.test
    6Phát sự kiện QA cùng định dạng qaEvents.ts / QaRunnerChạy commands.qa smoke
    7Không tên khách hàng, key, asset bản quyềnGrep danh sách chặn
    8Dự án tạo từ blueprint build và test xanhCI trên Mac mini

    Chuẩn lấy từ khung Axmol hiện có. Thêm tiêu chí thì sửa một chỗ (blueprints/CONTRACT.md + schema), mọi blueprint cũ chạy lại check, mục fail thành việc change.

    Phần F · đọc từ 25Brain

    Phoenix chỉ đọc brain, kho Phoenix độc lập

    25Brain là chương trình Go dùng PostgreSQL và pgvector, chạy trên máy chủ văn phòng, có MCP. Phoenix và brain là 2 hệ thống độc lập. Agent hỏi brain qua MCP để tra tài liệu công ty. Kho của Phoenix (phoenix-hub, repo dự án) ở GitLab, Phoenix không đẩy tài liệu, bài học hay số liệu sang brain. Brain không cần thêm phần nào riêng cho Phoenix.

    Agent dự ánrole.json.mcp: search, ask 25Braintài liệu công ty, quyền theo người GitLabphoenix-hub · repo dự án MCP, chỉ đọc git, đọc và ghi không đẩy sang brain
    công cụ đọc

    Vai chỉ dùng search, ask, get_document, who_knows, recent. Vai data-bi thêm bi. Khai trong role.json.mcp.

    token

    Token OAuth 30 ngày của người chạy, lưu ở ~/.phoenix/brain.json, không vào repo. Brain lọc theo quyền người đó. Brain có token ngắn hạn thì monitor đổi sang trước khi giao agent.

    trích nguồn

    Tìm trước khi đổi kiến trúc hoặc gặp lỗi lạ. Trích nguồn từ kết quả brain. Không thấy thì ghi "không có trong kho". Kiến thức mới viết vào docs/knowledge/.

    brain tắt

    Agent bỏ qua bước tra, báo cáo ghi "brain không trả lời". Không chặn việc. Tìm trong hub dùng catalog.json.

    Brain muốn lập chỉ mục hub hay repo dự án thì tự thêm như một nguồn git thông thường, việc đó thuộc phía brain. Cấu hình MCP trên monitor che header và biến có TOKEN, SECRET, KEY, AUTH.

    Nền · làm trước M1

    Repo skill test được luồng agent mà không gọi model

    Các mốc sau cần kiểm luồng nhiều agent mỗi lần commit. Agent giả chạy theo kịch bản ghi sẵn, sửa dự án mẫu thật và chạy test thật, nên npm test không tốn token.

    ViệcCách làm
    Agent giảfake-agent.mjs đọc fixtures/scenario-*.json, đi đủ Nhận → Chốt. Kịch bản: chạy thông, crash rồi resume, reviewer bác, thiếu đầu ra, fail lặp, duyệt cũ bị từ chối. Fail thì in transcript
    Test model thậtChỉ chạy khi PHOENIX_LIVE=1
    Hash file template.phoenix/install-state.json ghi sha256 từng file copy. upgrade-project dừng khi gặp file người dùng đã sửa, ghi đè chỉ với --force. Lệnh doctor báo thiếu, lệch
    Kiểm lệch nguồn sinh.variants/* và luật 3 bản sinh từ 1 nguồn, --check báo thiếu, thừa, lệch trong npm test. Thư mục sinh có file đánh dấu
    1 nguồn luậttemplate/CLAUDE.md chỉ còn @AGENTS.md
    Bảng nghiệm thuMỗi mốc 1 bảng: chức năng → file test, cần gì, mục "chưa phủ", mục "giới hạn của bằng chứng"
    Lộ trình

    7 mốc · M1 xong 21/11/2026

    A phoenix code ✓→B Ba luồng ✓→C Join ✓→D Nhiều người→E Hub→F Đọc 25Brain
    M1 ✓

    Launcher + nhóm model (gộp M0)

    Xong 21/11: 14 commit 6ae02c8…4dad403. CLI giả theo kịch bản, 7 nhóm model, phoenix.mjs env, file agent <vai>@<nhóm> có thẻ CCR, dispatcher qua launcher, 9 mã lỗi + đổi đích, thang nhóm trong autopilot, token/chi phí, huy hiệu trên monitor. npm test 352 pass, 2 fail chập chờn có sẵn; test live qua proxy pass.

    đã xong
    M2 ✓

    Ba luồng việc

    Xong 21/11: 13 commit 918261c…76346b9. quick + CHANGES.md, change (CHANGE.md, bước Hiểu có seam, khoá scope, check 5 kiểm, 2 reviewer Spec/Chuẩn, verdict nộp 1 lần, sha256 lúc Chốt, archive), change-pilot chạy cả khi autopilot dừng, duyệt chặn bản cũ + nút Telegram (1 bot cả máy), nhánh/worktree, trang Change trên monitor. npm test 418 pass, 2 fail chập chờn có sẵn.

    đã xong
    M3 ✓

    Join

    Code xong 21/11: cd15cb2…98ff59d. Dò 7 stack, join-project trên nhánh phoenix-join (chép không ghi đè, gộp package.json chỉ thêm khoá), 4 mapper → 7 file codebase, test mốc, khối phoenix:context, workflow maintain (cổng codebase, phase set), resume (bản đồ tiến độ, UNDERSTANDING.md, --apply, ch-wip), --mode auto, luật nạp theo dấu hiệu, vai explorer. npm test 457 pass. Chưa kiểm thật trên repo Go/Axmol thật.

    code xong
    M4 ✓

    Hub vai + recipe

    Code xong 21/11: 5ad1303…10817fb. hub-init lập hub 18 vai (remote bare tạm khi chưa có GitLab), hub sync/status, .phoenix/hub.lock ghim từng mục và hub upgrade có diff, vai đọc theo tầng hub → dự án → người, access/inputs/outputs + MISSING_RESULT, recipe có tham số, hàng đợi harvest duyệt trên monitor, 5 loại sửa hub thử trên dự án trước, harvest push (409 đọc lại, thử lại 429/5xx), harvest retro, autopilot giao PO gom bài học sau Polish. Nghiệm thu 2 máy pass. npm test 524 pass. Chưa nối GitLab thật.

    code xong
    M5 ✓

    Blueprint

    Code xong 21/11: c8bba2f…1f48cb1. 6 blueprint khởi đầu (Axmol, Cocos Creator, Unity, Phaser H5, app-saas-admin, app-booking) trong hub, chấm 8 tiêu chí (tách lớp, rò rỉ, build/test/qa), new-project --blueprint, blueprint suggest|use lúc kick-off, blueprint new từ dự án mẫu đi hàng đợi harvest, sửa gate/command áp thật, số liệu dự án vào stats. npm test 578 pass. Axmol/Unity/app chạy engine: chờ kiểm trên Mac mini.

    code xong
    M6 ✓

    Nhiều người + Monitor Server

    Code xong 21/11: d9f5e5e…de9a51c. Claim task/change bằng push (người push sau bị từ chối, takeover có lý do), cổng/quyết định/agent ghi file theo người nên gộp git không xung đột, task --needs thiết bị, monitor máy tự gửi tóm tắt (outbox gửi bù khi mất mạng, không mang code), Monitor Server Node thuần chỉ xem: dự án, ai đang làm phần nào, online/offline, chi phí; mã mời 1 lần, chỉ lưu sha256 token. Nghiệm thu 2 clone + 2 PHOENIX_HOME pass. Chưa thử 2 máy thật.

    code xong
    M7 ✓

    Đọc 25Brain

    Code xong 21/11: 69eb6b5…7d27abd. Client MCP chỉ đọc, tools/brain-mcp.mjs trong dự án chặn ingest, 5 công cụ đọc theo vai, brain setup|status chạy tay, blueprint suggest hỏi thêm brain. Brain tắt hoặc không trả lời trong 3s/10s thì chạy như cũ. Nghiệm thu với MCP server giả pass. Chờ brain giai đoạn 2 để kiểm thật (transport HTTP + Bearer là giả định).

    code xong
    Không viết server cho hubGitLab đã có phiên bản, phân quyền và bước duyệt.
    Không tự làm RAG trong PhoenixEmbedding và tìm vector thuộc brain.
    Không đẩy dữ liệu sang brainBrain không cần thêm phần riêng cho Phoenix.
    Server không chạy agentMonitor Server chỉ xem, không giao việc, không ghi repo.
    Không viết bù spec cho dự án cũSpec lớn dần theo từng change.
    Không chuyển mọi dự án cùng lúcMỗi dự án lên hub khi chạy upgrade-project.mjs.
    Không tự đặt ANTHROPIC_DEFAULT_*Launcher đã đổi đích alias; nhóm không có alias dùng thẻ CCR-SUBAGENT-MODEL.
    Không làm sandbox, runner từ xaAgent chạy trên máy đang mở phoenix code.
    Đã chốt

    15 quyết định

    1. Mọi phiên Claude Code mở bằng phoenix code qua PhoenixProxy. Model agent con đặt bằng thẻ CCR-SUBAGENT-MODEL, id lấy từ /v1/models.
    2. Session chính, PO và tech-lead dùng nhóm analysis. Task thường dùng coding-medium. RE dùng cursor/auto rồi cursor/grok-4.7.
    3. Ba luồng quick, change, project đi chung 8 bước. Kiểm fail thì Làm lại bằng nhóm mạnh hơn trước, hết thang mới Nâng luồng.
    4. Ngưỡng: quick ≤ 3 file và ≤ 300 dòng, change ≤ 20 file và ≤ 2000 dòng.
    5. Server LAB là Mac mini M4 đặt ở văn phòng, tách khỏi máy chạy brain. Mac mini giữ hub và chạy Monitor Server.
    6. Merge request vào hub do CEO hoặc Tech lead chính duyệt. Harvest do người đang triển khai dự án duyệt trước.
    7. 18 vai chia 5 nhóm, có nhóm sản phẩm: PO Game, PO App, Game Design, Product Design, Tech lead.
    8. Dự án đang làm dở vào Phoenix bằng join-project.mjs --mode resume.
    9. Vai khai access, inputs, outputs. Bằng chứng có mốc hash và kết luận nộp 1 lần. Duyệt qua Telegram kiểm lại trạng thái lúc bấm.
    10. Lỗi hạ tầng đổi thành viên nhóm, chỉ lỗi chất lượng mới lên thang model.
    11. Bài học đi qua hàng đợi docs/knowledge/ và chỉ sửa hub theo 5 loại sửa có giới hạn.
    12. Làm nền repo skill (agent giả, hash template, --check) trước M1.
    13. Agent chạy trên máy từng người. Nhiều người cùng dự án đồng bộ qua git, nhận việc bằng push.
    14. Monitor ở máy tự gửi tóm tắt lên Monitor Server. Server cho xem ai đang làm phần nào, không giao việc, không ghi repo.
    15. Phoenix chỉ đọc 25Brain qua MCP. Kho Phoenix độc lập, không đẩy dữ liệu sang brain.

    Việc ngoài Phoenix: sửa các combo trên PhoenixProxy cho khớp nhóm model và cấp quyền gọi combo cho key của đội. Địa chỉ repo hub điền vào ~/.phoenix/hub.json khi làm M4.