llm-wiki

Wiki Link là hệ thống quản trị tri thức chuyên sâu, thiết kế để biến tài liệu thô (sách, báo cáo, clipping) thành đồ thị kiến thức nguyên tử (Atomic Knowledge Graph) phục vụ phân tích tài chính kỹ thuật cao. AI agents (Claude, Gemini) vận hành qua librarian.py làm entry point duy nhất.

Agent Config: Load Order

Mỗi agent đọc theo thứ tự sau khi bắt đầu session:

CLAUDE.md / GEMINI.md — Agent-specific: mandate 5 lenses, search escalation, read discipline. system.md — SOP đầy đủ: BLOCK 0 Hard Rules · BLOCK 1 Identity · BLOCK 2 Output Modes · BLOCK 3 Session Checklist · BLOCK 4 Pointer Map.

Khung phân tích: 5 Lenses

Mọi phân tích MODE DEEP phải đi đủ 5 lenses theo thứ tự:

Template đầy đủ: 01_schema/templates/T_MODE_DEEP.md

Read Discipline: Two-Pass Pattern

Áp dụng cho mọi file read để tiết kiệm token:

Pass 1 — Locate (chạy search, không đọc file):

• BM25/Keyword: librarian.py search hoặc Grep → file path + line number + thesis line
• Semantic: librarian.py search --semantic → ranked list với title + thesis + score
• Nếu thesis line đã đủ → dừng, không cần Pass 2

Pass 2 — Expand (tối đa 2 nodes/cycle, ưu tiên WIKI score cao nhất):

• Keyword hit → wiki: Read(file, offset=line-3, limit=40)
• Keyword hit → raw: Read(file, offset=line-3, limit=40) — không đọc cả chapter
• Semantic hit → wiki: Read(file, limit=60) — từ đầu node
• Semantic hit → raw: Grep locate section → Read đoạn match, không đọc từ đầu file