Knowledge Base - Overview (Knowledge)

SharedKnowledge Base698 words3 min read

activebyDOL Product Design

Purpose

Vấn đề: tri thức sản phẩm và học thuật thường phân tán ở nhiều nguồn (Google Docs/Sheets, note nội bộ), dễ trùng lặp và khó truy xuất theo ngữ cảnh.
Đối tượng chính: Product/Design/Academic/Ops và các AI workflow cần truy xuất tri thức chuẩn hóa để phân tích, viết spec, hoặc vận hành tài liệu.
Tín hiệu thành công: mỗi chủ đề có entrypoint rõ ràng, tài liệu mirror được đồng bộ ổn định từ nguồn private, và cấu trúc Knowledge Base duy trì được nhất quán khi mở rộng.

Workspace Position

Workspace entry cho knowledge nằm ở docs/Shared/Knowledge Base/SHR_KB_Workspace_Entry.md.
File này là overview nghiệp vụ bên trong cùng workspace, còn body docs và imported mirrors sống trực tiếp trong docs/Shared/Knowledge Base/**.

Experience Narrative (Ý tưởng tổng quan)

Knowledge Base được thiết kế như một lớp tri thức có phân tầng rõ: nội dung lõi do con người biên soạn và vùng staging mirror để đồng bộ tài liệu từ nguồn private. Cách tách lớp này giúp tránh việc trộn lẫn tài liệu “đã chuẩn hóa để đọc/ra quyết định” với tài liệu “được máy đồng bộ theo nguồn”.

Ở góc vận hành dài hạn, mục tiêu không chỉ là lưu trữ nội dung, mà còn là kiểm soát vòng đời tri thức: thêm nguồn mới nhanh, đồng bộ lặp lại ổn định, kiểm tra naming/layout tự động, và giữ traceability từ file trong repo ngược về nguồn gốc bên ngoài. Các runbook hỗ trợ việc này được đặt ngoài Knowledge Base để khu vực này chỉ còn nội dung học thuật và sản phẩm.

Elements / Scope

Core Knowledge Notes (human-authored):
- NB_*.md trong docs/Shared/Knowledge Base/ (ví dụ: NB_Linearthinking_In_Reading.md, NB_Prompt_Marking_Final_Level_6_0.md).
Imported Staging (machine-managed):
- docs/Shared/Knowledge Base/Imported/NB_IMP_*.md và NB_IMP_INDEX.md.
- Sub-packages theo source domain (ví dụ: Imported/Knowledge page/).

Logic / Rules

Separation of concerns:
- Core notes dùng cho tri thức đã biên tập.
- Imported chỉ dùng cho mirror output.
- Operations docs sống ngoài docs/Shared/Knowledge Base/ để không trộn với knowledge content.
Naming contract:
- Core: NB_<Topic>.md
- Imported: NB_IMP_<TitleToken>_<ShortId>.md
Mirror integrity:
- File trong Imported/ không chỉnh tay; mọi cập nhật đi qua kb:ingest.
Guardrail:
- Chạy npm run kb:guard:imported để kiểm tra layout/naming trước khi merge.

UI / Behavior

Entrypoint của area là NB_00_Overview.md để định hướng nhanh scope và cách dùng.
Người dùng tìm tri thức theo thứ tự:
1. đọc overview để định vị lớp tài liệu,
2. vào core notes cho nội dung đã chuẩn hóa,
3. chỉ vào imported khi cần đối chiếu mirror nguồn mới.
Imported index (NB_IMP_INDEX.md) phản ánh trạng thái sync gần nhất.

Dependencies / Integration

Sync scripts:
- scripts/kb-add-source.mjs
- scripts/kb-ingest.mjs
- scripts/kb-local-doc-convert.mjs
- scripts/kb-oauth-setup.mjs
- scripts/notebooklm-cli.mjs
- scripts/notebooklm-batch.mjs
- scripts/notebooklm-doctor.mjs
Guard:
- tools/check-kb-imported-layout.mjs
Config:
- config/knowledge-ingest/sources.local.json (gitignored)
- config/knowledge-ingest/sources.example.json
- config/knowledge-ingest/local-documents.json
- config/notebooklm/jobs.local.json (gitignored)
- config/notebooklm/jobs.example.json
Supporting ops docs:

References

Change log

2026-02-21: Khởi tạo overview cho area Knowledge Base với cấu trúc 3 lớp (Core/Operations/Imported), naming contract, guardrail và integration map.
2026-02-24: Bổ sung integration map cho NotebookLM wrapper/batch và runbook vận hành tương ứng.
2026-02-27: Bổ sung mapping cho imported sub-package Knowledge page và liên kết overview chuyên biệt của corpus này.
2026-03-06: Tách toàn bộ operational docs ra docs/Shared/Operations/ để Knowledge Base chỉ giữ knowledge content, đồng thời giữ liên kết tới các runbook hỗ trợ ingest và NotebookLM.
2026-03-07: Cập nhật overview sau khi Knowledge Base trở thành workspace chính thức trong docs/Shared/**.