User Requirement — Điều 43 tích hợp Understand-Anything / External Context Graph Tools
USER REQUIREMENT — Điều 43: Ưu tiên tích hợp Understand-Anything / External Context Graph Tools
Ngày ghi nhận: 2026-05-26 Nguồn: User request trực tiếp Trạng thái: Yêu cầu bổ sung cho triển khai Điều 43; chưa phải amend luật ban hành Độ ưu tiên: CAO — phải đọc trước khi tiếp tục Phase 4+ / context graph / architecture map / AI onboarding
1. Nguyên tắc do User chốt
Nếu xã hội / cộng đồng open-source / công cụ bên ngoài đã làm tốt một phần nào đó, Incomex không nên làm lại từ đầu. Cách nhanh hơn và khôn ngoan hơn là đánh giá, tích hợp, adapter hóa.
Những phần thị trường chưa có, hoặc chỉ riêng Incomex cần do đặc thù luật nội bộ, PG-first, DOT governance, IU/Text-as-code, KB/Context Pack, health/enforcement, thì Incomex bắt buộc tự làm.
2. Công cụ được nêu cụ thể
Repo / công cụ cần đưa vào danh sách đánh giá khi tiếp tục Điều 43:
Understand-Anything— repo tạo codebase knowledge graph / context graph / dependency map / guided understanding cho AI hoặc developer mới.
Có thể mở rộng nguyên tắc này cho các công cụ tương tự, ví dụ:
- codebase graph generator
- dependency analyzer
- architecture visualizer
- semantic code search / repo intelligence
- diff impact analyzer
- AI onboarding graph tool
- docs/wiki graph generator
3. Cách áp dụng vào Điều 43
Khi tiếp tục triển khai Điều 43, trước khi tự viết các phần sau, agent phải kiểm tra có công cụ đã làm tốt chưa:
- scan codebase để sinh graph file/function/class/dependency
- architecture graph / Mermaid / visual map
- guided tour cho AI mới
- diff impact analysis
- domain extraction từ code
- codebase search / semantic search
- sinh JSON graph trung gian
- dashboard trực quan cho context graph
Nếu công cụ bên ngoài đáp ứng được, ưu tiên thiết kế theo hướng:
External Tool → Adapter/Importer → Điều 43 Context Pack / IU Context Graph / PG metadata
Không copy nguyên công cụ vào làm SSOT. Không để external tool thay Điều 43.
4. Ranh giới bắt buộc
External tool như Understand-Anything chỉ được coi là công cụ phụ / analyzer / evidence generator.
Điều 43 vẫn giữ vai trò:
- luật vận hành context hệ thống
- SSOT của Context Pack
- schema PG / metadata / section definitions
- DOT-CONTEXT-PACK-BUILD và DOT-CONTEXT-PACK-VERIFY
- health checks / enforcement / retry / staging-live publish
- liên kết với HP, Điều 20, Điều 22, Điều 24, Điều 35, Điều 37, Điều 44/IU
External tool không được:
- ghi trực tiếp vào PG production nếu chưa qua adapter được duyệt
- bypass verify của Điều 43
- thay thế
context_pack_section_definitions - thay thế DOT build/verify
- tạo nguồn chân lý thứ hai gây drift
- override luật, DOT registry, KB law index, red zones
5. Hướng tích hợp đề xuất
Tạo một adapter riêng, ví dụ:
DOT-CONTEXT-GRAPH-IMPORT
hoặc module trong build pipeline Điều 43:
context_graph_external_sources:
- provider: understand_anything
input: .understand-anything/knowledge-graph.json
output_sections:
- architecture_mmd
- project_map_json
- entities_overview
- iu_context_graph_edges
mode: evidence_only
Output từ Understand-Anything nên được đưa vào Context Pack dưới dạng:
- evidence graph
- codebase relation edges
- architecture draft
- dependency map
- impact hints
Sau đó Điều 43 verify lại bằng:
- checksum
- section size bounds
- JSON schema
- Mermaid parse
- provenance label
- stale/drift detection
- rule/law consistency checks
6. Checklist bắt buộc trước khi tự xây mới
Trước khi viết mới scanner hoặc graph engine cho Điều 43, agent phải trả lời:
- Có công cụ open-source nào đã làm được phần này chưa?
- Understand-Anything có đáp ứng đủ không?
- Có thể tích hợp bằng adapter thay vì viết lại không?
- Dữ liệu output có đủ deterministic / machine-readable không?
- Có thể đưa vào Context Pack mà không phá SSOT không?
- Có thể verify bằng Điều 43 không?
- Phần nào là generic nên dùng ngoài, phần nào là Incomex-specific phải tự làm?
Nếu câu trả lời cho 1–3 là “có”, ưu tiên tích hợp.
7. Kết luận điều hành
Không bỏ Điều 43. Không thay Điều 43 bằng Understand-Anything.
Nhưng khi triển khai tiếp Điều 43, phải coi Understand-Anything và các công cụ tương tự là ứng viên tích hợp ưu tiên cho lớp codebase/context graph, để tránh làm lại thứ cộng đồng đã làm được.
Điều 43 chỉ nên tự xây phần riêng của Incomex: luật, SSOT, PG/DOT/IU governance, Context Pack sống, health/enforcement, và traceability xuyên luật → thiết kế → code → test → vận hành.