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.
Lộ trình học
Học theo thứ tự. Bài 5 và bài 10 là phần PCCC, mỗi bài dành riêng một buổi.
- 1Buổi 1Hai người thợ, một tổng chỉ huyPhân vai Codex, Claude và bạn
- 2Buổi 1Một thư mục, một nguồn sự thậtDữ liệu chung không lệch số
- 3Buổi 2Bộ luật chung cho hai AIAGENTS.md và CLAUDE.md
- 4Buổi 2Vòng lặp điều phốiBốn nhịp mỗi phiên, prompt bảy phần
- 5Buổi 3PCCC: phần khó nhấtĐề bài PCCC dạng dữ liệu
- 6Buổi 4–5Thực hành trọn vòng với JotunTám lượt giao việc
- 7Buổi 6Khi số liệu đổi, khi có sự cốĐổi số không vỡ thống nhất
- 8Buổi 6Từ Jotun đến dịch vụ PCCCNhân rộng thành quy trình
- 9Buổi 7Bộ công cụ mở rộngRevit MCP, NotebookLM, PyroSim, Notion
- 10Buổi 8PCCC bản 2: đủ để vận hànhCông cụ đo, cổng kỹ sư ký, hồ sơ nộp
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.
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ẽ.
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".
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.
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ì
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:
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.
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.
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.
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.
@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?
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.
Bốn nhịp của mỗi phiên
web/, Claude trong docs/.Sáu từ Git cần biết
Lấy bản mới nhất từ GitHub về máy.
Chụp một "ảnh lưu" các thay đổi. Quay lại được bất cứ lúc nào.
Đẩy ảnh lưu lên GitHub cho bên kia thấy.
Bản nháp tách riêng, làm hỏng không ảnh hưởng bản chính.
Đề nghị gộp bản nháp vào bản chính, kèm danh sách thay đổi để duyệt.
Đồ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.
data/hang-muc.csv, data/yeu-cau-pccc.json…python3 tools/kiem-tra.py, sửa hết LỖI.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õ?
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.
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.
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.
Luật PCCC và CNCH số 55/2024/QH15
Ban hành 29/11/2024. Khung pháp lý mới cho toàn bộ lĩnh vực.
Hiệu lực 01/7/2025Nghị định 105/2025/NĐ-CP
Hướng dẫn Luật, bãi bỏ Nghị định 136/2020/NĐ-CP. Đi kèm Thông tư 36/2025/TT-BCA. CẦN KIỂM TRA
Áp dụng từ 01/7/2025QCVN 06:2022/BXD + SĐ1:2023
An toàn cháy cho nhà và công trình (SĐ1 ban hành kèm Thông tư 09/2023/TT-BXD). Cùng TCVN 3890:2023 về phương tiện PCCC.
QCVN 05A:2020/BCT + SĐ1:2024
An toàn trong sản xuất, sử dụng, bảo quản hóa chất nguy hiểm. Quan trọng với nhà máy sơn có dung môi.
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.
{
"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:
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ô.
Bài 5 là nền; bài 10 là bản vận hành
Ở bài này bạn học khái niệm "đề bài PCCC dạng dữ liệu". Bộ khung đi kèm giáo trình đã là bản 2: đề bài có tham số và phụ thuộc, có công cụ đo thật, có cổng kỹ sư ký. Học xong bài 5, hãy đọc bài 10 trước khi làm công trình thật.
Chuỗi tám bước thiết kế PCCC cho nhà xưởng
- 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
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
Đề 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
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
Thẩm tra mặt bằng Claude
Đo trên bản vẽ, cập nhật
dathoặckhong_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
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
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
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.
Đọ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.
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.
Chuẩn bị một lần
Giải nén bộ khung dự án Jotun.
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.
Kết nối repo với Codex; mở thư mục trong Claude Code.
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àodocs/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.
Đọ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ý.
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.
Đọ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.
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.
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.
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.
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.
Đ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
Đâ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ứ.
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.
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
NotebookLM
Tải PDF văn bản gốc vào rồi hỏi. Mọi câu trả lời trích đúng đoạn trong tài liệu bạn đưa vào.
AI pháp luật LuatVietnam
Hỏi đáp kèm căn cứ, có cảnh báo hiệu lực văn bản: đúng chỗ AI thông thường hay sai.
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ở.
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.
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 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.
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.
Google Sheets
Bảng tính dự toán, khối lượng thiết bị PCCC, chia sẻ với chủ đầu tư.
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.
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.
Đọ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ý.
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.
Đọ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.
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
- 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.
- 2Tuần sau
Bảng Notion
Dựng bảng theo dõi, nhập Jotun làm dòng đầu.
- 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.
- 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?
PCCC bản 2: đủ để vận hành
Rà lại quy trình PCCC của bài 5 với con mắt của người sắp nhận công trình thật, vá bốn lỗ hổng chặn, và đưa kỹ sư vào vòng với tư cách người ký.
Kết luận rà soát thẳng thắn
Thiết kế ở bài 5 đủ để học và làm giai đoạn ý tưởng cho một dự án. Đem đi làm dịch vụ cả nước thì chưa đủ: khâu thẩm tra chưa có công cụ đo, máy tính chưa tồn tại, chưa có ai ký, và dữ liệu "một con số" không mô tả được quy chuẩn. Bài này sửa cả bốn, và bộ khung đi kèm giáo trình từ nay là bản 2.
Bốn lỗ hổng chặn và cách vá
1. Thẩm tra bằng mắt
Bài 5 nói "Claude đo trên SVG" nhưng không có công cụ nào đo. Đó là bẫy "AI tự nhớ số" áp vào hình học. Vá: tools/do-ban-ve.py đo khoảng cách giữa các khối, chiều rộng đường xe chữa cháy, bãi quay, số lối ra, khoảng cách thoát nạn; tự đối chiếu với đề bài và ghi đạt/không đạt.
2. Máy tính chưa có bài kiểm
Máy tính không có bài toán mẫu thì không khác AI tính nhẩm. Vá: tools/tinh-cap-nuoc.py chỉ chạy khi mọi hằng số có căn cứ, và test_tinh_cap_nuoc.py từ chối cho dùng vào hồ sơ nộp khi chưa qua hai bài toán thật.
3. Chưa có cổng con người
Hai bên làm-kiểm đều là AI. Vá: data/ky-duyet.json liệt kê bảy quyết định AI không được tự quyết; kỹ sư ghi tên, ngày, kết luận. kiem-tra.py --nop chặn xuất hồ sơ khi thiếu một chữ ký.
4. Dữ liệu một con số
Khoảng cách PCCC là hàm của bậc, hạng, sprinkler; khoang cháy là hàm của bậc, hạng, số tầng. Vá: thư mục bang-tra/ chứa bảng tra chép từ PDF gốc có nguồn từng dòng; mỗi yêu cầu có tham_so và phu_thuoc; tra-bang.py điền giá trị và căn cứ tự động.
Kiến trúc bản 2
Mọi thứ vẫn đi qua thư mục chung, nhưng giữa đề bài và bản vẽ giờ có công cụ, và trước hồ sơ nộp có kỹ sư.
Bảy quyết định AI không được quyết
AI đề xuất kèm căn cứ vào nhật ký dưới tiêu đề "Đề xuất cho kỹ sư". Kỹ sư mở văn bản gốc, kết luận, ghi vào ky-duyet.json. Máy kiểm tra đọc file đó: hạng mục đã có hạng nguy hiểm mà QD-01 chưa ký thì báo ngay.
| Mã | Quyết định | Vì sao không giao AI |
|---|---|---|
| QD-01 | Hạng nguy hiểm cháy nổ từng hạng mục | Mắt xích đầu của cả chuỗi; sai một là sai hết |
| QD-02 | Bậc chịu lửa (kể cả kết luận về thép không bọc) | Cần xem kết cấu thật, tính Am/V |
| QD-03 | Có chữa cháy tự động không; nước, bọt hay khí | Dung môi không mặc định chữa bằng nước |
| QD-04 | Phân vùng nguy hiểm nổ, cấp thiết bị điện | Chuyên môn hóa chất và điện |
| QD-05 | Giải pháp thay thế, điều khoản chuyển tiếp | Vướng mắc số 1 khi thẩm định là chuyển tiếp quy chuẩn |
| QD-06 | Thuộc / không thuộc diện thẩm định, cơ quan nào | Quyết định cả bộ sản phẩm phải làm |
| QD-07 | Cho phép xuất hồ sơ nộp | Chữ ký cuối, trách nhiệm pháp lý |
Ai ký — trả lời trước hợp đồng đầu tiên
Tư vấn PCCC không còn là ngành nghề có điều kiện, nhưng thiết kế hệ thống PCCC là một phần của thiết kế xây dựng, vẫn theo Luật Xây dựng và Nghị định 175/2024/NĐ-CP: tổ chức cần chứng chỉ năng lực hoạt động xây dựng, chủ trì cần chứng chỉ hành nghề. CẦN KIỂM TRA Ghi tên người và số chứng chỉ vào ky-duyet.json: nguoi_chiu_trach_nhiem; chế độ --nop không mở nếu trống.
Chuỗi phụ thuộc và trạng thái "cần tra lại"
Mỗi yêu cầu khai phu_thuoc. Máy kiểm tra làm hai việc: không cho tra yêu cầu sau khi yêu cầu trước còn trống, và khi yêu cầu trước đổi (ngày cập nhật mới hơn) thì báo yêu cầu sau phải chuyển sang can_tra_lai.
Chạy thử thật: cổng có chặn không?
Dưới đây là kết quả chạy trên một dự án giả: AI tự điền hạng A và bậc IV, bảng tra giả cho khoảng cách 15 m, Codex vẽ kho dung môi cách xưởng 12 m, kho thành phẩm 6.000 m² khung thép không sprinkler.
$ python3 tools/tra-bang.py --ghi TRA ĐƯỢC YC-04: 15.0 m — QCVN 06:2022/BXD Bảng E.1 (GIẢ) (2022+SĐ1:2023) $ python3 tools/do-ban-ve.py design/2d/mat-bang-tong-the-v1.svg --ghi YC-04 [khoang-cach-hm] yêu cầu 15.0 m — đo 12.0 → KHÔNG ĐẠT (HM-02↔HM-01=12.0) $ python3 tools/kiem-tra.py CẢNH BÁO hang-muc.csv đã có hạng nguy hiểm cháy nổ nhưng QD-01 chưa được kỹ sư xác nhận — AI không được quyết hạng CẢNH BÁO YC-04: KHÔNG ĐẠT (đo 12.0 so với yêu cầu 15.0) — xem NHAT-KY.md CẢNH BÁO YC-02: phụ thuộc YC-01 đã cập nhật (2026-11-06) sau YC-02 (2026-11-01) → đổi YC-02 sang 'can_tra_lai' CẢNH BÁO LT-04: HM-04 khung thép bậc IV diện tích 6,000 m2 vượt ngưỡng khoang cháy 2,600 m2 (sprinkler=khong) CẢNH BÁO LT-13: HM-01 kết cấu thép không bọc đã gán bậc IV — hồ sơ cần bản tính Am/V (HS-12 chưa có) CẢNH BÁO LT-14: HM-01 bao che bằng tôn — cần thuyết minh E15 (YC-11 chưa tra) $ python3 tools/kiem-tra.py --nop LỖI CỔNG KÝ: QD-01 chưa có kỹ sư xác nhận (ky-duyet.json) LỖI HỒ SƠ: YC-04 KHÔNG ĐẠT — không nộp hồ sơ có yêu cầu không đạt … KẾT QUẢ (XUẤT HỒ SƠ): 52 LỖI — KHÔNG ĐƯỢC XUẤT HỒ SƠ. (sau khi kỹ sư ký đủ 7 QD, bản vẽ sửa về 16 m, hồ sơ đủ) $ python3 tools/kiem-tra.py --nop KẾT QUẢ (XUẤT HỒ SƠ): không có lỗi (6 cảnh báo).
Ba điều đáng chú ý: lỗi 3 m trên bản vẽ bị bắt bằng số đo chứ không bằng mắt; kho 6.000 m² bị bắt bởi thư viện lỗi chứ không phải bởi ai nhớ ra; và không một lỗi nào trong số đó cho phép xuất hồ sơ cho tới khi kỹ sư ký.
Chín bổ sung còn lại trong bộ khung bản 2
Tham số PCCC trong hang-muc.csv
Chiều cao PCCC, khối tích, số người, kết cấu, vật liệu bao che, tầng hầm, sprinkler.
17 nhóm yêu cầu, 27 YC
Thêm ngăn cháy lan, điện PCCC, liên động, biển báo, vật liệu, và nhóm hóa chất riêng cho dung môi.
Bước 0: diện thẩm định
dien-tham-dinh.json: cây câu hỏi dẫn tới một trong ba kết luận, kỹ sư ký QD-06.
Danh mục hồ sơ nộp
ho-so-tham-dinh.json: 15 tài liệu, ai làm, cần ký không, trỏ file thật.
Địa phương hóa
dia-phuong.json: tỉnh theo đơn vị hành chính mới, cơ quan, biểu mẫu, hạ tầng nước của KCN, kinh nghiệm địa phương.
Khung pháp lý chốt
Trong du-an.json: 8 văn bản, phiên bản, file gốc, ngày chốt. Căn cứ nào ngoài khung bị cảnh báo.
DXF thay SVG cho hồ sơ
Quy ước lớp và BLOCK trong AGENTS.md; thư viện ký hiệu dùng lại cho mọi công trình.
Giai đoạn sau thiết kế
giai_doan_hien_tai đi tới thi công, nghiệm thu, vận hành: hồ sơ quản lý PCCC cơ sở là nguồn thu lặp lại.
Thư viện lỗi trả hồ sơ
21 mục từ hướng dẫn Công an Bắc Giang; ba mục đã thành luật tự động trong máy kiểm tra.
Thứ tự prompt bản 2
Có 15 prompt. Thứ tự đầy đủ nằm trong BAT-DAU-TAI-DAY.md của bộ khung; đây là những lượt mới so với bài 6.
- 0
Prompt 10: bước 0 ClaudeKỹ sư ký QD-06
Thuộc diện thẩm định không, cơ quan nào, địa phương ra sao. Làm trước mọi đề bài.
- 1
Prompt 02 (mới): khung chốt và đề xuất hạng, bậc ClaudeKỹ sư ký QD-01, QD-02
Claude đề xuất kèm căn cứ vào nhật ký. Không điền vào dữ liệu.
- 2
Prompt 11: chép bảng tra, tra đề bài ClaudeKỹ sư rà cột ra_soat
Từ PDF gốc vào
bang-tra/, rồitra-bang.py --ghi. Tôn trọng chuỗi phụ thuộc. - 3
Prompt 03 (mới): vẽ theo quy ước đo được Codex
Đường xe chữa cháy, lối ra, bãi quay phải có đúng id, nếu không máy đo coi là thiếu. Codex tự chạy công cụ đo trước khi nộp.
- 4
Prompt 04 (mới): thẩm tra bằng công cụ Claude
do-ban-ve.py --ghighi đạt/không đạt; đối chiếu thư viện lỗi; danh sách lỗi có số đo. - 5
Prompt 12: xuất DXF hồ sơ CodexKỹ sư kiểm trước khi ký
Lớp, BLOCK, khung tên, đường kích thước gắn mã YC.
- 6
Prompt 13: ký duyệt Kỹ sư
Checklist trước khi ký, cách ghi xác nhận, và prompt để Claude cập nhật theo kết luận của kỹ sư, kể cả khi khác đề xuất.
- 7
Prompt 14: lắp hồ sơ, kiểm cổng cuối ClaudeKỹ sư ký QD-07
Thuyết minh sinh từ đề bài, bảng đối chiếu thư viện lỗi, rồi
kiem-tra.py --nop.
Thứ tự đưa vào vận hành
- 1Trước khách đầu tiên
Bốn lỗ hổng chặn + bước 0 + hồ sơ
Đã có trong bộ khung bản 2. Việc của bạn: hai bài toán mẫu thật, tên kỹ sư ký, câu trả lời về chứng chỉ năng lực.
- 2Trước tỉnh thứ hai
Bảng tra đầy đủ, địa phương, DXF
Chép hết bảng cần cho loại công trình bạn nhận; điền
dia-phuong.jsoncho tỉnh mới; chốt thư viện ký hiệu. - 3Trước loại công trình thứ hai
Thư viện đề bài theo loại
Sao
yeu-cau-pccc.jsonthành mẫu cho kho hàng, xưởng cho thuê, chung cư; giá trị để trống, giữ căn cứ. - 4Khi có khách ổn định
Giai đoạn sau thiết kế
Giám sát thi công, nghiệm thu, hồ sơ quản lý PCCC cơ sở, kiểm tra định kỳ.
Bài tập 10
Giải nén bộ khung bản 2. Chạy ba lệnh tự kiểm (do-ban-ve.py --tu-kiem, tra-bang.py --tu-kiem, test_tinh_cap_nuoc.py). Rồi cố tình làm sai: điền hạng "A" vào HM-01 trong hang-muc.csv mà không ký QD-01, chạy kiem-tra.py và kiem-tra.py --nop. Ghi lại hai thông báo khác nhau, và tự trả lời: vì sao chế độ làm việc chỉ cảnh báo còn chế độ nộp lại chặn?
Phụ lục
Tra nhanh khi đang làm việc.
Checklist mỗi phiên
[ ] 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.
- Bộ Công an: điều kiện kinh doanh trong lĩnh vực PCCC
- LuatVietnam: điểm mới Nghị định 105/2025/NĐ-CP
- Chứng chỉ hành nghề PCCC cá nhân đã bãi bỏ từ 01/7/2025
- Luật PCCC và CNCH số 55/2024/QH15 (PDF)
- QCVN 06:2022/BXD Sửa đổi 1:2023
- Thông tư 09/2023/TT-BXD
- TCVN 3890:2023
- QCVN 05A:2020/BCT Sửa đổi 1:2024
- Công an Bắc Giang: hướng dẫn tháo gỡ khó khăn thẩm duyệt PCCC (nguồn 21 mục thư viện lỗi)
- Nghị định 175/2024/NĐ-CP, Điều 82: chứng chỉ hành nghề hoạt động xây dựng
- Luật Hóa chất 2025: chính sách mới
- Revit 2027: Autodesk Assistant và máy chủ MCP tích hợp
- Autodesk mở mã nguồn Revit MCP Server
- Thunderhead: kết hợp PyroSim và Pathfinder
- Các công cụ AI pháp luật Việt Nam
- NotebookLM: trích dẫn và kiểm tra nguồn
- Claude Code và AGENTS.md: khi nào CLAUDE.md được ưu tiên
- Claude Code đọc AGENTS.md từ bản 2.1.277
- Nhập AGENTS.md vào CLAUDE.md bằng một dòng
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.
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.