C+Codex + Claude Code cho quản lý dự án
0/10 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.

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

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.

  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
  10. 10Buổi 8
    PCCC bản 2: đủ để vận hànhCông cụ đo, cổng kỹ sư ký, hồ sơ nộp
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ô.

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. 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?

10

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ý.

Một buổi trọnKết quả: bộ khung bản 2 chạy qua được cổng xuất hồ sơ

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ư.

Kiến trúc bộ khung bản 2: tham số hạng mục và bảng tra có nguồn đi vào đề bài qua tra-bang.py; Codex vẽ theo đề bài; do-ban-ve.py đo và ghi đạt/không đạt; tinh-cap-nuoc.py tính nước sau khi qua bài toán mẫu; thư viện lỗi và kiem-tra.py rà; kỹ sư ký bảy quyết định; kiem-tra --nop mở cổng xuất hồ sơ hang-muc.csvtham số PCCC từng hạng mục bang-tra/*.csvchép từ PDF gốc, có nguồn docs/phap-ly/nguon/PDF văn bản trong khung chốt thu-vien/loi-thuong-gap.json21 lỗi trả hồ sơ, lớn dần mỗi dự án tra-bang.pytham số → giá trị + căn cứ yeu-cau-pccc.json 27 YC: tham_so · phu_thuoc · gia_tri · can_cu chua_tra_cuu → da_tra_cuu → dat / khong_dat / can_tra_lai Codex vẽSVG theo quy ước · DXF hồ sơ do-ban-ve.pyđo khoảng cách, đường, lối ra tinh-cap-nuoc.pychỉ chạy khi có 2 bài toán mẫu kiem-tra.py chuỗi phụ thuộc · căn cứ · khung chốt luật tự động từ thư viện lỗi ky-duyet.json kỹ sư ký 7 quyết định QD-01…QD-07 AI không được ghi vào đây kiem-tra.py --nop cổng cuối: chặn tới khi đủ ho-so-tham-dinh.json 15 tài liệu HS-xx → nộp đạt / không đạt ghi ngược vào YC Người vẽ, người đo, người ký: ba vai khác nhau.
Mũi tên trên là luồng dữ liệu, không phải luồng chat. Không có cánh tay nào của AI với tới ô ký duyệt.

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 địnhVì sao không giao AI
QD-01Hạng nguy hiểm cháy nổ từng hạng mụcMắt xích đầu của cả chuỗi; sai một là sai hết
QD-02Bậ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-03Có 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-04Phân vùng nguy hiểm nổ, cấp thiết bị điệnChuyên môn hóa chất và điện
QD-05Giải pháp thay thế, điều khoản chuyển tiếpVướng mắc số 1 khi thẩm định là chuyển tiếp quy chuẩn
QD-06Thuộc / không thuộc diện thẩm định, cơ quan nàoQuyết định cả bộ sản phẩm phải làm
QD-07Cho phép xuất hồ sơ nộpChữ 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.

chua_tra_cuu→ da_tra_cuu→ dathoặckhong_dat · khi mắt xích trước đổi →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.

tra-bang.py → do-ban-ve.py → kiem-tra.py
$ 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.

  1. 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.

  2. 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.

  3. 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ồi tra-bang.py --ghi. Tôn trọng chuỗi phụ thuộc.

  4. 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.

  5. 4

    Prompt 04 (mới): thẩm tra bằng công cụ Claude

    do-ban-ve.py --ghi ghi đạt/không đạt; đối chiếu thư viện lỗi; danh sách lỗi có số đo.

  6. 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.

  7. 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.

  8. 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

  1. 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.

  2. 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.json cho tỉnh mới; chốt thư viện ký hiệu.

  3. 3Trước loại công trình thứ hai
    Thư viện đề bài theo loại

    Sao yeu-cau-pccc.json thành mẫu cho kho hàng, xưởng cho thuê, chung cư; giá trị để trống, giữ căn cứ.

  4. 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

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.