[T10] T10 — KB Intelligence Roadmap: Manual → RAG → Knowledge Graph

T10 — KB Intelligence Roadmap: Manual → RAG → Knowledge Graph

Context

Knowledge Base (KB) hiện dùng manual mapping (DOMAIN_KB_MAP + SKILL_DOMAINS). Hoạt động tốt cho quy mô hiện tại (16 entries, 35 skills, 2 projects). Roadmap này ghi lại lộ trình upgrade khi KB grow.

Kiến truc hien tai (Phase 0)

company_hq/ops/knowledge/
├── kb_core.py              ← Core: DOMAIN_KB_MAP + load_kb() + helpers
├── tech-odoo/*.md          ← KB entries (chung)
├── compliance/*.md
└── ...
Mỗi project:
└── .claude/skills/_shared/
    └── kb_loader.py        ← Wrapper: import kb_core + SKILL_DOMAINS riêng

ODO: 26 skills, HQ: 9 skills → tổng 35 skills integrated

API: load_kb_for_skill(skill_name) → list[dict]

Ưu: deterministic, git-trackable, zero infra

Nhược: manual mapping không scale, không semantic search

Roadmap

Phase 0 — Manual Mapping (DONE, 03/2026)

Dict-based: DOMAIN_KB_MAP + SKILL_DOMAINS

16 KB entries × 13 domains × 35 skills

Trigger upgrade: KB > 30 entries hoặc mapping trở thành burden

Phase 1 — ChromaDB + Semantic Search

Thay: logic trong kb_core.py — dict lookup → ChromaDB query

Thêm: embed_kb.py script (index KB entries, chạy khi thêm entry)

Giữ nguyên: KB markdown files, SKILL.md files, wrappers, API

Stack: ChromaDB (local, file-based) + sentence-transformers hoặc Anthropic embedding

Xóa được: DOMAIN_KB_MAP (optional, có thể giữ làm fallback)

Effort: 1 buổi

Trigger upgrade: cần cross-domain reasoning, multi-agent

Phase 2 — MCP Server + Knowledge Graph

Thêm: MCP server (Python) wrap ChromaDB + NetworkX graph

Graph nodes: KB entries, skills, domains, companies, employees, products, regulations

Graph relationships: applies_to, depends_on, related_to, supersedes

Claude integration: native MCP tools (search_kb, query_graph)

Giữ nguyên: tất cả files, projects, skills — backward compatible

Effort: 1-2 ngày

Trigger upgrade: cần multi-agent orchestration

Phase 3 — Multi-Agent Orchestration

Agents share context qua Knowledge Graph

Morning Brief Agent, Product Launch Agent, Compliance Agent

Mỗi agent đọc graph + query ChromaDB + gọi Odoo API

Cross-project reasoning tự động

Phase 4 — External Data Sources

Thêm nodes: Google Analytics, Shopify, bank API, Odoo real-time

Thêm pháp nhân: công ty mới → graph nodes + relationships

Multilingual: Fosllea Japan → embedding multilingual tự xử lý

Nguyên tắc xuyên suốt

1. Mỗi phase thêm layer, KHÔNG xóa layer cũ 2. API backward compatible — load_kb_for_skill() luôn hoạt động 3. Data format chuẩn — markdown + frontmatter là nền tảng cho mọi phase 4. Upgrade khi có pain point thực tế — không upgrade preemptive 5. Kaizen: đúng tool cho đúng lúc, đủ dùng trước, scale sau

Khi nào upgrade?

| Signal | Upgrade to | |--------|-----------| | KB > 50 entries, mapping burden | Phase 1 (ChromaDB) | | Cần cross-domain auto-discovery | Phase 1 | | Cần multi-agent shared context | Phase 2 (MCP + Graph) | | Cần proactive alerts, impact analysis | Phase 2 | | Nhiều data sources ngoài Odoo | Phase 4 |

---

📚 Published from Company Knowledge Base — T10
Last updated:
Review by: 2026-06-10