Codex + Claude CodeQuản lý dự án · PCCC
0/8 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".
Giáo trình tự học

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 nhà máy sơn Jotun, trọng tâm PCCC.

Lộ trình học

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

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

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

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

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

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

Codex

Thợ dựng hình

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

Bạn

Tổng chỉ huy

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

Claude Code

Kỹ sư hồ sơ

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

Sơ đồ điều phối

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

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

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

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

Bài tập 1

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

2

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

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

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

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

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

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

Năm luật dữ liệu

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

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

Mỗi thứ một mã

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

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

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

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

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

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

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

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

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

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

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

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

Bài tập 2

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

3

Bộ luật chung cho hai AI

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

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

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

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

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

CLAUDE.md
@AGENTS.md

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

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

Mục tiêu dự án

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

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

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

Luật dữ liệu

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

Quy ước file

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

Luật pháp lý

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

Giao ca

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

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

Bài tập 3

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

4

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

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

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

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

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

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

Pull

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

Commit

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

Push

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

Branch

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

Pull Request

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

Merge

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

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

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

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

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

Bài tập 4

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

5

PCCC: phần khó nhất

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

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

Vì sao PCCC khó với AI

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

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

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

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

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

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

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

Thói quen bắt buộc

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

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

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

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

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

chua_tra_cuu→ da_tra_cuu→ dathoặckhong_dat

Codex không tự quyết số

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

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

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

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

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

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

  1. 1

    Phân loại Claude

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

  2. 2

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

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

  3. 3

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

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

  4. 4

    Vẽ mặt bằng PCCC Codex

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

  5. 5

    Thẩm tra mặt bằng Claude

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

  6. 6

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

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

  7. 7

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

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

  8. 8

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

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

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

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

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

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

AI tự nhớ số quy chuẩn

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

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

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

Bản vẽ sai tỷ lệ

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

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

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

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

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

Bài tập 5

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

6

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

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

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

Chuẩn bị một lần

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

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

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

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

Tám lượt giao việc

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

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

Bài tập 6

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

7

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

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

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

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

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

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

Xử lý sự cố

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

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

Hai bên ghi đè lên nhau

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

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

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

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

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

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

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

Bài tập 7

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

8

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

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

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

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

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

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

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

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

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

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

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

Thư viện đề bài PCCC

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

Đóng gói thành skill

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

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

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

Ranh giới trách nhiệm

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

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

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

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

Bài tập 8

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

+

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.