### 🚫 Stale Cache khi sửa tay bằng Vim/Nano
**Vấn đề:** Nếu bạn ssh vào server và sửa trực tiếp file `system_prompt.txt` hoặc `tool_prompts/*.txt` bằng editor (vim, nano) mà KHÔNG thông qua API, hệ thống sẽ tiếp tục sử dụng bản cũ trên RAM (`_system_prompt_cache`).
**Giải pháp:** Luôn sử dụng API để cập nhật, hoặc sau khi sửa tay, bắt buộc phải gọi API `POST /api/prompt/refresh` để hệ thống đọc lại file.

### 🚫 Lỗi cú pháp LangChain `{}`
**Vấn đề:** System prompt có thể chứa mẫu JSON. LangChain sử dụng `{}` để tiêm biến, dẫn đến crash `KeyError` nếu có cặp ngoặc lạ.
**Giải pháp:** Trong file txt, bạn hãy cứ viết JSON bình thường với 1 dấu `{}`. Hệ thống (`prompt_utils.py`) đã tự động replace toàn bộ `{` thành `{{` trước khi truyền cho LangChain, ngoại trừ biến `{{date_str}}`. Do đó ở file text, nếu muốn tiêm ngày tháng, hãy bắt buộc viết đúng chuỗi `{{date_str}}`.

### 🛡️ LLM Factory Fallback
Nếu thiếu `GOOGLE_API_KEY` trong file `.env`, thay vì báo lỗi toàn bộ hệ thống, `LLMFactory` sẽ tự động catch và fallback sang sử dụng `ChatGeminiCLI` (xác thực OAuth local). Đảm bảo dev environment hoạt động bình thường kể cả khi không có token cấp phép chính thức.