obsidian-mind: Vault Obsidian biến Claude Code thành trợ lý không bao giờ quên

Tóm tắt

Claude Code thông minh nhưng có một điểm yếu chết người: nó quên sạch sau mỗi phiên. Bạn phải giải thích lại công việc từ đầu, nhắc lại quyết định đã đưa ra tuần trước, kể lại buổi 1:1 hôm qua. Mỗi sáng mở lên là thuê nhân viên mới.

obsidian-mind giải quyết đúng vấn đề đó. Đây là một vault Obsidian được thiết kế từ đầu để làm bộ não lâu dài cho Claude Code — 15 lệnh tắt, 9 trợ lý chuyên biệt, 5 hook vòng đời, và hệ thống theo dõi hiệu suất đủ để dùng khi đến mùa đánh giá cuối năm.

Sự khác biệt so với việc tự setup Obsidian + CLAUDE.md: repo này không chỉ cho bạn “một nơi lưu notes mà Claude đọc được” — nó cho bạn một hệ thống vận hành hoàn chỉnh với quy trình buổi sáng, buổi tối, hàng tuần, và mùa review.

Bài này dành cho ai?

1. Kỹ sư phần mềm đang lo lắng vì mùa đánh giá hiệu suất sắp đến

Vấn đề chung: Làm nhiều việc nhưng không nhớ hết để viết tự đánh giá. Khi ngồi viết brag doc mới hoảng ra là không còn nhớ tên dự án, con số cụ thể, hay quyết định kiến trúc nào đã đưa ra sáu tháng trước.

Các trường hợp thực tế:

• Bạn vừa hoàn thành một dự án lớn, đã xử lý nhiều sự cố, có nhiều 1:1 với manager — nhưng khi đến tháng review, tất cả chỉ còn lại mờ nhạt trong ký ức. → Trong suốt quá trình làm việc, mỗi khi kết thúc 1:1 hay xử lý xong một sự cố, chạy /dump để kể cho Claude nghe. Nó tự phân loại và lưu vào đúng nơi. Đến mùa review, chạy /review-brief — Claude đọc lại toàn bộ brag doc, evidence, quyết định, và feedback từ 1:1, rồi tạo ra bản review draft có trích dẫn cụ thể.

• Bạn muốn viết peer review cho đồng nghiệp nhưng không nhớ đủ ví dụ cụ thể về công việc của họ. → Chạy /peer-scan <tên GitHub> — trợ lý slack-archaeologist và review-prep sẽ đào qua toàn bộ pull request, comment code review, thread Slack, rồi tổng hợp bằng chứng có cấu trúc vào thư mục perf/evidence/.

• Bạn biết mình đang có điểm mù trong một số năng lực chuyên môn nhưng không biết làm sao theo dõi sự tiến bộ. → Tạo note năng lực trong perf/competencies/ theo mẫu sẵn có. Khi làm việc, Claude tự liên kết các ghi chú công việc vào đúng năng lực tương ứng. Theo thời gian, mỗi note năng lực tích lũy backlink từ các dự án thực tế — đó chính là bằng chứng khi review.

2. Người dùng Claude Code hàng ngày và đang mất quá nhiều thời gian giải thích lại context

Vấn đề chung: Claude Code giỏi nhưng không nhớ. Mỗi sáng mở session mới phải nhắc lại: đang làm dự án gì, blocked ở đâu, quyết định hôm qua là gì. Hiệu quả thực tế kém hơn nhiều so với tiềm năng.

Các trường hợp thực tế:

• Bạn đang chạy song song 2-3 dự án, mỗi dự án có context riêng. Mỗi khi chuyển qua lại phải giải thích lại hết. → Hook SessionStart tự động chạy khi mở Claude Code: đọc North Star goals, kiểm tra các dự án đang chạy, quét thay đổi git gần nhất, tải danh sách tasks còn mở. Claude bắt đầu buổi với câu: “Bạn đang làm Project Alpha, đang blocked ở API contract. 1:1 với manager vào chiều nay — bản brief đã sẵn sàng.”

• Sau một buổi họp đầy thông tin — quyết định mới, người mới, hướng đi thay đổi — bạn không biết ghi lại ở đâu, theo format gì, và liệu Claude có đọc được không. → Mở Claude, gõ /dump, rồi kể tự nhiên bằng lời. Claude phân loại từng mảnh thông tin: quyết định → Decision Record, người mới gặp → note trong org/people/, win → cập nhật brag doc, task mới → danh sách công việc. Không cần biết cấu trúc vault.

• Bạn hay mở Claude Code trên máy tính này, nhưng một số ghi chú nằm trên máy khác hoặc trong Obsidian app trên điện thoại. Context bị phân mảnh. → Vault là thư mục git — đồng bộ qua bất kỳ công cụ nào bạn đang dùng. MEMORY.md trong ~/.claude/ chỉ là chỉ mục trỏ vào vault, không phải nơi lưu dữ liệu thật. Context sống trong vault, không chết theo phiên.

3. Tech lead hoặc engineering manager hay phải xử lý sự cố, họp hành, và ra quyết định kiến trúc liên tục

Vấn đề chung: Quyết định nhiều, họp nhiều, sự cố nhiều — nhưng tất cả chỉ sống trong đầu hoặc nằm rải rác trong Slack. Khi cần tra lại “tại sao tháng trước mình quyết định như vậy?” thì không có gì để xem.

Các trường hợp thực tế:

• Một sự cố xảy ra trong production. Bạn cần ghi lại timeline, nguyên nhân gốc, và bài học — nhưng đang bận xử lý không có thời gian viết incident report. → Chạy /incident-capture <link Slack thread>. Trợ lý slack-archaeologist đọc toàn bộ thread kể cả các tin nhắn phụ, xây dựng timeline đầy đủ, phân tích nguyên nhân gốc, và tạo bản ghi tự động. Nó cũng tự tạo note cho những người tham gia lần đầu xuất hiện trong thread.

• Bạn đã đưa ra nhiều quyết định kiến trúc quan trọng trong năm, nhưng không có nơi nào ghi lại lý do đằng sau mỗi quyết định. Sáu tháng sau có người hỏi lại, bạn không nhớ. → Mỗi khi /dump gặp nội dung quyết định, Claude tự tạo Decision Record chuẩn với context, lý do, và trạng thái. Tất cả tổng hợp trong brain/Key Decisions.md. Trợ lý context-loader có thể tải lại toàn bộ context của một quyết định bất kỳ khi cần.

• Bạn cần chuẩn bị cho buổi 1:1 hàng tuần với manager nhưng không có thời gian ôn lại những gì đã nói trong lần trước, feedback là gì, action item còn tồn đọng không. → Chạy /standup vào buổi sáng để có cái nhìn tổng quan. Trước 1:1, chạy /capture-1on1 sau buổi họp để ghi lại đầy đủ. Lần sau vào session, Claude đã đọc tất cả — bạn đi thẳng vào nội dung, không phải ôn lại.

Các điểm chính

1. CLAUDE.md 285 dòng — cẩm nang vận hành mà Claude đọc mỗi buổi Không phải một file ghi chú tùy tiện. Đây là tài liệu quy định đầy đủ: lưu ghi chú vào đâu, liên kết như thế nào, khi nào tách note, làm gì với quyết định và sự cố. Mọi hành vi của Claude trong vault đều bắt nguồn từ đây. → Không cần viết lại từ đầu. Clone repo, chỉnh phần cá nhân hóa là dùng được.

2. Năm hook vòng đời — bạn chỉ cần nói chuyện, hook lo phần còn lại SessionStart inject context đầy đủ khi mở Claude. UserPromptSubmit phân loại từng tin nhắn bạn gửi và chèn gợi ý routing. PostToolUse kiểm tra frontmatter và wikilink sau mỗi lần ghi file. PreCompact sao lưu phiên trước khi nén context. Stop chạy checklist kết thúc ngày tự động. → Không cần nhớ quy trình. Hook xử lý toàn bộ phần kỷ luật.

3. /dump — nói tự nhiên, không cần biết vault cấu trúc ra sao Đây là lệnh dùng nhiều nhất trong ngày. Kể cho Claude nghe bất cứ thứ gì vừa xảy ra — cuộc họp, quyết định, sự cố, win nhỏ. Claude tự phân loại và route từng mảnh vào đúng note. Một buổi dump có thể cập nhật đồng thời: note người, ghi nhận quyết định, tạo task, và cập nhật brag doc. → Dùng sau mỗi sự kiện quan trọng trong ngày thay vì cố nhớ để kể sau.

4. /standup — buổi sáng bắt đầu với đầy đủ ngữ cảnh trong 30 giây Tải North Star goals, kiểm tra dự án đang chạy, mở task còn tồn đọng, quét thay đổi git gần nhất. Claude trả về bản tóm tắt có cấu trúc và gợi ý ưu tiên. Không phải kể lại từ đầu — bắt đầu ngay vào công việc thật. → Chạy mỗi sáng trước khi bắt đầu làm việc. Thay thế hoàn toàn việc ngồi nhớ lại hôm qua.

5. Đồ thị hiệu suất — backlink là bằng chứng tự tích lũy Mỗi ghi chú công việc liên kết đến năng lực tương ứng trong perf/competencies/. Claude làm việc này tự động khi bạn tạo note. Theo thời gian, mỗi năng lực có hàng chục backlink từ các dự án thực tế. Đến mùa review, đọc backlinks panel là đã có đủ bằng chứng — không cần viết lại từ ký ức. → Setup competency notes ngay từ đầu năm. Backlink tự tích lũy mà không cần thêm công sức.

6. 9 trợ lý chuyên biệt — chạy trong cửa sổ riêng, không làm bẩn hội thoại chính Mỗi trợ lý có nhiệm vụ riêng: brag-spotter tìm win chưa được ghi lại, slack-archaeologist đọc lại toàn bộ thread Slack, review-prep tổng hợp bằng chứng review, vault-librarian dọn dẹp orphan notes và broken links. Các tác vụ nặng chạy riêng biệt, hội thoại chính vẫn sạch sẽ. → Gọi trực tiếp khi cần, hoặc để các lệnh chính tự gọi khi phù hợp.

7. /review-brief — từ vault đến bản tóm tắt review đầy đủ trong một lệnh Tổng hợp toàn bộ: brag entries theo quý, quyết định quan trọng, sự cố đã xử lý, feedback từ 1:1, bằng chứng năng lực. Có cả phiên bản manager review và self-review. Mọi claim đều có link đến note gốc — không phải lời nói suông. → Chạy trước buổi review với manager. Dùng kết quả làm tài liệu chuẩn bị.

8. /vault-upgrade — di chuyển từ vault cũ sang mà không mất dữ liệu Phát hiện phiên bản vault (v1 đến v3.2), kiểm kê toàn bộ file, trình bày kế hoạch migration rõ ràng trước khi chạy, rồi mới thực thi sau khi bạn xác nhận. Vault cũ không bị sửa đổi. Hỗ trợ cả vault không phải obsidian-mind — Claude đọc từng note và phân loại theo ngữ nghĩa. → Dùng nếu đang có vault Obsidian cũ và muốn chuyển sang hệ thống này.

9. Bases — database views tự cập nhật theo ghi chú Thư mục bases/ chứa các góc nhìn dạng database: Work Dashboard, Incidents, People Directory, 1:1 History, Review Evidence, Competency Map. Tất cả đọc từ YAML frontmatter trong ghi chú và cập nhật tự động. Home.md nhúng tất cả lại thành trang tổng quan vault. → Không cần maintain thủ công. Ghi note → frontmatter đúng → bases tự cập nhật.

10. QMD semantic search — tìm “điều đã quyết định về Redis” kể cả khi note đặt tên khác Tìm kiếm theo nghĩa thay vì theo từ khóa. Không bắt buộc — nếu chưa cài, Claude dùng Obsidian CLI và grep thay thế. Nhưng khi cần tìm “tất cả những lần đề cập đến caching strategy” mà không nhớ note nằm ở đâu, QMD là công cụ đúng. → Cài thêm sau khi vault đã có đủ nội dung. Không phải điều kiện để bắt đầu.

Bắt đầu như thế nào

1. Hôm nay — Clone và mở vault

git clone https://github.com/breferrari/obsidian-mind.git ~/my-vault
cd ~/my-vault && claude

Mở thư mục bằng Obsidian (phiên bản 1.12 trở lên). Bật Obsidian CLI trong Cài đặt → Chung.

2. Trong 15 phút đầu — Điền North Star Mở brain/North Star.md và điền mục tiêu hiện tại của bạn — công việc, dự án, ưu tiên. Đây là file Claude đọc đầu tiên mỗi buổi. Càng cụ thể, buổi sáng càng bắt đầu đúng hướng.

3. Ngày đầu tiên — Thử /standup và /dump Chạy /standup để thấy hệ thống hoạt động ra sao. Sau đó kể cho Claude nghe một việc vừa xảy ra bằng /dump — dù là quyết định nhỏ hay buổi họp ngắn. Xem nó route vào đâu.

4. Tuần đầu — Tạo competency notes Tạo ít nhất ba note trong perf/competencies/ dựa trên framework năng lực của tổ chức bạn. Từ đó về sau, mỗi khi làm việc liên quan, Claude sẽ tự liên kết. Đến cuối năm, backlinks chính là bằng chứng review.