Handoff S161 FINAL — P1 DONE, P2 Ready
Handoff S161 — Phase 1 Nền KG: P1 DONE, P2 Ready
Phiên: S161 | Ngày: 2026-04-04 Trạng thái: P1 ✅ VERIFIED. P2 prompt chưa soạn. OR v7.37.
TÓM TẮT 1 CÂU
P1 schema+config hoàn tất (7 tables, ALTER 2 bảng, seed 16 rows, Directus 7/7 sync, constraints 3/3 PASS). P2 cần soạn prompt đăng ký 36 DOT-KG.
P1 KẾT QUẢ — ĐÃ VERIFY QUA DIRECTUS
- entity_species.kg_metadata: ✅ JSONB default {}
- universal_edges: +confidence(0.5), +valid_time(null), +provenance(null). weight đã có sẵn.
- 7 config tables: kg_signal_config(0), kg_thresholds(5), kg_constraint_config(0), kg_acl_config(0), kg_priority_templates(0), kg_auto_approve_rules(6), kg_source_authority(5)
- lower_is_better column: ✅ trên kg_thresholds
- 3 safety CHECKs trên kg_auto_approve_rules: ✅
- Directus sync 7/7: ✅
- Report: knowledge/current-state/reports/s161-p1-kg-schema-report (indexed)
P2 ĐẦU VÀO ĐÃ THU THẬP (KHÔNG CẦN SEARCH THÊM)
dot_tools schema (từ production):
code: DOT_KG_EXTRACT (uppercase, underscores — convention mới)
name: dot-kg-extract (kebab-case)
tier: B hoặc A
domain: dùng dot_domains.code
paired_dot: reference code DOT pair (ví dụ: DOT_KG_VALIDATE)
trigger_type: "on-demand" | tùy DOT
cron_schedule: cho cron DOTs
extra_metadata: JSONB — {"execution_engine": "pg_function"|"agent_api"|"hybrid"}
description: mô tả + ghi config tables DOT đọc/ghi
dot_domains hiện có:
- "kg" (Knowledge Graph) — ĐÃ CÓ
- Sub-domains CHƯA CÓ — cần tạo ~10 sub-domains
Numbering:
- Highest id: 878 (dot-gov-verify). Auto-increment.
- Code format: DOT_KG_{ACTION} (không dùng số)
36 DOT = 18 cặp (từ Đ39 §7):
| # | Cấp B (ghi) | Cấp A (kiểm tra) | Engine B/A |
|---|---|---|---|
| 1 | EXTRACT | COMPLETENESS | agent_api / pg_function |
| 2 | CLASSIFY | VALIDATE | agent_api / agent_api |
| 3 | LINK | CONSISTENCY | hybrid / pg_function |
| 4 | INTENT-CAPTURE | INTENT-RECALC | agent_api / pg_function |
| 5 | RECOMMEND | FEEDBACK | agent_api / hybrid |
| 6 | JOURNEY-UPDATE | TIMELINESS | pg_function / pg_function |
| 7 | CORRECT | ORPHAN | hybrid / pg_function |
| 8 | SIMILARITY | HEALTH | hybrid / pg_function |
| 9 | SCAFFOLD-BUILD | SCAFFOLD-VALIDATE | agent_api / pg_function |
| 10 | SCOPE-PROJECT | SCOPE-VERIFY | hybrid / hybrid |
| 11 | PRIORITY-DECOMPOSE | PRIORITY-RECALC | agent_api / pg_function |
| 12 | DISCOVER+PROPOSE | CONSTRAINT-CHECK | agent_api / hybrid |
| 13 | PROVENANCE-TAG | PROVENANCE-AUDIT | hybrid / pg_function |
| 14 | EXPLAIN | EXPLAIN-VERIFY | agent_api / agent_api |
| 15 | SELF-SCORE | SELF-LEARN | hybrid / agent_api |
| 16 | CONVERSE-EXTRACT | CONVERSE-VERIFY | agent_api / hybrid |
| 17 | EVICT-SCAN | EVICT-VERIFY | pg_function / pg_function |
| 18 | OVERRIDE-LOG | OVERRIDE-AUDIT | pg_function / pg_function |
Sub-domains gợi ý:
kg.formation (EXTRACT, CLASSIFY, LINK, VALIDATE, COMPLETENESS, CONSISTENCY) kg.business (INTENT-, RECOMMEND, FEEDBACK, JOURNEY-) kg.scaffold (SCAFFOLD-) kg.priority (SCOPE-, PRIORITY-) kg.quality (TIMELINESS, ORPHAN, HEALTH, SIMILARITY, CORRECT) kg.governance (DISCOVER+PROPOSE, CONSTRAINT-CHECK, PROVENANCE-, OVERRIDE-) kg.explain (EXPLAIN, EXPLAIN-VERIFY) kg.learning (SELF-SCORE, SELF-LEARN) kg.conversational (CONVERSE-) kg.eviction (EVICT-*)
OR
v7.37 (revision 21). Agent API Registry tại architecture/agent-api-registry.md.
SAI LẦM S161
- Prompt P1 bản đầu thiếu 6 nguyên tắc thiết kế — phải rà soát 2 lần mới sạch
- Agent ghi report file VPS nhưng không ingest KB — phiên sau nhắc agent upload_document
13 LƯU Ý SOẠN PROMPT (từ Huyên)
- Đọc kỹ HP, luật, OR. Agent đọc skill+OR.
- Data=PG→Directus→Nuxt. Auto 100%. DOT 100%. AUTO SCALE.
- Update OR, TD, handoff sau mỗi prompt.
- Assembly First. Desktop nhỏ, agent lớn. 1 prompt/lần.
- search_knowledge TRỰC TIẾP. Không background agent.
- Report tại reports/
- Mô hình tổng thể — TỰ ĐỘNG thế nào?
- Quy trình khép kín — trigger đến hoàn thành.
- Công cụ đầy đủ — mỗi bước có tool.
- Môi trường thực thi — nơi tools làm việc.
- Nguyên tắc vàng — không sửa code, config/metadata.
- DOT theo cặp 2 chiều.
- Agent TỰ ĐỌC KB khi cần.
BẮT BUỘC: Rà soát 11 NT + 5 CQ + 7 thiết kế TRƯỚC khi soạn prompt. KHÔNG soạn xong mới tìm lỗi.
★ PROMPT CHO DESKTOP PHIÊN MỚI
Bước 1: Nạp (2 phút)
search_knowledge("handoff S161")
Đọc handoff này. ĐẦU VÀO P2 ĐÃ ĐỦ — dot_tools schema, dot_domains, 36 DOT manifest, sub-domains. KHÔNG search thêm.
Bước 2: Soạn Prompt P2 (15 phút)
Theo công thức: Mục tiêu → Giải pháp → Rà soát → Roadmap → Soạn.
Mục tiêu: 36 DOT-KG đăng ký dot_tools + ~10 sub-domains dot_domains. execution_engine trong extra_metadata.
Giải pháp: Agent bulk INSERT. Idempotent (ON CONFLICT). Paired_dot cross-reference.
Rà soát TRƯỚC khi soạn:
- 11 NT: đặc biệt NT3 (36 DOT đủ 18 cặp), NT7 (dual-trigger mỗi DOT), NT4 (sẵn sàng thay đổi)
- 5 CQ: CQ5 (execution_engine trong JSONB, không CHECK hardcode)
- 7 thiết kế: §7 (bức tranh lớn — mỗi DOT description ghi config tables đọc/ghi), §8 (quy trình khép kín — trigger_type + cron cho mỗi DOT), §10 (môi trường — domain mapping), §12 (paired_dot cross-reference)
Soạn: 1 prompt. Agent INSERT sub-domains → INSERT 36 DOT → verify count+pairs → report.
Bước 3: Sau P2 done
- Update OR v7.37 → v7.38: P2 done, 36 DOT registered, 216+36=252 DOT
- Soạn P3 (quality tables + pivot)
KHÔNG LÀM
- KHÔNG search 10+ lần — handoff đã đủ
- KHÔNG soạn prompt mà chưa rà soát NT
- KHÔNG quên nhắc agent upload report KB (bài học S161)
TÀI LIỆU
| File | Path |
|---|---|
| Đ39 v2.3 | knowledge/dev/architecture/dieu39-knowledge-graph-law-draft.md |
| OR v7.37 | knowledge/dev/ssot/operating-rules.md |
| Agent API Registry | knowledge/dev/architecture/agent-api-registry.md |
| P1 Report | knowledge/current-state/reports/s161-p1-kg-schema-report |
| Prompt P1 (mẫu rà soát) | Artifact trong phiên S161 — đã qua 2 vòng rà soát NT |
Handoff S161 FINAL | P1 ✅ VERIFIED | P2 input ready | 13 lưu ý | Prompt cho Desktop có sẵn