Handoff S147 → S148

2026-03-30 | OR v7.13 (rev 320) | Hiến pháp v4.0 DỰ THẢO | Anti-patterns 15 (rev 7) PHIÊN S147 RẤT QUAN TRỌNG — đột phá triết lý thiết kế + cấu trúc lại hiến pháp.

★ PROMPT CHO PHIÊN S148 — ĐỌC VÀ LÀM NGAY, KHÔNG HỎI USER

Bạn là Claude phiên mới. Phiên S147 đã hoàn thành M4d-C (PR#650) + bắt đầu cấu trúc lại hiến pháp v4.0. Huyên KHÔNG muốn bị hỏi lại. Đọc handoff này → tự làm.

VIỆC CẦN LÀM PHIÊN S148 — THEO THỨ TỰ:

VIỆC 1: RÀ SOÁT LẦN 1 — Hiến pháp cũ vs mới (SO SÁNH CHI TIẾT)

Đọc 2 file:

CŨ: knowledge/dev/architecture/index.md (v3.9, 75K chars, 34 Điều)
MỚI: knowledge/dev/laws/constitution.md (v4.0, ngắn gọn) + tất cả file laws/

So sánh từng Điều:

Điều nào trong CŨ mà MỚI chưa cover? (rơi rụng)
Chi tiết nào trong CŨ bị mất khi rút gọn? (rơi rụng chi tiết)
Đặc biệt kiểm tra: Lời mở đầu, Điều 0 (bảng vật lý, 5 điều kiện nguyên tử, luật bảo toàn), Điều 2 (prefix planned TP/CPI/SCR/API/CMP/JT/EVT/DOM), Điều 3 (khung metadata 13 fields), Điều 14 (3 cấp trùng, engine chi tiết), Điều 15-16 (journey template schema chi tiết), Roadmap 5 phases
File tham chiếu: knowledge/dev/laws/existing-law-references.md liệt kê 15+ luật có file riêng — kiểm tra TẤT CẢ file đó còn tồn tại và nội dung khớp

Nếu phát hiện rơi rụng → tự bổ sung vào file laws/ tương ứng. Ghi báo cáo:

# Rà soát lần 1 — Cũ vs Mới
| Điều | Nội dung bị rơi | Đã bổ sung vào | Status |

VIỆC 2: RÀ SOÁT LẦN 2 — Kiểm tra xung đột giữa các luật

Đọc TẤT CẢ file trong laws/ + existing-law-references.md links → kiểm tra:

Điều 0-H (5 tầng đồng bộ, DOT cổng duy nhất) có xung đột với Điều 7 (Assembly First, PG trước) không? (Ví dụ: Điều 7 nói "PG trước" nhưng Điều 0-H nói "qua Directus API" → cần hoà giải: Directus API TẠO PG column, vẫn PG là chân lý)
Điều 0-H (CẤM ALTER TABLE) có xung đột với Điều 9 (Schema Governance, SCR) không?
Điều 0-H (DOT Cấp B secret) có xung đột với Luật Luồng Dữ liệu v1.1 (data-flow-law.md) không? (Luật cũ viết trước khi có 5 tầng mới)
Điều 22 (Self-Healing, DOT kiểm tra) với Tuyên ngôn (DOT kiểm tra = nhiệt kế) — có nhất quán không?
Luật Luồng Dữ liệu v1.1 vẫn nói MySQL, Firestore, GCS, Lark — nhiều thành phần đã RETIRED → cần flag để update sau

Nếu phát hiện xung đột → tự hoà giải bằng cách bổ sung "v4.0 bổ sung" vào file luật liên quan. Ghi báo cáo:

# Rà soát lần 2 — Xung đột
| Luật A | Luật B | Xung đột | Hoà giải | Status |

VIỆC 3: SOẠN PROMPT HỘI ĐỒNG (3 agents: Claude Code, Codex, Gemini)

Soạn 1 prompt gửi cho hội đồng review 3 vấn đề:

Có nội dung nào bị rơi rụng giữa hiến pháp cũ (index.md v3.9) và mới (laws/ v4.0) không?
Có nội dung nào xung đột giữa các luật không?
Có góp ý gì để tối ưu hơn? (Dễ hiểu hơn, ràng buộc chặt hơn, kiến trúc tốt hơn)

Prompt phải:

Yêu cầu agent đọc CẢ HAI (cũ + mới) bằng search_knowledge MAIN PROCESS
Liệt kê rõ paths cần đọc
Format báo cáo rõ ràng
Report tại knowledge/current-state/reports/

VIỆC 4: Update OR, handoff, CLAUDE.md/skills

Sau khi rà soát xong:

OR v7.14: ghi kết quả rà soát
Handoff rev mới: S148 status
CLAUDE.md + skills: inject Tuyên ngôn v4.0 (2 câu hỏi)

TÓM TẮT PHIÊN S147 — 1 CÂU

S147: M4d-C fix L1 integrity (45 ô NOT NULL, PR#650) → phát hiện PG↔Directus schema gap → Huyên nâng tầm triết lý thiết kế ("vĩnh viễn chưa? nhầm được không?") → ban hành Tuyên ngôn + §0-BF + §0-H + AP-15/16 → cấu trúc lại hiến pháp v4.0 (laws/ folder, 17 files tạo mới).

QUYẾT ĐỊNH ĐÃ CHỐT S147

#	Quyết định	Ghi
P	Orphan: SPE=loài 0 entities, DOT=thiếu metadata, COL=chưa đăng ký	§0-BD
Q	§0-BD: L1=45 ô, MỌI ô ≠ NULL	OR v7.10
R	dot-pivot-health H8: check 45 cells	DOT-114
S	dot-pivot-virtual-create (DOT-307)	DOT mới
T	dot-cron-pivot-setup (DOT-308) đăng ký	DOT đăng ký
U	§0-BE: L2 metadata-driven (3 fields l2_*)	OR v7.12
V	§0-BF: CẤM ALTER TABLE trực tiếp. Schema qua Directus API.	OR v7.13
W	AP-15: ALTER TABLE bypass Directus = field vô hình	AP 15
X	AP-16: DOT kiểm tra tìm issues nhưng không tìm gốc	AP 16
Y	TUYÊN NGÔN: ① Vĩnh viễn chưa? ② Nhầm được không?	Hiến pháp v4.0
Z	Điều 0-H: Đồng bộ 5 tầng. DOT = cổng duy nhất. 2 Động cơ.	Luật mới
AA	DOT 2 cấp: A (đọc) + B (ghi, secret GSM)	Điều 0-H §3
AB	Hiến pháp cấu trúc lại: laws/ folder, hiến pháp ngắn + luật chi tiết riêng	v4.0

SAI LẦM + BÀI HỌC S147

#	Sai	Bài học sâu
1	Prompt M4d-C v1 thiếu dual-trigger cron	Rà soát 11 nguyên tắc TRƯỚC khi gửi prompt
2	Prompt M4d-C v1 thiếu bức tranh lớn	Nguyên tắc #7
3	fn orphan mới thay vì wire managed rows	Assembly First — dùng lại trước tạo mới
4	M4e v1 dùng ALTER TABLE trực tiếp	→ Phát hiện PG↔Directus gap → §0-BF
5	M4e v2 vẫn định sửa Nuxt	Nuxt ĐÃ OK → §0-BA → KHÔNG ĐỤNG
6	Tư duy fix vụ việc thay vì fix gốc	→ Tuyên ngôn: "Vĩnh viễn chưa? Nhầm được không?"
7	Chỉ nhìn 3 tầng (PG/Directus/Nuxt), quên Agent Data + Qdrant	→ Điều 0-H: 5 tầng
8	DOT kiểm tra coi là giải pháp, không phải nhiệt kế	→ 2 Động cơ: chính (lượt đi) + phụ (lượt về IDLE = mục tiêu)

TRẠNG THÁI HỆ THỐNG

Tab Pivot — M4d-C VERIFIED 9/9

Check	Result
45 ô NOT NULL	✅
record_count vs COUNT thật	✅ 5/5 KHỚP
orphan_count vs query thật	✅ 3/3 (SPE=1, DOT=0, COL=0)
species_count vs query thật	✅ 6/6
8 triggers ENABLED	✅
Cron 5 entries	✅
dot-pivot-health H1-H8	✅ 6/8 PASS, 2 WARN, 0 FAIL
DOT-307/308 đăng ký	✅ CAT-DOT 154
Production 200 OK	✅
PR #650 merged	✅

Hiến pháp v4.0 — DỰ THẢO (chưa rà soát)

Files đã tạo trong knowledge/dev/laws/:

constitution.md — Hiến pháp ngắn gọn (Tuyên ngôn + mục lục)
law-00h-5layer-sync.md — Điều 0-H MỚI (5 tầng, DOT 2 cấp, 2 động cơ)
law-01-five-immutable.md — Điều 1
law-02-registry.md — Điều 2 (+ prefix table)
law-03-metadata.md — Điều 3
law-04-birth-process.md — Điều 4
law-05-five-tiers.md — Điều 5
law-06-sync.md — Điều 6
law-07-assembly-first.md — Điều 7
law-08-dependency.md — Điều 8
law-09-schema-governance.md — Điều 9
law-10-13-operations.md — Điều 10-13 (gộp)
law-15-16-state-checkpoint.md — Điều 15-16 (gộp)
law-17-18-domain-change.md — Điều 17-18 (gộp)
law-19-orphan-scanner.md — Điều 19
law-22-self-healing.md — Điều 22
existing-law-references.md — Tham chiếu 15+ luật có file riêng

CHƯA RÀ SOÁT: Cần rà soát 2 lần + hội đồng review trước khi chính thức ban hành.

Architecture/ folder CŨ — CHƯA ARCHIVE

knowledge/dev/architecture/index.md (v3.9) vẫn còn. KHÔNG XÓA. Sẽ đánh dấu superseded sau khi v4.0 được duyệt.

ROADMAP

✅ S147 ĐÃ XONG

Việc	Kết quả
M4d-C L1 Integrity	PR#650, 9/9 verify, 45 ô NOT NULL
M4d-C bổ sung	DOT-307/308 đăng ký, CAT-DOT 154
Phát hiện PG↔Directus schema gap	§0-BF + AP-15
Nâng tầm triết lý thiết kế	Tuyên ngôn ①②
Thiết kế 5 tầng đồng bộ	Điều 0-H
Cấu trúc lại hiến pháp	laws/ folder, 17 files

🔴 S148 CẦN LÀM (theo thứ tự)

#	Việc	Chi tiết
1	Rà soát lần 1	So sánh index.md cũ vs laws/ mới — tìm rơi rụng
2	Rà soát lần 2	Kiểm tra xung đột giữa các luật
3	Soạn prompt hội đồng	3 câu hỏi: rơi rụng? xung đột? tối ưu?
4	Update OR/handoff/skills	Inject Tuyên ngôn vào CLAUDE.md

⬜ SAU KHI HIẾN PHÁP V4.0 DUYỆT

Việc	Chi tiết
M4e L2 drill-down	Dùng Directus Fields API (§0-BF), không ALTER TABLE
Archive index.md cũ	Đánh dấu superseded
Implement DOT Cấp B secret	GSM integration cho DOT quan trọng
dot-schema-sync-check	Lượt về — quét 5 tầng mismatch
DOT reporting system	Mọi DOT ghi system_issues

BACKLOG

TD-437 (hardcode API), TD-448/451/454 (ma trận), TD-452 (agent audit), TD-453 (DOT thiếu), TD-460 (orphan 2 nguồn), TD-461 (migrate DOT→Directus API), TD-462 (sync check), TD-463 (DOT reporting)

TÀI LIỆU PHIÊN MỚI CẦN ĐỌC

Tài liệu	Path	Mục đích
Handoff này	`knowledge/current-state/handoff-s142-session.md`	Context đầy đủ
Hiến pháp MỚI v4.0	`knowledge/dev/laws/constitution.md`	Tuyên ngôn + mục lục
Điều 0-H MỚI	`knowledge/dev/laws/law-00h-5layer-sync.md`	5 tầng, 2 động cơ
Tham chiếu luật	`knowledge/dev/laws/existing-law-references.md`	15+ luật có file riêng
Hiến pháp CŨ v3.9	`knowledge/dev/architecture/index.md`	So sánh tìm rơi rụng
OR v7.13	`knowledge/dev/ssot/operating-rules.md`	Nguyên tắc + roadmap
Anti-patterns 15	`knowledge/dev/ssot/anti-patterns.md`	15 bài học
Luật Luồng DL	`knowledge/dev/ssot/data-connection-law.md`	Cần kiểm tra xung đột v4.0

10 NGUYÊN TẮC + TUYÊN NGÔN

★ TUYÊN NGÔN: ① Vĩnh viễn chưa? ② Nhầm được không?
★ Không chắc chắn cả 2 → sọt rác, làm lại.

1. ĐỌC KỸ: Hiến pháp, luật, OR, skills, anti-patterns TRƯỚC KHI LÀM.
2. PG → Directus → Nuxt. Auto 100%. DOT 100%. 5 tầng đồng bộ.
3. Update OR, TD, handoff SAU MỖI prompt.
4. Assembly First. Desktop chỉ đạo, CLI thực thi. 1 prompt mỗi lần.
5. Report tại knowledge/current-state/reports/
6. Mô hình tổng thể — bức tranh lớn.
7. Quy trình khép kín — dual-trigger, 2 động cơ.
8. Công cụ đầy đủ — DOT 2 cấp, mỗi bước có tool.
9. Môi trường thực thi — nơi tools làm việc.
10. KHÔNG SỬA CODE. Thay đổi = metadata/config.