C+Codex + Claude Code cho quản lý dự án
0/9 bài
Bộ khung Jotun
Lưu giáo trình về máy để học offlineTrên iPhone: bấm nút Chia sẻ của Safari, chọn "Thêm vào MH chính".

Codex + Claude Code cho quản lý dự án

Điều phối hai trợ lý AI trên cùng một bộ dữ liệu: Codex vẽ, Claude lập đề bài và thẩm tra, bạn chốt quyết định. Thực hành trên dự án nhà máy sơn Jotun, đào sâu vào thiết kế phòng cháy chữa cháy.

9 bàikhoảng 7 buổi
10 promptcopy là dùng
1 bộ khungdự án mẫu

Lộ trình học

Học theo thứ tự. Bài 5 là phần khó nhất, nên dành riêng một buổi.

  1. 1Buổi 1
    Hai người thợ, một tổng chỉ huyPhân vai Codex, Claude và bạn
  2. 2Buổi 1
    Một thư mục, một nguồn sự thậtDữ liệu chung không lệch số
  3. 3Buổi 2
    Bộ luật chung cho hai AIAGENTS.md và CLAUDE.md
  4. 4Buổi 2
    Vòng lặp điều phốiBốn nhịp mỗi phiên, prompt bảy phần
  5. 5Buổi 3
    PCCC: phần khó nhấtĐề bài PCCC dạng dữ liệu
  6. 6Buổi 4–5
    Thực hành trọn vòng với JotunTám lượt giao việc
  7. 7Buổi 6
    Khi số liệu đổi, khi có sự cốĐổi số không vỡ thống nhất
  8. 8Buổi 6
    Từ Jotun đến dịch vụ PCCCNhân rộng thành quy trình
  9. 9Buổi 7
    Bộ công cụ mở rộngRevit MCP, NotebookLM, PyroSim, Notion
1

Hai người thợ, một tổng chỉ huy

Hiểu vì sao dùng hai AI, phân vai thế nào, và vai trò của chính bạn.

30 phútKết quả: bảng phân vai cho dự án của bạn

Hãy hình dung một công trường. Hai người thợ không nói chuyện trực tiếp với nhau. Họ giao tiếp qua hồ sơ chung và sổ giao ca, còn bạn là người giao việc và chốt kết quả.

Codex

Thợ dựng hình

  • Mặt bằng 2D, sơ đồ PCCC
  • Phối cảnh 3D
  • Giao diện web
  • Chạy nhiều phương án song song trên đám mây

Bạn

Tổng chỉ huy

  • Giao việc bằng prompt
  • Đọc nhật ký, trả lời câu hỏi
  • Chốt số liệu, chọn phương án
  • Chịu trách nhiệm cuối cùng

Claude Code

Kỹ sư hồ sơ

  • Đọc hồ sơ, điền dữ liệu
  • Tra luật, quy chuẩn
  • Lập đề bài PCCC
  • Thẩm tra bản vẽ, viết công cụ kiểm tra

Sơ đồ điều phối

Đây là hình ảnh cần nhớ nhất của cả giáo trình. Hai AI làm việc ở hai làn riêng. Mọi thứ đi qua làn giữa, nơi chứa dữ liệu và bản vẽ.

Sơ đồ làn điều phối Ba làn: Codex ở trên, thư mục chung ở giữa, Claude Code ở dưới. Sáu bước: Claude dựng dữ liệu, Claude lập đề bài PCCC, Codex vẽ mặt bằng, Claude thẩm tra, Codex sửa bản vẽ, Claude chốt hồ sơ. Mỗi bước ghi kết quả vào làn giữa. Codex vẽ, dựng hình Thư mục chung nguồn sự thật Claude Code pháp lý, thẩm tra du-an.jsonhang-muc.csv 1 Dựng dữ liệu yeu-cau-pccc.json 2 Đề bài PCCC mat-bang-v1.svg 3 Vẽ mặt bằng NHAT-KY:ds lỗi 4 Thẩm tra mat-bang-v2.svg 5 Sửa bản vẽ thuyết minh+ checklist 6 Chốt hồ sơ ↻ lặp bước 4–5 tới khi hết lỗi
Không có đường nối thẳng Codex với Claude: mọi trao đổi đều đi qua file trong thư mục chung.

Phân vai không cố định, nguyên tắc thì cố định

Bảng vai trò dựa trên trải nghiệm của bạn. Nếu sau vài vòng thấy bên nào làm một việc tốt hơn, cứ đổi. Chỉ giữ một điều: bên vẽ và bên thẩm tra phải là hai bên khác nhau. Trong kiểm soát chất lượng, đây là nguyên tắc "người làm, người kiểm".

Bài tập 1

Liệt kê 10 đầu việc của dự án Jotun. Gán mỗi việc cho Codex, Claude Code hoặc chính bạn. Việc nào cần cả hai, tách thành "phần làm" và "phần kiểm".

2

Một thư mục, một nguồn sự thật

Dựng nền dữ liệu chung để hai AI không bao giờ dùng hai con số khác nhau.

40 phútKết quả: hiểu cấu trúc bộ khung

Lỗi phổ biến nhất khi dùng hai AI: mỗi bên giữ một bản số liệu riêng trong cuộc chat của mình. Sau ba vòng sửa, bản vẽ ghi kho dung môi 1.200 m², thuyết minh ghi 1.500 m², và không ai biết số nào đúng. Cách chữa duy nhất là đưa dữ liệu ra khỏi chat, đặt vào file trong một thư mục mà cả hai cùng đọc. Thư mục này quản lý bằng Git, đưa lên một repo private trên GitHub.

Thư mục dự án và ai được sửa gì

jotun-du-an/
AGENTS.mdbộ luật chungCả hai đọc
CLAUDE.mdtrỏ sang AGENTS.mdClaude đọc
NHAT-KY.mdsổ giao caCả hai ghi thêm
data/nguồn sự thật duy nhấtBạn duyệt
du-an.jsonđất, quy hoạch, công suấtClaude điền
hang-muc.csvhạng mục HM-xxClaude điền
phap-ly.jsonthủ tục TT-xxClaude
yeu-cau-pccc.jsonđề bài PCCC YC-xxClaude
docs/phap-ly/nguon/ hồ sơ gốc, ban-thao/ văn bản soạnClaude
design/2d, 3d, pcccCodex
web/web theo dõi quy trìnhCodex
prompts/9 prompt mẫuBạn dùng
tools/kiem-tra.pymáy kiểm tra số liệuCả hai chạy

Năm luật dữ liệu

Một con số, một chỗ

Số chỉ nằm trong data/. Bản vẽ và văn bản đọc từ đó, không gõ tay.

Mỗi thứ một mã

HM-02 là kho dung môi ở mọi nơi: nhãn bản vẽ, thuyết minh, web. So mã là biết có khớp.

Chưa có thì để trống

Ô trống trung thực hơn một con số đẹp do AI tự nghĩ ra. Số giả định phải ghi "GIẢ ĐỊNH".

Số nào cũng có nguồn

Cột nguon ghi số lấy từ tài liệu nào. Thiếu nguồn, máy kiểm tra báo lỗi.

Đổi số, tăng phiên bản

Sửa data/ thì tăng phien_ban. Bản vẽ ghi rõ dùng dữ liệu phiên bản nào.

Máy kiểm tra số liệu

Bộ khung có sẵn tools/kiem-tra.py. Bạn không cần biết lập trình, chỉ cần nhờ một trong hai AI chạy nó. Kết quả trông như sau:

python3 tools/kiem-tra.py
  Tổng diện tích xây dựng: 7,000 m2 — mật độ xây dựng: 70.0%

  LỖI       Mật độ xây dựng 70.0% vượt mức tối đa 60%
  LỖI       Có số liệu nhưng thiếu cột 'nguon': HM-01
  LỖI       yeu-cau-pccc.json YC-02: có giá trị nhưng không có căn cứ (nghi số tự nhớ)
  LỖI       design/2d/mat-bang-tong-the-v1.svg: có hạng mục không tồn tại trong data: HM-99
  CẢNH BÁO  13/14 hạng mục chưa có diện tích xây dựng

KẾT QUẢ: 4 LỖI, 1 cảnh báo — phải sửa LỖI trước khi kết thúc phiên.

Bài tập 2

Giải nén bộ khung, mở data/hang-muc.csv bằng Excel. Đối chiếu với Jotun thật: hạng mục nào thiếu, hạng mục nào thừa? Ghi ra giấy, chưa sửa. Ở bài 6 bạn sẽ giao việc này cho Claude Code.

3

Bộ luật chung cho hai AI

Viết một bộ luật duy nhất mà cả Codex lẫn Claude Code cùng tuân theo.

30 phútKết quả: AGENTS.md của riêng bạn

Mỗi công cụ tìm một file hướng dẫn riêng khi bắt đầu làm việc: Codex đọc AGENTS.md, Claude Code đọc CLAUDE.md. Viết hai file riêng thì sớm muộn chúng sẽ lệch nhau. Giải pháp là nối hai file làm một.

Codex đọc AGENTS.md trực tiếp; Claude Code đọc CLAUDE.md, file này nhập AGENTS.md bằng dòng @AGENTS.md Codex Claude Code CLAUDE.md @AGENTS.md + dặn riêng AGENTS.md mục tiêu, phân công, luật dữ liệu, giao ca một bộ luật duy nhất đọc trực tiếp nhập nguyên văn
Sửa AGENTS.md một lần, cả hai AI cùng nhận luật mới.

Khi một repo có cả hai file, Claude Code theo CLAUDE.md và bỏ qua AGENTS.md, còn Codex thì ngược lại. Từ bản 2.1.277 (18/9/2026), Claude Code tự đọc AGENTS.md nếu không có CLAUDE.md. Vì bạn muốn dặn riêng Claude vài điều, cách gọn nhất là để CLAUDE.md nhập AGENTS.md bằng một dòng. Lần đầu Claude Code hỏi có cho phép không, bạn chỉ cần đồng ý một lần.

CLAUDE.md
@AGENTS.md

## Riêng cho Claude Code
- Khi thẩm tra bản vẽ: ghi lỗi vào NHAT-KY.md, KHÔNG tự sửa file trong design/.
- Mỗi con số điền vào data/ phải có nguồn.
- Viện dẫn văn bản pháp luật: ghi số hiệu + điều/khoản, chưa chắc hiệu lực thì gắn [CẦN KIỂM TRA].

AGENTS.md cần có sáu phần

Mục tiêu dự án

3–5 dòng, AI hiểu đang làm gì và cho ai.

Bảng phân công thư mục

Ai được sửa thư mục nào, bên kia chỉ được đọc.

Luật dữ liệu

Năm luật ở bài 2.

Quy ước file

Tên không dấu, có số phiên bản, SVG mang id="HM-xx".

Luật pháp lý

Luôn ghi căn cứ, gắn [CẦN KIỂM TRA] khi chưa chắc.

Giao ca

Đọc nhật ký trước khi làm, ghi nhật ký sau khi làm.

Giữ file này khoảng một trang, vì toàn bộ nội dung được nạp vào mỗi phiên làm việc. Chi tiết dự án để trong data/ và docs/. File đầy đủ có sẵn trong bộ khung.

Bài tập 3

Thêm một luật của riêng bạn vào AGENTS.md, ví dụ "Bản vẽ trình chủ đầu tư có logo dự án ở góc phải". Tự hỏi: luật này dành cho cả hai AI hay chỉ một bên? Nếu chỉ một bên, nó thuộc file nào?

4

Vòng lặp điều phối

Chạy một phiên làm việc đúng nhịp, viết prompt giao việc rõ ràng.

45 phútKết quả: prompt bảy phần đầu tiên

Bốn nhịp của mỗi phiên

Bốn nhịp: Lấy bản mới nhất, Giao một việc, Đọc nhật ký, Lưu và đẩy lên, rồi lặp lại với công cụ kia 1 Pull Lấy bản mới nhất từ GitHub 2 Giao việc Một prompt, một công cụ 3 Đọc nhật ký AI làm gì, giả định gì, hỏi gì 4 Push Commit, Push hoặc Merge PR rồi mới chuyển sang công cụ kia Không bao giờ để hai bên cùng sửa một file một lúc
Muốn chạy song song, chỉ khi hai bên làm ở hai thư mục khác hẳn nhau, ví dụ Codex trong web/, Claude trong docs/.

Sáu từ Git cần biết

Pull

Lấy bản mới nhất từ GitHub về máy.

Commit

Chụp một "ảnh lưu" các thay đổi. Quay lại được bất cứ lúc nào.

Push

Đẩy ảnh lưu lên GitHub cho bên kia thấy.

Branch

Bản nháp tách riêng, làm hỏng không ảnh hưởng bản chính.

Pull Request

Đề nghị gộp bản nháp vào bản chính, kèm danh sách thay đổi để duyệt.

Merge

Đồng ý gộp. Bản chính được cập nhật.

Giải phẫu một prompt giao việc

Prompt giống một phiếu giao việc trên công trường. Bảy phần dưới đây giúp AI ít phải đoán và bạn dễ kiểm.

1Bối cảnh
Đọc AGENTS.md và NHAT-KY.md trước.
2Đầu vào
Dùng file nào: data/hang-muc.csv, data/yeu-cau-pccc.json…
3Việc
Làm gì, ra sản phẩm gì, lưu ở đâu, tên file gì.
4Ràng buộc
Không được sửa gì, không được tự đoán gì.
5Khi thiếu
Thiếu số liệu thì dừng, ghi câu hỏi vào nhật ký, không bịa.
6Kiểm tra
Chạy python3 tools/kiem-tra.py, sửa hết LỖI.
7Giao ca
Ghi một mục vào NHAT-KY.md theo mẫu.

Cả hai công cụ đều hiểu tiếng Việt. Trong bộ khung, prompt cho Codex viết bằng tiếng Anh cho gọn và dặn nó trả lời bằng tiếng Việt; bạn viết tiếng Việt cũng được.

Bài tập 4

Viết một prompt bảy phần giao cho Codex: vẽ sơ đồ dây chuyền sản xuất sơn từ kho nguyên liệu tới kho thành phẩm, dùng mã HM-xx. Nếu Codex làm sai, phần nào trong prompt chưa đủ rõ?

5

PCCC: phần khó nhất

Biến yêu cầu PCCC thành dữ liệu có căn cứ, để bản vẽ được vẽ đúng và thẩm tra được bằng máy.

Một buổi trọnKết quả: đề bài PCCC cho nhà máy sơn

Vì sao PCCC khó với AI

Số liệu PCCC phụ thuộc nhau theo chuỗi. Sai một mắt xích đầu là sai cả chuỗi phía sau. AI lại rất dễ "nhớ" một con số nghe hợp lý nhưng sai, trong khi văn bản đã đổi lớn từ 01/7/2025. Và một mặt bằng vẽ đẹp vẫn có thể thiếu bãi quay xe chữa cháy.

Chuỗi phụ thuộc: hạng nguy hiểm cháy nổ quyết định bậc chịu lửa; bậc chịu lửa quyết định khoảng cách, khoang cháy, thoát nạn, chữa cháy tự động, nước chữa cháy; tất cả đi vào bản vẽ PCCC Hạng nguy hiểm cháy nổ YC-01, mắt xích đầu Bậc chịu lửa kết cấu, vật liệu Khoảng cách PCCCYC-02 Diện tích khoang cháyYC-05 Lối thoát nạnYC-04 Chữa cháy tự độngYC-07 Nước chữa cháy, bểYC-06 Bản vẽ PCCC
Claude trả lời từ trái sang giữa (các câu hỏi pháp lý). Codex chỉ làm ô cuối cùng.

Cách giải quyết: tách câu hỏi pháp lý khỏi việc vẽ

Claude trả lời câu hỏi pháp lý và ghi đáp án thành dữ liệu có căn cứ. Codex chỉ vẽ theo dữ liệu đó. Claude thẩm tra bản vẽ so với chính dữ liệu đó.

Khung pháp lý hiện hành

Tóm tắt tới ngày 06/11/2026. Đây là điểm khởi đầu để Claude tra cứu, không phải kết luận. Trước khi dùng cho hồ sơ thật, luôn đối chiếu văn bản gốc.

Thẩm định thiết kế PCCC với công trình thuộc diện phải thẩm định do cơ quan chuyên môn về xây dựng thực hiện, theo danh mục ở Phụ lục III của Nghị định 105/2025. Nội dung thẩm định gồm: khoảng cách PCCC giữa các công trình, đường và lối tiếp cận chữa cháy, lối thoát nạn, bậc chịu lửa và phân chia khoang cháy, giải pháp chống khói. Nhà xưởng, kho của dự án có thuộc diện hay không phải tra Phụ lục III. CẦN KIỂM TRA

Thói quen bắt buộc

Tải PDF các văn bản trên vào docs/phap-ly/nguon/. Yêu cầu Claude chỉ trích số liệu từ những file này, ghi rõ điều, khoản, bảng. Khi thấy văn bản mới thay thế, Claude phải báo bạn trong nhật ký.

Kỹ thuật trung tâm: đề bài PCCC dạng dữ liệu

File data/yeu-cau-pccc.json là cầu nối giữa pháp lý và bản vẽ. Mỗi yêu cầu là một dòng có mã, áp dụng cho hạng mục nào, giá trị bao nhiêu, căn cứ điều khoản nào, và trạng thái.

Một yêu cầu trong yeu-cau-pccc.json
{
  "ma": "YC-02",
  "nhom": "khoang-cach",
  "ap_dung": ["HM-02", "HM-01"],
  "noi_dung": "Khoảng cách phòng cháy tối thiểu giữa kho dung môi và xưởng sản xuất",
  "gia_tri": null,
  "don_vi": "m",
  "can_cu": null,
  "trang_thai": "chua_tra_cuu"
}

Mỗi yêu cầu đi qua vòng đời bốn trạng thái:

chua_tra_cuu→ da_tra_cuu→ dathoặckhong_dat

Codex không tự quyết số

Nó vẽ đường kích thước ghi "YC-02: … m" theo đúng giá trị Claude đã tra.

Máy bắt số không căn cứ

Yêu cầu có giá trị mà thiếu căn cứ, máy kiểm tra báo LỖI ngay.

Tái sử dụng được

Công trình khác dùng lại danh sách yêu cầu, chỉ tra lại giá trị theo quy mô.

Chuỗi tám bước thiết kế PCCC cho nhà xưởng

  1. 1

    Phân loại Claude

    Công trình có thuộc diện thẩm định thiết kế PCCC không; hạng nguy hiểm cháy nổ từng hạng mục. Ghi vào YC-01 và cột hang_nguy_hiem_chay_no.

  2. 2

    Bậc chịu lửa, khoang cháy Claude

    Từ bước 1, tra bậc chịu lửa, diện tích khoang cháy tối đa, số tầng tối đa.

  3. 3

    Đề bài mặt bằng Claude

    Khoảng cách giữa các hạng mục, đường xe chữa cháy, bãi quay xe, lối thoát nạn. Mọi yêu cầu chuyển sang da_tra_cuu.

  4. 4

    Vẽ mặt bằng PCCC Codex

    Vẽ theo đề bài, 1 đơn vị SVG = 1 mét, đường kích thước gắn mã YC.

  5. 5

    Thẩm tra mặt bằng Claude

    Đo trên bản vẽ, cập nhật dat hoặc khong_dat, ghi danh sách lỗi. Lặp bước 4–5 tới khi hết lỗi bắt buộc.

  6. 6

    Tính toán hệ thống Claude

    Báo cháy, chữa cháy vách tường, chữa cháy tự động (nước hay bọt cho khu dung môi), lưu lượng, dung tích bể. Tính bằng script, hệ số lấy từ văn bản gốc.

  7. 7

    Sơ đồ hệ thống, 3D Codex

    Sơ đồ nguyên lý, bố trí thiết bị trên mặt bằng, phối cảnh 3D để trình bày.

  8. 8

    Hồ sơ, rà soát chuyên môn ClaudeBạn + kỹ sư

    Claude lập thuyết minh, checklist hồ sơ thẩm định. Người có chuyên môn PCCC rà lại toàn bộ trước khi nộp.

Tính bằng script, không tính nhẩm

Với bước 6, đừng hỏi "bể nước cần bao nhiêu khối". Giao việc như dưới đây để mỗi hệ số đều truy được nguồn, và lần sau chỉ cần đổi đầu vào.

Dán vào Claude Code
Đọc AGENTS.md, NHAT-KY.md, data/hang-muc.csv và data/yeu-cau-pccc.json.
Viết tools/tinh-nuoc-chua-chay.py tính lưu lượng nước chữa cháy và dung tích bể dự trữ cho dự án.
- Mọi hệ số, lưu lượng định mức, thời gian chữa cháy phải lấy từ văn bản trong docs/phap-ly/nguon/, đặt thành hằng số ở đầu file, mỗi hằng số có chú thích số hiệu văn bản + điều/khoản/bảng.
- Không tìm thấy căn cứ cho một hệ số: để None và in cảnh báo, không tự điền.
- Đầu vào đọc từ data/, kết quả in ra từng bước tính và ghi vào YC-06 trong data/yeu-cau-pccc.json.
Chạy script, chạy python3 tools/kiem-tra.py, ghi nhật ký.

Năm bẫy thường gặp

AI tự nhớ số quy chuẩn

Dấu hiệu
Có giá trị, căn cứ chung chung "theo QCVN 06"
Cách chặn
Bắt ghi điều, khoản, bảng; máy kiểm tra báo lỗi

Dẫn văn bản hết hiệu lực

Dấu hiệu
Viện dẫn Nghị định 136/2020 hoặc thủ tục cũ
Cách chặn
Ghi danh sách văn bản đang dùng vào AGENTS.md

Bản vẽ sai tỷ lệ

Dấu hiệu
Đo trên hình không khớp số ghi
Cách chặn
Ép 1 đơn vị SVG = 1 m; Claude đo bằng script

Codex "sửa cho hợp lý"

Dấu hiệu
Bản vẽ đổi kích thước mà data/ không đổi
Cách chặn
Codex không sửa data/; xung đột ghi vào nhật ký

Bỏ sót hạng mục nguy hiểm

Dấu hiệu
Kho dung môi, kho chất thải nguy hại không có yêu cầu riêng
Cách chặn
Mọi hạng mục kho, sản xuất phải có ít nhất một YC

Bài tập 5

Tám yêu cầu mẫu trong data/yeu-cau-pccc.json đã đủ cho nhà máy sơn chưa? Nghĩ thêm ít nhất ba yêu cầu (gợi ý: thông gió chống tích tụ hơi dung môi, thiết bị điện phòng nổ, chống sét). Viết thành YC-09 đến YC-11 với gia_tri và can_cu để trống, rồi giao Claude tra cứu.

6

Thực hành trọn vòng với Jotun

Chạy một vòng dự án hoàn chỉnh, từ hồ sơ cũ tới bản vẽ PCCC đã thẩm tra.

Hai buổiKết quả: mặt bằng PCCC Jotun đã thẩm tra

Chuẩn bị một lần

  1. Giải nén bộ khung dự án Jotun.

  2. Cài GitHub Desktop, chọn Add local repository, trỏ vào thư mục vừa giải nén, Publish dưới dạng Private.

  3. Kết nối repo với Codex; mở thư mục trong Claude Code.

  4. Chép bản vẽ, tài liệu cũ vào _cu/; hồ sơ gốc và PDF văn bản pháp luật vào docs/phap-ly/nguon/. Commit, Push.

Tám lượt giao việc

Bản đầy đủ của từng prompt nằm trong thư mục prompts/ của bộ khung. Ba lượt quan trọng nhất có sẵn ngay bên dưới.

Codex
Claude Code
1
00 Đưa tài liệu cũ vàoSắp xếp file, trích bảng số liệuBạn: duyệt bảng, chốt khi có XUNG ĐỘT
2
01 Điền dữ liệudu-an.json, hang-muc.csv kèm nguồnBạn: cung cấp số còn thiếu
3
02 Pháp lý + đề bài PCCCphap-ly.json, yeu-cau-pccc.jsonBạn: kiểm tra căn cứ
03 Vẽ mặt bằng 2DTheo data/ và đề bài PCCCBạn: xem PNG, duyệt PR
4
5
04 Thẩm tra bản vẽĐo, cập nhật đạt/không đạtBạn: đọc danh sách lỗi
05 Sửa bản vẽTheo danh sách lỗi, ra v2Lặp 5 ↔ 6 tới khi hết lỗi bắt buộc
6
06 Sơ đồ PCCC + 3DGắn mã YC trên từng thiết bịSau đó Claude thẩm tra lại
7
07 Web theo dõi quy trìnhĐọc trực tiếp từ data/Bạn: mở web xem tiến độ
8
Lượt 3, dán vào Claude Code
Đọc AGENTS.md, NHAT-KY.md và data/. Dự án là nhà máy sản xuất sơn (có tồn chứa dung môi).
1. Rà soát data/phap-ly.json: thủ tục nào đúng, thiếu, thừa, cần gộp hay tách. Giữ mã TT-xx cũ.
2. Với từng thủ tục: điền co_quan, can_cu (số hiệu + điều/khoản), phu_thuoc; đổi trạng thái khi đã xác minh.
3. Hoàn thiện data/yeu-cau-pccc.json: tra văn bản gốc trong docs/phap-ly/nguon/, điền gia_tri, don_vi, can_cu, đổi trạng thái thành "da_tra_cuu". Không điền số theo trí nhớ. Thêm yêu cầu còn thiếu, mỗi yêu cầu gắn đúng mã HM-xx.
4. Soạn docs/phap-ly/ban-thao/lo-trinh-thu-tuc.md và yeu-cau-pccc-cho-ban-ve.md.
5. Tăng phien_ban, chạy python3 tools/kiem-tra.py, ghi nhật ký.
Lượt 4, dán vào Codex
Read AGENTS.md and NHAT-KY.md first and follow them strictly. Reply and label everything in Vietnamese.
Draw the site master plan as SVG at design/2d/mat-bang-tong-the-v1.svg (+ a .png copy).
- Take ALL dimensions from data/du-an.json and data/hang-muc.csv. Never invent numbers; if a value is empty, stop and write a question in NHAT-KY.md.
- 1 SVG unit = 1 metre (viewBox). Each building is an element with id="HM-xx" and label "HM-xx Tên".
- Satisfy every requirement in data/yeu-cau-pccc.json with trang_thai "da_tra_cuu". Draw required distances as dimension lines labelled with the YC code. Mark HM-01 and HM-02 in a hazard colour.
- Summary box: tổng diện tích xây dựng, mật độ xây dựng, phiên bản data đã dùng.
- Do not edit data/ or docs/. Run python3 tools/kiem-tra.py. Append a NHAT-KY.md entry.
Lượt 5, dán vào Claude Code
Đọc AGENTS.md và NHAT-KY.md. Thẩm tra design/2d/mat-bang-tong-the-v1.svg:
1. Chạy python3 tools/kiem-tra.py, ghi lại kết quả.
2. Đối chiếu với data/: diện tích, mật độ xây dựng, khoảng lùi.
3. Với từng YC trong data/yeu-cau-pccc.json: đo trên SVG (1 đơn vị = 1 m), cập nhật trạng thái "dat" hoặc "khong_dat". Viết script đo trong tools/ để dùng lại.
4. Ghi vào NHAT-KY.md danh sách lỗi: "Lỗi n — HM-xx: vấn đề — căn cứ — đề xuất sửa — bắt buộc/nên sửa".
5. KHÔNG sửa file trong design/. Giao việc sửa cho Codex trong bảng "Việc đang mở".

Bài tập 6

Chạy lượt 1 đến lượt 5 với dữ liệu thật của Jotun. Sau lượt 5, đếm: bao nhiêu lỗi là lỗi do dữ liệu, bao nhiêu do vẽ? Con số này cho biết bạn cần siết khâu nào.

7

Khi số liệu đổi, khi có sự cố

Xử lý thay đổi giữa chừng mà không làm vỡ sự thống nhất.

30 phútKết quả: phản xạ đúng khi có thay đổi

Một thay đổi lan ra như sóng

Ví dụ chủ đầu tư nâng kho dung môi HM-02 từ 1.200 m² lên 1.500 m². Thay đổi nhỏ ở tâm có thể lan tới cả hệ thống chữa cháy.

Thay đổi lan từ dữ liệu, ra văn bản pháp lý và đề bài PCCC, ra bản vẽ, cuối cùng là thẩm tra lại HM-02 1.500 m² 1 Claude sửa data/, tăng phiên bản 2 Claude dò hệ quả: mật độ, khoang cháy, nước 3 Claude sửa văn bản, liệt kê bản vẽ cần vẽ lại 4 Codex vẽ lại → Claude thẩm tra lại
Dữ liệu luôn đi trước, bản vẽ đi sau. Một thay đổi diện tích nhỏ có thể đẩy kho sang ngưỡng phải có chữa cháy tự động.

Xử lý sự cố

Bản vẽ và thuyết minh ghi hai số khác nhau

Ai đó đã gõ tay số. Chạy máy kiểm tra, tìm số trong data/, cho bên sai sửa theo data/. Nếu tái diễn, nhấn mạnh luật số 1 trong AGENTS.md.

Hai bên ghi đè lên nhau

Có người quên Pull. Trong GitHub Desktop mở History, tìm commit trước khi hỏng, bấm Revert. Từ nay luôn Pull đầu phiên.

Codex sửa vào thư mục của Claude (hoặc ngược lại)

Đừng Merge Pull Request đó. Yêu cầu bỏ phần sửa sai thư mục, hoặc tự Revert file đó. Thêm câu "Nếu nhiệm vụ đòi sửa thư mục của bên kia: DỪNG" vào prompt.

Claude đưa ra số PCCC nhưng không chỉ được điều khoản

Coi như chưa có số. Đổi trạng thái về chua_tra_cuu, bổ sung PDF văn bản vào docs/phap-ly/nguon/, giao lại.

Hết lượt dùng một công cụ giữa chừng

Mọi thứ đã nằm trong file và nhật ký nên không mất gì. Bên còn lượt có thể tạm làm phần của bên kia, nhưng việc thẩm tra phải chờ công cụ kia: người vẽ không tự chấm bài.

Bài tập 7

Giả lập tăng công suất nhà máy thêm 50%. Giao Claude dò hệ quả theo sơ đồ trên. So sánh danh sách bản vẽ phải vẽ lại mà Claude đưa ra với dự đoán của bạn.

8

Từ Jotun đến dịch vụ tư vấn PCCC

Biến cách làm của một dự án thành quy trình lặp lại được cho nhiều công trình trên cả nước.

45 phútKết quả: viên gạch đầu của thư viện PCCC

Điều kiện kinh doanh: một tin quan trọng

Không còn là ngành nghề kinh doanh có điều kiện

Theo Bộ Công an, từ khi Luật 55/2024/QH15 có hiệu lực (01/7/2025), các ngành nghề liên quan PCCC, gồm cả tư vấn thiết kế PCCC, không còn là ngành nghề kinh doanh có điều kiện, và cá nhân không còn phải có chứng chỉ hành nghề tư vấn PCCC. Hồ sơ thiết kế vẫn phải qua thẩm định và nghiệm thu theo Luật và Nghị định 105/2025/NĐ-CP.

Cần kiểm tra trước khi mở dịch vụ

Tư vấn thiết kế xây dựng nói chung vẫn có thể chịu yêu cầu năng lực theo pháp luật xây dựng, và danh mục ngành nghề có điều kiện đang được rà soát. Giao Claude tra riêng chủ đề này, rồi xác nhận với luật sư hoặc cơ quan quản lý trước khi ký hợp đồng đầu tiên. CẦN KIỂM TRA

Năm việc để biến dự án thành dịch vụ

Biến bộ khung thành khuôn mẫu

Sau Jotun, xóa số liệu riêng, giữ cấu trúc, luật, prompt, công cụ. Công trình mới bắt đầu bằng một bản sao.

Thư viện đề bài PCCC

Mỗi loại công trình một file: nhà xưởng, kho hàng, kho hóa chất, xưởng cho thuê trong KCN, chung cư… Có sẵn căn cứ, chỉ tra lại giá trị.

Đóng gói thành skill

Cả hai công cụ cho phép đóng gói quy trình lặp lại thành "skill". Ứng viên đầu: "thẩm tra mặt bằng PCCC", "lập đề bài PCCC nhà xưởng".

Theo dõi văn bản mới

Hằng tháng Claude rà văn bản PCCC, xây dựng, hóa chất mới, báo yêu cầu nào trong thư viện bị ảnh hưởng.

Ranh giới trách nhiệm

AI lập đề bài, vẽ, thẩm tra sơ bộ. Kỹ sư PCCC rà lại và chịu trách nhiệm hồ sơ nộp. Ghi rõ vào hợp đồng.

Quy trình nhận một công trình mới

Việc
N1
N2
N3
N4
N5
N6
N7
N8
N9
N10
Sao khuôn mẫu, điền data/Claude Code
Tra đề bài, xác định diện thẩm địnhClaude Code
Vẽ, thẩm tra, sửa mặt bằngCodex ↔ Claude
Tính hệ thống, sơ đồ, 3DCả hai
Thuyết minh, rà chuyên môn, giao kháchBạn + kỹ sư

Đây là mục tiêu tham khảo cho nhà xưởng cỡ vừa khi khuôn mẫu đã ổn định, không phải cam kết.

Bài tập 8

Chọn một loại công trình khác Jotun mà bạn muốn nhận đầu tiên (ví dụ nhà xưởng cho thuê trong KCN). Giao Claude lập file đề bài PCCC mẫu cho loại đó, mọi giá trị để trống, chỉ có danh sách yêu cầu và căn cứ.

9

Bộ công cụ mở rộng

Thêm đúng công cụ vào đúng khâu, để Codex và Claude làm việc trên bản vẽ thật, số liệu được kiểm chứng nhiều lớp, và nhiều dự án chạy cùng lúc.

45 phútKết quả: lộ trình đưa công cụ vào dịch vụ của bạn

Codex và Claude Code là lõi. Các công cụ dưới đây không thay thế lõi, mà gắn vào quanh nó. Nguyên tắc vẫn như cũ: mọi công cụ đọc và ghi qua thư mục chung, và bên làm khác bên kiểm.

Bản đồ công cụ theo khâu

Vẽ và mô hìnhBản vẽ thật, không chỉ SVG
Revit 2027 + MCP

Bản Revit đầu tiên có sẵn máy chủ MCP chính thức, kèm trợ lý Autodesk Assistant (đang thử nghiệm). AI đọc được trực tiếp mô hình BIM đang mở.

Phần mềm kỹ thuật
Revit MCP Server mã nguồn mở

Autodesk công bố 18/6/2026: 102 công cụ đọc và sửa tường, sàn, cửa, lưới… Claude Code nối vào để đo và thẩm tra.

Mã nguồn mởCầu nối AI
Mô phỏng và tính toánChứng minh giải pháp
PyroSim + Pathfinder

Mô phỏng cháy, khói và thoát nạn (hãng Thunderhead). Ghép được kết quả khói vào mô phỏng di chuyển của người.

Phần mềm kỹ thuật
Phần mềm thiết kế sprinkler

Nhóm như AutoSPRINK, HydraCAD: bố trí đầu phun và tính thủy lực. Phần này không để AI tính tay.

Phần mềm kỹ thuật
Quản lý và trình bàyNhiều công trình cùng lúc
Notion

Bảng theo dõi công trình, thủ tục TT-xx, hạn nộp. Claude cập nhật thẳng vào bảng sau mỗi phiên.

Đã kết nốiCó bản miễn phí
Google Sheets

Bảng tính dự toán, khối lượng thiết bị PCCC, chia sẻ với chủ đầu tư.

Đã kết nốiMiễn phí
ArchiVinci, Autodesk Forma

Biến mặt bằng ý tưởng thành phối cảnh đẹp khi chào hàng. Chỉ dùng để trình bày, không dùng cho hồ sơ nộp.

AI

Kiểm chứng ba lớp cho số liệu PCCC

Ở bài 5, Claude tra số và ghi căn cứ. Thêm hai lớp kiểm độc lập, một con số chỉ được coi là chắc khi qua cả ba.

Kiểm chứng ba lớp: Claude tra số và căn cứ, NotebookLM đối chiếu với PDF gốc, AI pháp luật LuatVietnam kiểm hiệu lực; qua đủ ba lớp thì yêu cầu được chuyển sang da_tra_cuu; lệch ở bất kỳ lớp nào thì quay về chua_tra_cuu 1 Claude Code Tra số trong PDF gốc, ghi giá trị + điều khoản 2 NotebookLM Hỏi lại trên cùng PDF, so số và đoạn trích 3 LuatVietnam AI Văn bản còn hiệu lực? Có bị thay thế không? da_tra_cuu qua đủ 3 lớp khớpkhớphợp lệ Lệch số hoặc văn bản hết hiệu lực → trả về chua_tra_cuu, ghi nhật ký, Claude tra lại Ba nguồn độc lập: không lớp nào tự xác nhận kết quả của chính mình.
Lớp 2 và 3 do bạn chạy, mất khoảng 10–15 phút cho một bộ đề bài. Kết quả ghi vào nhật ký để lần sau không phải kiểm lại.
Bước chuẩn bị, dán vào Claude Code
Đọc AGENTS.md và data/yeu-cau-pccc.json. Với mỗi yêu cầu có trạng thái "da_tra_cuu", soạn một câu hỏi kiểm chứng để tôi dán vào NotebookLM, lưu ở docs/phap-ly/ban-thao/kiem-cheo-yc.md.
Mỗi câu hỏi theo mẫu: "Theo các tài liệu đã tải lên, [nội dung yêu cầu] cho [loại công trình, hạng nguy hiểm, bậc chịu lửa] là bao nhiêu? Trích nguyên văn điều/khoản/bảng."
Dưới mỗi câu hỏi để trống ba dòng: "NotebookLM trả lời:", "Khớp với Claude (có/không):", "Hiệu lực văn bản (LuatVietnam):".
Ghi nhật ký.
Sau khi kiểm xong, dán vào Claude Code
Tôi đã điền kết quả kiểm chứng vào docs/phap-ly/ban-thao/kiem-cheo-yc.md. Đọc file đó:
- Yêu cầu nào "Khớp: không" hoặc văn bản hết hiệu lực: đổi trạng thái về "chua_tra_cuu" trong data/yeu-cau-pccc.json, ghi rõ lý do vào ghi_chu, tra lại.
- Yêu cầu nào qua đủ ba lớp: thêm vào ghi_chu "Đã kiểm chứng 3 lớp ngày YYYY-MM-DD".
Tăng phien_ban, chạy python3 tools/kiem-tra.py, ghi nhật ký.

Claude làm việc trên bản vẽ Revit thật

Khi nhận công trình thật, bản vẽ nằm trong Revit hoặc AutoCAD chứ không còn là SVG. Qua MCP, Claude Code đọc thẳng mô hình đang mở: đo khoảng cách, đếm lối thoát nạn, liệt kê cửa chống cháy, rồi đối chiếu với đề bài PCCC. Vai "Claude thẩm tra" ở bài 1 khi đó chạy trên bản vẽ thật.

Mô hình Revit nối qua máy chủ MCP tới Claude Code; Claude đối chiếu với yeu-cau-pccc.json và ghi kết quả vào nhật ký; việc sửa mô hình vẫn do người dựng hình làm Mô hình Revit tường, cửa, sàn, phòng, lối thoát Máy chủ MCP cầu nối, chỉ đọc Claude Code đo, đếm, đối chiếu với đề bài PCCC yeu-cau-pccc.json dat / khong_dat NHAT-KY.md danh sách lỗi HM-xx Mới đầu chỉ cho phép đọc. Việc sửa mô hình vẫn do người dựng hình làm, để giữ nguyên tắc người làm khác người kiểm.
Đây là hướng mới, chưa phổ biến. Thử trên một công trình nhỏ trước, và kiểm tra bảo mật trước khi nối vào mô hình của khách hàng.
Ví dụ giao việc khi đã nối Revit, dán vào Claude Code
Đọc AGENTS.md và data/yeu-cau-pccc.json. Dùng công cụ Revit MCP ở chế độ chỉ đọc, KHÔNG sửa mô hình.
1. Liệt kê các phòng và khối nhà, ánh xạ sang mã HM-xx trong data/hang-muc.csv; phần không khớp ghi thành câu hỏi.
2. Với từng YC nhóm "khoang-cach" và "thoat-nan": đo trên mô hình, so với gia_tri, cập nhật "dat" hoặc "khong_dat".
3. Ghi danh sách lỗi vào NHAT-KY.md theo mẫu "Lỗi n — HM-xx: vấn đề — căn cứ — đề xuất sửa".
Chạy python3 tools/kiem-tra.py, ghi nhật ký.

Một bảng Notion cho mọi công trình

Khi làm dịch vụ, bạn sẽ có nhiều thư mục dự án cùng lúc. Mỗi thư mục vẫn là nguồn sự thật của công trình đó. Notion chỉ là bảng tổng hợp để bạn nhìn toàn cảnh: công trình nào đang ở bước nào, thủ tục nào sắp tới hạn.

Dán vào Claude (đã kết nối Notion)
Tạo trong Notion một database "Công trình PCCC" với các cột: Tên công trình, Chủ đầu tư, Loại công trình, Địa điểm, Bước hiện tại (1–8 theo chuỗi PCCC), Số YC đạt / tổng, Thủ tục kế tiếp, Hạn, Người phụ trách, Link repo.
Thêm dòng đầu tiên cho dự án Jotun, lấy số liệu từ data/ và NHAT-KY.md của repo jotun-du-an.
Từ nay, cuối mỗi phiên làm việc trên một repo dự án, cập nhật dòng tương ứng trong database này.

Lộ trình đưa công cụ vào

  1. 1Ngay tuần này
    NotebookLM

    Miễn phí. Tải PDF QCVN 06, TCVN 3890, Nghị định 105 vào và chạy kiểm chứng ba lớp cho bài 5.

  2. 2Tuần sau
    Bảng Notion

    Dựng bảng theo dõi, nhập Jotun làm dòng đầu.

  3. 3Công trình thật đầu tiên
    Revit + MCP

    Nối ở chế độ chỉ đọc, để Claude thẩm tra trên mô hình thật.

  4. 4Khi đã có khách
    PyroSim, Pathfinder, sprinkler

    Khoản đầu tư lớn: hỏi giá, dùng thử, chọn theo loại công trình bạn nhận nhiều nhất.

Bài tập 9

Tạo một notebook trong NotebookLM tên "PCCC nhà xưởng", tải ba văn bản gốc vào. Chọn YC-02 (khoảng cách kho dung môi và xưởng): hỏi Claude, hỏi NotebookLM, rồi kiểm hiệu lực trên LuatVietnam. Ba nguồn có khớp nhau không? Nếu không, lớp nào sai và vì sao?

+

Phụ lục

Tra nhanh khi đang làm việc.

Checklist mỗi phiên

Checklist
[ ] Pull bản mới nhất
[ ] Đọc mục mới nhất trong NHAT-KY.md
[ ] Chọn đúng prompt, dán đúng công cụ
[ ] AI đã chạy python3 tools/kiem-tra.py, không còn LỖI
[ ] AI đã ghi nhật ký; mình đã đọc câu hỏi của nó
[ ] Commit + Push (hoặc duyệt và Merge Pull Request)
[ ] Cập nhật bảng "Việc đang mở"

Ba luật vàng

Số liệu chỉ sửa trong data/

Codex vẽ, Claude thẩm tra

Người vẽ không tự chấm bài.

PCCC phải có điều khoản gốc

Không có căn cứ là chưa có đề bài.

Nguồn tham khảo

Khung pháp lý và tính năng công cụ có thể đã thay đổi sau ngày cập nhật. Luôn đối chiếu bản gốc.

Cài lên iPhone để học offline

Giáo trình chạy như một ứng dụng riêng, có biểu tượng trên màn hình chính, mở được cả khi không có mạng.

Đang kiểm tra…
Mở link giáo trình bằng Safari, bấm nút Chia sẻ ở thanh dưới.
Kéo xuống, chọn Thêm vào MH chính, rồi bấm Thêm.
Mở biểu tượng mới một lần khi đang có mạng để máy lưu toàn bộ nội dung. Từ đó học được cả khi offline.

Mấy điều nên biết

Ứng dụng trên màn hình chính có bộ nhớ riêng, nên tiến độ đánh dấu ở Safari không tự chuyển sang; bạn đánh dấu lại trong ứng dụng là được. Khi giáo trình có bản mới, chỉ cần mở ứng dụng lúc có mạng là tự cập nhật. Bộ khung dự án (.zip) cũng được lưu sẵn để tải lại khi offline.