KB-4CB9
TD — Description Enrichment Redesign (Central Matrix + DOT Sync)
2 min read Revision 1
tech-debtdescriptionenrichmentcentral-matrixdot-syncredesign
TD — Description Enrichment Redesign (Central Matrix + DOT Sync)
Date: 2026-05-14 Status: TD — chưa thiết kế, chưa ưu tiên Origin: User observation during B3-F1c-H birth system completion Priority: sau khi khai sinh hoàn thiện
Vấn đề
Nhiều đối tượng (DOTs, collections, species, modules...) thiếu description. Cách cũ (cho agent nhảy vào từng record viết) đã thử và thất bại — nặng, dễ sai, không scale.
Hướng thiết kế mới (user đề xuất)
- Bảng phẳng trung tâm — liệt kê tất cả objects cần mô tả, có cột description
- Agent viết description vào bảng này — 1 nơi duy nhất, không cần biết cấu trúc từng target
- DOT-DESC-SYNC tự động đọc bảng → diff → cập nhật vào dot_tools, collection_registry, v.v.
- DOT-DESC-DRIFT phát hiện ai sửa description ở target mà không qua bảng trung tâm
- Dual-trigger: event-driven + periodic (NT7)
- Liên quan Đ43 (System Context Law) — objects tự mô tả
Câu hỏi thiết kế chưa trả lời
- Bảng mới universal hay mở rộng bảng cũ?
- Scope: những loại object nào cần description?
- DOT code: sync logic, diff strategy, conflict resolution
- Quan hệ với description_policy trên collection_registry (đã fully populated)
Tham chiếu
- Guide cũ:
knowledge/dev/guides/description-enrichment-guide.md - Design cũ:
knowledge/dev/laws/dieu44-trien-khai/design/14-description-policy-endpoint-and-execution-design-pack.md - Report cũ:
knowledge/dev/laws/dieu44-trien-khai/reports/description-policy-option1-runtime-execution-report.md
TD | Description Enrichment Redesign | 2026-05-14