# CHO CLAUDE ĐỌC: Bước 1. Cài Obsidian + Bộ não thứ 2

> Tài liệu này viết cho Claude Code của học viên. Người học chỉ cần dán câu lệnh bên dưới vào Claude, Claude đọc file này rồi làm.
> Thuộc hệ thống triển khai AI 20 bước của Trương Minh Kiên. Trang bước này: https://trienkhaiobsidian.truongminhkien.vn

## Việc cần làm

Kho tri thức Claude tự biên soạn cho nghề của bạn, kèm toàn bộ skill marketing, bán hàng, vận hành.

Câu lệnh học viên dán vào Claude:

```
Tải gói https://trienkhaiobsidian.truongminhkien.vn/bo-nao-ai.zip, giải nén, giải nén vào thư mục vault Obsidian của tôi (giữ nguyên cấu trúc, kể cả thư mục ẩn .claude), đọc CHO-CLAUDE-DOC.md rồi sửa CLAUDE.md cho đúng lĩnh vực của tôi
```

## Luật khi làm

1. Đọc hết file này, kể cả phần bẫy, trước khi chạy lệnh nào.
2. Việc cần mật khẩu, mã OTP, token hay thanh toán thì dừng lại để học viên tự làm, không nhập hộ.
3. Không xoá dữ liệu, bản ghi DNS hay file cũ của học viên. Chỉ thêm.
4. Khoá bí mật chỉ nằm trong `.env` (đã có trong `.gitignore`), không ghi vào mã, wiki hay kết quả.
5. Xong mỗi bước thì kiểm tra thật (chạy thử, đọc lại) rồi mới báo xong.
6. Gói này chạy trên máy của học viên, không phải máy người soạn. Mọi đường dẫn tính từ thư mục giải nén hoặc thư mục vault của học viên; hỏi học viên nếu cần. Skill nào nhắc tới file `output/...` hay trang `wiki/...` mà vault học viên chưa có thì đó chỉ là nguồn tham khảo của người soạn: bỏ qua, dùng nội dung ngay trong skill. Riêng `wiki/concepts/bo-mau-thuong-hieu.md`: nếu chưa có, chép từ `mau/bo-mau-thuong-hieu.md` trong gói rồi hỏi học viên để điền.

## Skill trong gói

- Toàn bộ skill trong `.claude/skills/` (xem `HƯỚNG-DẪN-SỬ-DỤNG.md`)

Cách cài skill: chép từng thư mục trong `.claude/skills/` của gói vào `.claude/skills/` của vault Obsidian (bước 1). Tên thư mục phải trùng tên skill, file chính tên `SKILL.md`.

## Cách cài đặt từng bước (làm theo thứ tự)

### CHO CLAUDE ĐỌC — cài Bộ Não Thứ 2 vào thư mục hiện tại

> Bạn là Claude Code đang chạy trên máy của một người **mới**, không rành máy. Người đó vừa dán câu
> *"Tải gói trên, giải nén rồi copy vào vault này, giữ nguyên cấu trúc, sửa CLAUDE.md cho đúng lĩnh vực của tôi"*.
> Làm đúng thứ tự dưới đây. Nói với người dùng bằng tiếng Việt, mỗi lượt một việc, không hỏi dồn.

## 0. Kiểm ba thứ trước khi làm gì

1. **Thư mục hiện tại** (`pwd`): phải là thư mục người dùng muốn đặt bộ não. Nếu đường dẫn có
   **dấu tiếng Việt hoặc khoảng trắng** (ví dụ `D:\Bộ não của tôi`) → dừng, nói rõ: *"Đường dẫn có
   dấu/khoảng trắng sẽ gây lỗi 'không tìm thấy file' ngẫu nhiên về sau. Anh/chị tạo thư mục mới
   không dấu, ví dụ `D:\NAO-CUA-TOI`, rồi mở lại Claude ở đó."* Đây là lỗi đã trả giá thật.
2. **Thư mục có trống không?** Nếu đã có tệp: hỏi người dùng có muốn ghi đè không. Không tự xoá.
3. **`git` có không?** Chạy `git --version`. Có → dùng cách A. Không → dùng cách B, **đừng bắt
   người dùng cài git**.

## 1. Giải nén gói vào đúng thư mục

Gói zip `https://trienkhaiobsidian.truongminhkien.vn/bo-nao-ai.zip` **đã có đủ bộ não** (`CLAUDE.md`, `index.md`, `log.md`, `wiki/`, `raw/`, `output/`, thư mục `.claude/skills/` với các skill), không cần GitHub, không cần git.

PowerShell (đứng ở thư mục bộ não, ví dụ `D:\NAO-CUA-TOI`):
```powershell
Invoke-WebRequest https://trienkhaiobsidian.truongminhkien.vn/bo-nao-ai.zip -OutFile bo-nao.zip
Expand-Archive bo-nao.zip -DestinationPath . -Force
Move-Item -Path .\bo-nao-ai\* -Destination . -Force
Get-ChildItem .\bo-nao-ai -Force | Move-Item -Destination . -Force   # gom nốt tệp ẩn (.claude)
Remove-Item -Recurse -Force .\bo-nao-ai, .\bo-nao.zip
```
macOS: `curl -L -o bo-nao.zip https://trienkhaiobsidian.truongminhkien.vn/bo-nao-ai.zip && unzip -o bo-nao.zip && cp -R bo-nao-ai/. . && rm -rf bo-nao-ai bo-nao.zip`.

Kiểm: thư mục hiện tại phải có `CLAUDE.md` và `.claude/skills/`. Thiếu `.claude` là quên bước gom tệp ẩn.

## 2. Hỏi người dùng bốn câu — từng câu một

| Ô | Hỏi thế nào | Gợi ý trả lời |
|---|---|---|
| `«TÊN BỘ NÃO CỦA BẠN»` | "Đặt tên bộ não là gì? Ngắn, viết hoa." | `NÃO SPA`, `NÃO XƯỞNG GỖ` |
| `«LĨNH VỰC»` | "Anh/chị làm nghề gì, nói một cụm?" | `nha khoa`, `đào tạo tiếng Anh` |
| `«ĐƯỜNG DẪN GỐC»` | Không hỏi — lấy từ `pwd` | `D:\NAO-CUA-TOI` |
| `«PHẠM VI»` | "Việc gì thuộc bộ não này, việc gì không?" | "chỉ việc phòng khám; nhà đất cá nhân không" |

Nếu người dùng nói *"không biết"*, đề xuất một câu trả lời hợp lý rồi hỏi "được không?".

## 3. Điền bốn ô vào ba tệp, rồi dọn bao bì

- Thay **mọi** chỗ `«…»` trong `CLAUDE.md`, `BAT-DAU-O-DAY.md`, `index.md`. Xong, grep lại chuỗi
  `«` trong ba tệp — phải bằng **0**.
- Xoá các khối ⚙️ "dùng một lần" ở đầu ba tệp đó.
- **Không** đụng `log.md` (không có ô nào) và không đụng `mau/`.
- Xoá hai tệp bao bì của repo mẫu: `README.md` và chính tệp `CHO-CLAUDE-DOC.md` này (đã đọc xong; bộ não
  của người dùng không cần chúng).
- Sửa `CLAUDE.md` cho đúng lĩnh vực: chỉ thêm 3–5 dòng ở mục "Bối cảnh riêng" (nghề gì, ai là
  khách, việc gì hay làm). **Không** viết lại luật; luật đã được thử ở hệ thống thật.

## 4. Nghiệm thu — làm thật, không nói suông

1. Gõ `claude` phiên mới (hoặc `/clear`), hỏi *"bộ não này là gì?"* — Claude phải trả lời theo
   `CLAUDE.md` đã điền tên thật.
2. Chạy `/skills` (hoặc hỏi "có những skill nào") — phải thấy các skill `tmk-*`, `sale-page-16-buoc`,
   `tmk-mkt-website-wordpress-thu-lead`. Không thấy → `.claude/skills/` chưa nằm ở gốc.
3. Bảo người dùng thả **một tài liệu thật** vào `nguon/`, rồi chạy *"nạp file này: nguon/<tên>"* theo
   §8.1 của `CLAUDE.md`. Nạp xong `index.md` và `log.md` phải đổi.

## 5. Bẫy đã trả giá — đọc trước khi báo lỗi cho người dùng

| # | Bẫy | Cách tránh |
|---|---|---|
| 1 | Đường dẫn có dấu / khoảng trắng → liên kết `[[...]]` và công cụ dòng lệnh lúc được lúc không | Mục 0, bước 1 |
| 2 | Cách B bỏ sót `.claude/` vì là thư mục ẩn | `Get-ChildItem -Force` để kiểm |
| 3 | Người dùng dán lệnh PowerShell vào CMD → báo lỗi lạ | Nhìn dấu nhắc: `PS` là PowerShell |
| 4 | Gói Claude miễn phí không chạy được Claude Code | Hỏi ngay từ đầu nếu `claude` báo lỗi đăng nhập |
| 5 | Tên tệp trong `wiki/` có dấu | Luật §4 `CLAUDE.md`: ASCII, gạch nối, không dấu |
| 6 | Thả mật khẩu, khoá API, hồ sơ nhân thân vào `nguon/` rồi đồng bộ đám mây | Đọc mục "AN TOÀN DỮ LIỆU" trong `HUONG-DAN-CAI-DAT.md` cho người dùng nghe **trước** lần nạp đầu |
| 7 | Skill viết cho ngành khác (bán hàng, marketing) — bê nguyên ngôn ngữ vào ngành của người dùng | Mỗi skill có mục "dịch bối cảnh"; hỏi người dùng trước khi dùng lần đầu |

## 6. Báo cáo cuối cho người dùng (khuôn)

```
✅ Đã cài Bộ Não Thứ 2 tại <đường dẫn>
📄 5 tệp gốc · 6 mẫu · 37 skill
✏️ Đã điền: tên = …, lĩnh vực = …, phạm vi = …
🧪 Nghiệm thu: <3 phép thử ở mục 4, đạt/không>
➡️ Việc tiếp theo: mở BAT-DAU-O-DAY.md; thả tài liệu đầu tiên vào nguon/
```


## Hướng dẫn chi tiết và các bẫy đã gặp

(Bản đầy đủ có hình và nút bấm: https://trienkhaiobsidian.truongminhkien.vn)

Yêu cầu trước khi bắt đầu

- Máy tính Windows, Mac, hoặc Linux
- Không cần biết lập trình gì cả — chỉ là ứng dụng ghi chú

## Các bước cài đặt

1

### Tải và cài Obsidian

Vào [obsidian.md](https://obsidian.md), tải bản dành cho máy của bạn, cài như phần mềm bình thường. Miễn phí cho sử dụng cá nhân.

2

### Tạo 1 "vault" (kho ghi chú) mới

Mở Obsidian lần đầu, chọn "Create new vault", đặt tên (ví dụ "Bộ Não Thứ 2"), chọn nơi lưu trên máy. Đây chính là 1 thư mục bình thường trên ổ đĩa — mỗi ghi chú là 1 file `.md` (Markdown, chữ thuần, không khoá định dạng riêng của phần mềm nào).

3

### Hiểu 3 tầng của "Bộ Não Thứ 2"

Đây không phải hỏi-đáp thông thường — tri thức được biên dịch 1 lần rồi giữ luôn cập nhật, không tái tạo lại mỗi lần hỏi:

- **Nguồn thô** — tài liệu gốc (bài viết, ảnh, ghi âm), AI chỉ đọc, không sửa
- **Wiki** — trang do AI tự viết: tóm tắt nguồn, trang thực thể, khái niệm, liên kết chéo bằng cú pháp `[[Tên trang]]`
- **Sổ tay** — 1 file `CLAUDE.md` ở gốc vault, dạy AI cách cư xử như người biên tập có kỷ luật cho đúng lĩnh vực của bạn

4

### Dựng cấu trúc "Bộ Não Thứ 2" chuyên nghiệp — đã có sẵn code thật, không phải để AI viết lại

Đây là bản STARTER thật tôi đang dùng — đã có sẵn `CLAUDE.md` mẫu + gần 50 skill marketing/bán hàng/vận hành đã dùng thật (kèm bộ skill Lark chính thức), khử sạch thông tin cá nhân. Đưa thẳng link gói này cho Claude AI (sau khi có Claude AI ở bước sau):

https://trienkhaiobsidian.truongminhkien.vn/bo-nao-ai.zip

Nói: *"Tải gói ở link trên, giải nén, copy toàn bộ vào vault này (giữ nguyên cấu trúc, riêng `raw/`/`wiki/`/`output/`/`index.md`/`log.md` để trống đúng như starter). Sửa `CLAUDE.md` cho đúng lĩnh vực của tôi là \[điền lĩnh vực của bạn\]."* Từ giờ mỗi lần nhờ việc gì, Claude AI phải ghi lại đúng theo cấu trúc này — không làm xong rồi thôi.

3 nguyên tắc cốt lõi Claude AI cần hiểu (bắt nó đọc kỹ trước khi làm bất cứ gì):

- **raw/ bất biến** — AI chỉ đọc, không bao giờ sửa nguồn gốc
- **wiki/ là AI viết, bạn đọc** — liên kết chéo bằng `[[Tên trang]]`, một trang mồ côi (không ai trỏ tới) là dấu hiệu cần dọn
- **Mỗi câu trả lời phải trích nguồn** — khi có dữ liệu mới mâu thuẫn dữ liệu cũ, ghi rõ cả hai + ngày tháng, không âm thầm ghi đè

5

### Trỏ Claude AI vào đúng vault này

Ở [bước tiếp theo](https://trienkhaiclaude.truongminhkien.vn/), khi mở Terminal để chạy Claude AI, hãy mở đúng tại thư mục vault vừa tạo — mọi ghi chú, SOP, kết quả về sau đều nằm gọn trong 1 nơi duy nhất.

Toàn cảnh — 20 bước của hệ thống này

Đây là bước 1, dưới đây là toàn bộ hành trình để biết mình đang ở đâu:

- **Phần 1 — Cài nền (làm một lần):** 1. Cài Obsidian (đang ở đây) · 2. Cài Claude AI · 3. Cài Antigravity IDE · 4. Cài Lark · 5. Cài GitHub · 6. Tên miền về Cloudflare · 7. Hộp thư tên miền riêng · 8. Ghi âm → Chữ
- **Phần 2 — Hồ sơ & sản phẩm (biết bán gì, cho ai, giá bao nhiêu):** 9. Chiến lược & Nghiên cứu · 10. Tài chính & Định giá · 11. Lead Magnet · 12. Website & Sale Page · 13. Content & Video
- **Phần 3 — Máy chạy thay mình:** 14. Đăng Facebook tự động · 15. Cài Lam Khuê (Lark) · 16. Cài Lam Khuê (Zalo) · 17. Cài Viral Short Studio · 18. Máy gửi thư nuôi · 19. Bán hàng & Chăm sóc Lead · 20. Quảng cáo Facebook

Đi lần lượt từng bước, mỗi trang tự dẫn sang trang kế bằng nút "Bước tiếp theo" ở cuối — không cần nhớ thứ tự, chỉ cần bắt đầu từ đây.

**Vì sao không dùng Word/Notion?** File Markdown thuần không khoá bạn vào 1 phần mềm nào — mở được bằng bất kỳ trình soạn thảo nào, AI đọc/ghi trực tiếp không cần API riêng, và toàn bộ dữ liệu nằm ngay trên máy bạn, không phụ thuộc máy chủ của ai.

⭐ Nguyên tắc bắt buộc — nhớ ngay từ bước đầu tiên này

Mọi việc AI làm cho bạn ở BẤT KỲ bước nào trong 20 bước sau đây đều phải **ghi lại vào chính vault này** — không chỉ làm xong rồi thôi. Yêu cầu Claude AI (ở bước tiếp theo) tạo cho bạn 1 file `CLAUDE.md` ngay tại gốc vault, dạy nó đúng nề nếp:

- Mỗi lần làm xong 1 việc, viết 1 trang mô tả lại vào thư mục `output/`
- Cập nhật `index.md` — mục lục trỏ tới mọi trang đã có
- Ghi 1 dòng vào `log.md` — nhật ký theo thời gian, việc gì làm khi nào
- Lần sau quay lại hỏi tiếp, AI đọc lại đúng những file này trước — không phải giải thích lại từ đầu mỗi lần

Đây chính là lý do gọi là "Bộ Não Thứ 2": tri thức được biên dịch 1 lần rồi giữ luôn cập nhật, không tái tạo lại mỗi lần hỏi.

Bước tiếp theo

Đã có nơi lưu tri thức, sang bước kế tiếp: cài công cụ AI sẽ đọc và ghi vào đây.

[Sang bước 2: Cài Claude AI →](https://trienkhaiclaude.truongminhkien.vn/)