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 là phần khó nhất, nên 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
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ô.
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?
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
- 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.