CLAUDE.md Trong Vault Obsidian: 5 Template Theo Type 2026

CLAUDE.md trong vault Obsidian là file schema CLAUDE.md ở root vault Claude Code đọc tự động đầu mỗi session, biến Claude từ generic chatbot thành disciplined wiki maintainer. Best practice cộng đồng khuyên giữ file dưới 300 dòng, dùng progressive disclosure thay vì stuff hết mọi rule, và cập nhật Active Context section đầu mỗi ngày để tránh stale noise.

Mình đã viết và refine CLAUDE.md cho 4 vault khác nhau (personal research, blog ongboit, code project, team docs). Bài này tổng hợp 5 template theo project type với commentary cụ thể từng template, kèm phần khi nào cần dùng nested CLAUDE.md cho sub-folder. Mọi template đều copy-paste sẵn, chỉ cần thay placeholder trong dấu [...].

CLAUDE.md Trong Vault Obsidian Là Gì?

CLAUDE.md trong vault Obsidian là một file markdown ở root vault, vừa là persistent context cho Claude Code đọc đầu mỗi session, vừa là note Obsidian bình thường bạn có thể edit như mọi note khác. Đây là điểm thiên tài của pattern: một file plain text, hai mục đích, không cần config riêng cho AI agent.

Khi bạn chạy claude trong terminal trỏ vào vault, Claude Code tự động load CLAUDE.md trước khi nhận instruction đầu tiên (theo Anthropic Claude Code docs). File này định nghĩa cấu trúc folder, naming conventions, rules cho agent, và Active Context của ngày hôm đó. Không có CLAUDE.md, Claude phải đoán cấu trúc mỗi session, kết quả wiki page lộn xộn, không follow convention.

Bài obsidian + claude code pillar overview đã có template basic CLAUDE.md ngắn gọn. Bài 3-layer architecture giải thích vai trò CLAUDE.md là Layer 3 schema. Bài Karpathy LLM Wiki story cover lý do pattern viral, và daily notes workflow áp dụng CLAUDE.md vào nhịp công việc hằng ngày. Bài này focus 100% vào template chi tiết, 5 phiên bản theo project type, copy-paste ready cho developer.

CLAUDE.md Tối Thiểu Nên Có Những Section Nào?

CLAUDE.md tối thiểu hiệu quả nên có 6 section, không hơn. Đa số dev mới start với CLAUDE.md 200-300 dòng đầy section, kết quả Claude tốn token đọc preamble dài, performance giảm. File càng ngắn càng đọc nhanh, càng cập nhật dễ.

Sáu section bắt buộc theo thứ tự ưu tiên. Vault Purpose 2-3 câu mô tả vault dùng để làm gì, đối tượng người dùng, mục đích chính. Folder Structure liệt kê các thư mục với vai trò + quyền read/write của Claude. Naming Conventions định nghĩa cách đặt tên file (kebab-case, date prefix, etc). Wiki Page Template là template YAML frontmatter chuẩn cho mọi trang wiki. Rules danh sách quy tắc Claude phải tuân theo (luôn tạo wikilinks, cập nhật index, không sửa notes/, etc). Active Context là phần update đầu mỗi session ghi rõ context hiện tại.

Section optional có thể thêm khi vault grow lớn. Common Patterns ghi lại pattern bạn thường dùng (ví dụ “khi research topic mới, tạo concept page trước rồi mới ingest source”). Tool Routing chỉ định khi nào dùng skill nào (ví dụ “ingest URL bằng /defuddle để tiết kiệm token”). Glossary terminology canonicalisation cho cross-vault terms. Cộng dồn tối đa 9 section, vẫn dưới 300 dòng tổng.

Quy tắc quan trọng nhất là Progressive Disclosure: đừng tell Claude all info bạn có thể tell, mà tell Claude how to find important info khi cần. Ví dụ thay vì paste full naming convention 20 dòng, viết “naming convention details ở wiki/conventions.md“. Claude đọc file đó khi cần cụ thể, không phải mỗi session.

Active Context section đặc biệt quan trọng vì CLAUDE.md drift là real problem. Nếu bạn viết một lần rồi không update Active Context, Claude đọc như current state, generate output calibrated cho version cũ của work. Mình update Active Context mỗi sáng 30 giây, ghi 3 dòng: “đang nghiên cứu X”, “deadline gần Y”, “ưu tiên hôm nay Z”. Hiệu quả tăng rõ rệt so với để Active Context cũ.

Template 1 Cho Personal Research Vault Có Cấu Trúc Gì?

Personal research vault là use case phổ biến nhất, áp dụng cho developer làm research blog hoặc tổng hợp kiến thức cá nhân. Vault có raw sources từ research, wiki Claude tự maintain, projects/ chứa bản nháp content đang viết, và notes/ là sandbox cá nhân Claude không đụng.

# [Tên Vault] Research Knowledge Base
> Personal wiki for research and content writing.
> Maintained by Claude Code using Karpathy LLM Wiki pattern.

## Vault Purpose
Vault này lưu kiến thức research cho blog writing và personal learning.
Target audience: cá nhân tôi và đôi khi share weekly review trên Twitter.
Goal: build compounding knowledge graph 200+ notes trong 6 tháng.

## Folder Structure
- raw/         - Nguồn gốc thô (PDF, articles, transcripts). Claude READ only.
- wiki/        - Claude WRITE: entity pages, concept pages, summaries.
  - entities/  - người, công ty, tổ chức cụ thể
  - concepts/  - ý tưởng abstract, framework, pattern
  - sources/   - tóm tắt từng raw file
  - synthesis/ - bài cross-source synthesis
  - index.md   - master table of contents
  - log.md     - chronological operation log
- projects/    - Drafts blog đang viết. Claude HỖ TRỢ khi yêu cầu.
- notes/       - Ghi chú cá nhân. Claude KHÔNG đụng vào.

## Naming Conventions
- Wiki pages: kebab-case, English (claude-code-mcp.md)
- Raw files: YYYY-MM-DD-ten-ngan.md
- Tags: lowercase, hierarchy với /, ví dụ research/ai/architecture
- Wikilinks: [[page-name]] format only, KHÔNG markdown links

## Wiki Page Template
---
title: [Entity hoặc Concept Name]
tags: [category/subcategory]
created: YYYY-MM-DD
updated: YYYY-MM-DD
status: draft | stable | deprecated
type: entity | concept | source | synthesis
sources: [raw/yyyy-mm-dd-source.md]
---
## Summary
[1-2 câu định nghĩa]
## Key Points
- [bullet points chính]
## Related
[[page-a]] · [[page-b]]

## Rules
1. Luôn tạo wikilinks khi mention entity đã có trong wiki
2. Cập nhật wiki/index.md sau mỗi page mới
3. Giữ wiki page dưới 500 từ
4. Source mọi thông tin về số liệu, ngày tháng
5. Min 2 wikilinks per page (dense linking)
6. KHÔNG sửa file trong notes/ trừ khi yêu cầu rõ ràng

## Active Context
# CẬP NHẬT đầu mỗi session
- Đang nghiên cứu: [topic]
- Deadline gần: [project + date]
- Ưu tiên hôm nay: [task cụ thể]

Template này chạy ổn cho vault 100-500 notes. Mình dùng variant này cho ongboit.com research vault, vault khoảng 300 notes sau 3 tháng. Update Active Context mỗi sáng 30 giây, mỗi mục đích nghiên cứu chỉ thay 3 dòng đó là Claude tracking đúng context.

Template 2 Cho Software Project + Docs Cấu Hình Ra Sao?

Software project + docs vault dùng khi bạn vừa code vừa maintain knowledge base cho project. Vault có code/ thực tế (hoặc symlink tới repo), docs/ là wiki technical, decisions/ ghi lại architecture decisions, runbooks/ cho operations.

# [Project Name] Development Knowledge Base
> Software project vault with technical wiki and decision log.
> Claude Code reads code, writes docs and decision records.

## Vault Purpose
Vault này hỗ trợ development [project name].
Goal: maintain technical wiki up-to-date với codebase, document
architectural decisions, và onboard new contributors quickly.

## Folder Structure
- code/        - Symlink tới repo gốc. Claude READ ONLY.
- docs/        - Technical wiki. Claude WRITE/MAINTAIN.
  - architecture/  - system design docs
  - api/           - API specs, endpoint docs
  - integrations/  - 3rd party service docs
  - troubleshoot/  - common issues + solutions
- decisions/   - ADR (Architecture Decision Records). Claude APPEND only.
- runbooks/    - Operational procedures. Claude WRITE.
- changelogs/  - Release notes. Claude WRITE on release.

## Naming Conventions
- Docs: kebab-case (database-schema.md)
- ADR: NNNN-decision-title.md (0001-use-postgres.md)
- Runbooks: action-context.md (deploy-staging.md)
- Tags: tech/[language|tool|domain] (tech/python/api)

## Wiki Page Template (technical)
---
title: [Doc Title]
tags: [tech/category]
created: YYYY-MM-DD
updated: YYYY-MM-DD
status: draft | reviewed | deprecated
type: architecture | api | runbook | troubleshoot
related_files: [code/path/to/file.py:42]
related_docs: [[other-doc]]
---
## Context
[Why this exists]
## Details
[Implementation details]
## Examples

# code example

## Related
- File: code/path/to/file.py
- Decision: [[0001-use-postgres]]

## Rules
1. Mọi docs/ page phải link tới code file cụ thể (file:line)
2. ADR follow format: Status, Context, Decision, Consequences
3. Runbook phải có Pre-flight checks + Rollback section
4. Cập nhật changelog khi merge PR
5. KHÔNG sửa code/. Read only zone.

## Active Context
- Sprint: [current sprint name]
- Active feature: [feature in progress]
- Open ADR: [decisions chờ review]
- On-call: [yes/no]

Template này critical cho dev VN làm contract software project. ADR section đặc biệt giá trị: 6 tháng sau khi code đi vào production, bạn (hoặc dev khác) review wiki, hiểu lý do từng quyết định kiến trúc, không phải dò git history blame.

Template 3: Multi-Client Agency Vault

Multi-client agency vault áp dụng cho freelancer hoặc agency làm việc trên 3-10 client cùng lúc. Mỗi client là một sub-folder, mỗi sub-folder có thể có nested CLAUDE.md riêng để override rules global.

# Agency Knowledge Vault
> Multi-client knowledge base for freelance agency work.
> Each client has isolated folder + sub-CLAUDE.md if needed.

## Vault Purpose
Vault này quản lý kiến thức và documentation cho 3-10 client cùng lúc.
Mỗi client tách isolated, không share data cross-client (NDA compliance).

## Folder Structure
- clients/
  - [client-a]/
    - CLAUDE.md (project-specific override)
    - docs/, decisions/, runbooks/
  - [client-b]/
  - [client-c]/
- agency/      - Nội bộ agency: process, templates, learnings
  - templates/ - reusable doc templates
  - retros/    - project retrospectives
  - playbooks/ - standard operating procedures
- crm/         - Lead tracking, proposals (READ ONLY for Claude in client sessions)

## Naming Conventions (global)
- Client folders: kebab-case slug (acme-corp, beta-startup)
- Project docs: client-prefix-doc.md
- Retros: YYYY-MM-DD-client-project-retro.md
- Tags: client/[slug] và type/[doc-type]

## CRITICAL: Client Isolation
Khi làm việc trong folder clients/[client-x]/, Claude CHỈ ĐƯỢC ĐỌC files
trong folder đó + agency/templates/. KHÔNG được đọc clients khác.
Vi phạm này = NDA breach. Claude phải tự enforce rule này.

## Naming Convention per Client (override trong sub-CLAUDE.md)
Mỗi client có thể có naming convention riêng tùy yêu cầu của client.
Default theo Naming Conventions ở vault root.

## Rules
1. Cross-client linking BLOCKED. Mỗi client isolated.
2. agency/templates/ shared across clients (read-only).
3. Mọi sensitive data (credential, contract amount) BLOCKED khỏi wiki.
4. Decisions ghi vào clients/[client]/decisions/ với client tag.
5. Khi end-of-engagement, archive clients/[client]/ thành archive/[client-yyyy].

## Active Context
- Active clients: [list]
- Current focus: [client-x feature/issue]
- Deadlines this week: [...]
- Pending proposals: [link]

Template này critical cho freelancer Việt Nam đa client. Section CRITICAL: Client Isolation đảm bảo NDA compliance, Claude tự refuse cross-client query. Mình từng làm freelance 4 client cùng lúc, template này tránh được nhiều nguy cơ leak data.

Template 4: Daily Journal + Creative Writer

Daily journal + creative writer vault tối ưu cho người ghi nhật ký hằng ngày + viết sáng tạo (blog, fiction, essays). Heavy daily notes, ít wiki technical, focus vào reflection và content production.

# Personal Journal & Writing Vault
> Daily reflection + creative writing knowledge base.
> Claude helps with morning prep, evening reflection, and writing drafts.

## Vault Purpose
Vault này lưu daily journal cá nhân và content writing (blog + essays).
Goal: build writing habit consistent + accumulate insights cho content sau.

## Folder Structure
- daily/       - Daily journal notes (Periodic Notes plugin auto-create)
- weekly/      - Weekly reviews (Claude tự generate từ daily)
- monthly/     - Monthly synthesis (Claude generate từ weekly)
- writing/
  - drafts/    - Draft blog posts, essays
  - published/ - Published content reference
  - ideas/     - Content ideas pool
- reading/
  - books/     - Book notes, highlights
  - articles/  - Article notes, highlights
- people/      - People mentioned trong journal (privacy-aware)

## Naming Conventions
- Daily: YYYY-MM-DD.md (Periodic Notes default)
- Weekly: YYYY-Www.md (2026-W18)
- Drafts: project-slug-draft-NN.md
- Published: YYYY-MM-DD-slug.md
- Tags: theme/[topic] (theme/productivity, theme/relationship)

## Daily Note Template
---
date: YYYY-MM-DD
type: daily
tags: [daily/YYYY/MM]
mood: [1-10]
energy: [1-10]
---
## Focus
[1-2 câu intention cho ngày]
## Tasks Carry Over
- [ ] [from yesterday]
## Today Tasks
- [ ]
## Notes & Captures
[free-form throughout day]
## End of Day
- 3 wins:
- 1 learning:
- Mood note:

## Rules
1. Daily notes là PERSONAL space. Claude WRITE only when user asks.
2. Khi share weekly review public, anonymize people (P, J thay tên).
3. people/ có privacy flag: public_safe vs private_only.
4. Drafts iteration count tracked: blog-draft-01.md → blog-draft-02.md.
5. Không generate content fake về personal experience.

## Active Context
- Current writing project: [name + deadline]
- Reading currently: [book title]
- Mood baseline this week: [trend]

Template này giúp người viết blog cá nhân duy trì habit. People folder đặc biệt sensitive: ai mention trong journal được anonymize khi share public. Mình dùng variant này cho personal vault tách biệt với research vault, hai vault không cross-link.

Template 5: Team Shared Knowledge Base

Team shared knowledge base dùng cho team 2-5 người chia sẻ vault qua Git. Khác với personal vault, team vault cần governance rõ về schema, conflict resolution, và quyền access.

# [Team Name] Shared Knowledge Base
> Multi-author knowledge vault. Synced via Git.
> Claude Code helps maintain consistency across team members.

## Vault Purpose
Vault chia sẻ team [N] members. Goal: single source of truth cho
team knowledge: decisions, runbooks, onboarding, retro learnings.

## Team Members
- [Name 1] (@github-handle): role, owner of [areas]
- [Name 2] (@github-handle): role, owner of [areas]
- [...]

## Folder Structure
- shared/      - Team-wide content. Mọi member WRITE.
  - decisions/ - Team decisions log (ADR format)
  - runbooks/  - Team operational procedures
  - onboarding/ - New hire guide
- members/
  - [name1]/   - Personal scratch space per member
  - [name2]/
- meetings/    - Meeting notes. Claude WRITE templates.
- retros/      - Sprint/project retrospectives

## Naming Conventions
- Decisions: NNNN-team-decision-title.md
- Meetings: YYYY-MM-DD-meeting-type.md (2026-05-03-standup.md)
- Runbooks: action-context.md
- Tags: team/[domain], owner/[name]

## Conflict Resolution Protocol
1. Git: Pull trước khi edit, commit nhỏ thường xuyên.
2. Concurrent edit conflict: file lock plugin Obsidian không reliable;
   convention: tag file `## EDITING by @name YYYY-MM-DD HH:MM`
3. Schema changes (CLAUDE.md, templates): cần review approval từ 1 member khác.
4. Disputed decisions: revert + discuss in next standup.

## Rules
1. Mọi page có frontmatter `owner: @name` để tracking.
2. ADR phải có Reviewed-by: @name trong frontmatter trước merge.
3. Members folders là personal, members khác READ ONLY.
4. Sensitive data (credentials, salaries) BLOCKED. Use vault password store.
5. Onboarding doc luôn được update khi rule mới được merge.

## Active Context (shared)
- Sprint: [current sprint]
- Active decisions in review: [link]
- New hire onboarding in progress: [name]
- Last team meeting: [link]

Team vault là use case khó nhất. Quy mô tối đa khuyến nghị 5 người, qua đó nên dùng Notion AI hoặc dedicated team docs platform. Mình thử team vault với 8 người, conflict liên tục, schema drift, kết quả phải tách thành 8 personal vault với weekly sync. Trên 5 người, pattern này stretched too thin.

Khi Nào Cần Multiple CLAUDE.md (Nested)?

Multiple CLAUDE.md hierarchical là feature Claude Code cho phép vault có CLAUDE.md ở root + sub-folder CLAUDE.md riêng cho project hoặc area cụ thể. Claude đọc theo thứ tự: root vault CLAUDE.md → folder-specific CLAUDE.md → context override theo project. Lớp con override lớp cha cho rules cụ thể.

Khi nào cần nested? Có 4 case phổ biến. Một, agency vault với multiple client (Template 3 ở trên). Mỗi client có rules khác về language, style, naming. Hai, team monorepo có nhiều sub-project khác stack (frontend React, backend Python, infra Terraform). Mỗi sub-project có technical convention khác. Ba, personal vault tách research / journal / projects, mỗi loại cần workflow khác. Bốn, scale lên vault rất lớn (1000+ notes), CLAUDE.md root quá dài, tách bớt vào sub-folder cho readability.

Cách viết nested CLAUDE.md hiệu quả. Sub-folder CLAUDE.md ngắn 20-30 dòng, chỉ override rules cần khác biệt. Không lặp lại rules global từ root. Thường có 3 section: Override Reason (vì sao folder này đặc biệt), Local Rules (rules chỉ áp dụng folder này), Local Active Context (context riêng folder).

Ví dụ folder clients/acme/CLAUDE.md (sub):

# ACME Corp Project Override
> Inherits from /CLAUDE.md root with overrides below.

## Override Reason
ACME yêu cầu specific tech stack + style guide + NDA stricter.

## Local Rules
- Tech stack: React 18, TypeScript strict, Tailwind CSS, không emoji commit
- Doc style: ACME corporate template (link tại agency/templates/acme.md)
- Sensitive: client data isolation strict, không cross-link với agency/
- Language: tài liệu tiếng Anh (ACME team international)

## Local Active Context
- Active sprint: ACME Sprint 12
- Deadline: 2026-05-30 launch
- Open blockers: API rate limit issue

Nested CLAUDE.md không phải one-size-fits-all. Mình dùng cho 2/4 vault hiện tại. Vault personal research và blog không cần nested vì rules đồng nhất. Vault agency (4 client) và vault code-projects monorepo cần nested rõ ràng. Quy tắc: nếu sub-folder có >5 rules khác root, đó là dấu hiệu cần nested CLAUDE.md.

CLAUDE.md Liên Kết Với Phần Còn Lại Của Ecosystem Obsidian Như Thế Nào?

Phần này giúp bạn hiểu rõ vị trí của CLAUDE.md trong toàn bộ hệ sinh thái Obsidian năm 2026. Hiểu được mối liên kết giữa các thành phần giúp team thiết kế vault hợp lý ngay từ đầu, tránh việc phải tái cấu trúc về sau khi đã đầu tư công sức vào pattern không phù hợp.

CLAUDE.md đặc biệt mạnh khi kết hợp với Obsidian MCP server cho Claude Code. MCP server cho phép Claude Code đọc CLAUDE.md từ vault và áp dụng các quy tắc đã định nghĩa cho mọi thao tác trong session. Pattern khôn ngoan là cấu hình MCP server để tự động load CLAUDE.md khi khởi động session, đảm bảo Claude Code luôn nhớ các quy tắc đặc thù của vault mỗi lần làm việc. Đầu tư 30 phút config MCP server đúng cách giúp team tận dụng tối đa giá trị của CLAUDE.md trong dài hạn.

Khi team làm việc trên nhiều thiết bị, CLAUDE.md cần được sync kịp thời qua giải pháp Obsidian Sync đa thiết bị. File này thay đổi định kỳ khi team cập nhật quy tắc mới hoặc thêm pattern hoạt động, sync chậm có thể dẫn đến các thiết bị có phiên bản khác nhau gây Claude phản hồi không nhất quán. Pattern khôn ngoan là cấu hình sync ưu tiên cao cho CLAUDE.md, đảm bảo mọi thay đổi được truyền tải ngay lập tức đến tất cả thiết bị đang hoạt động.

Đối với team triển khai pattern kiến trúc wiki theo phương pháp khoa học, CLAUDE.md đóng vai trò là lớp 3 trong kiến trúc Karpathy LLM Wiki. Lớp 1 là raw data, lớp 2 là processed knowledge, lớp 3 là CLAUDE.md định nghĩa cách Claude tương tác với 2 lớp trên. Hiểu rõ vai trò 3 lớp này giúp team thiết kế CLAUDE.md một cách có hệ thống, không phải viết tùy hứng mỗi lần cần thêm rule mới. Tham khảo thêm plugin Obsidian must-have cho dev để biết plugin nào hỗ trợ tốt việc quản lý CLAUDE.md trong vault lớn.

Quản Lý CLAUDE.md Cho Team VN Cần Lưu Ý Điều Gì?

Phần này tổng hợp 3 lưu ý quan trọng khi quản lý CLAUDE.md cho team product tại VN. Mỗi lưu ý đều rút ra từ kinh nghiệm thực chiến của các team đã triển khai thành công trong 6 tháng đầu năm 2026.

Lưu ý đầu tiên là về việc version CLAUDE.md qua git. Nhiều team chỉ lưu CLAUDE.md trong vault mà không có lịch sử thay đổi, khi file bị hỏng hoặc cần khôi phục về phiên bản cũ thì không có cách nào tìm lại. Pattern tốt nhất là version CLAUDE.md qua git repo riêng, mỗi thay đổi quan trọng đều được commit với message rõ ràng về lý do và tác động dự kiến. Đầu tư 10 phút mỗi lần cập nhật CLAUDE.md để viết commit message đầy đủ giúp team có lịch sử rõ ràng phục vụ phân tích và rollback khi cần.

Lưu ý thứ hai là về việc train team cách viết CLAUDE.md hiệu quả. CLAUDE.md tốt là file ngắn gọn, rõ ràng, không lặp lại các quy tắc đã có trong tài liệu chính thức của Claude. Nhiều người mới có xu hướng viết CLAUDE.md rất dài với nhiều rule chi tiết, dẫn đến Claude mất thời gian đọc file mà không thực sự áp dụng được các rule quan trọng nhất. Pattern khôn ngoan là giới hạn CLAUDE.md ở mức 500-1000 từ, tập trung vào các rule đặc thù của vault mà không có trong docs chính thức. Cách làm này đảm bảo Claude đọc và áp dụng đúng các rule quan trọng, không bị phân tán bởi quá nhiều thông tin không cần thiết.

Lưu ý cuối cùng là về việc review và update CLAUDE.md định kỳ hằng quý. Vault phát triển theo thời gian, các rule cũ có thể trở nên không còn phù hợp khi team thay đổi cách làm việc. Pattern khôn ngoan là đặt lịch review CLAUDE.md vào cuối mỗi quý, xem xét lại từng rule và quyết định giữ lại, sửa đổi, hoặc xóa bỏ. Đầu tư 1-2 giờ review mỗi quý giúp CLAUDE.md luôn phản ánh đúng cách làm việc hiện tại của team, tránh tình trạng Claude áp dụng các rule lỗi thời gây phản hồi không phù hợp với dự án.

Câu Hỏi Thường Gặp

CLAUDE.md có nên include code examples không?

Có nhưng giới hạn. Code example trong CLAUDE.md tốn nhiều token, nên giữ tối thiểu. Pattern tốt: link tới file external (ví dụ “code style examples ở wiki/style-guide.md“). Nếu phải include trong CLAUDE.md, giới hạn 3-5 dòng max per example. Quy tắc 300 dòng total áp dụng strict.

Tách Wiki Page Template ra file riêng có lợi không?

Có khi vault grow lớn. Tách wiki/template.md riêng + reference từ CLAUDE.md “Wiki Page Template details ở wiki/template.md” giảm đáng kể độ dài CLAUDE.md. Mình tách khi CLAUDE.md qua 200 dòng. Trade-off: Claude đọc thêm 1 file mỗi session, nhưng template thay đổi không cần touch CLAUDE.md.

Active Context update tự động được không?

Một phần. Claude có thể tự update Active Context cuối mỗi session với 3 dòng tóm tắt session vừa làm. Nhưng quyết định ưu tiên ngày mai vẫn cần user input. Workflow hybrid: Claude tự update phần “đã làm” + “đang dở”, user manual cập nhật phần “ưu tiên ngày mai” + “deadline gần”.

Có nên version control CLAUDE.md với Git?

Có. CLAUDE.md là single most important config file của vault. Git track lịch sử thay đổi schema, dễ revert nếu refactor sai. Mình commit CLAUDE.md mỗi lần update (~2-3 lần/tuần). Active Context section thay đổi hằng ngày, có thể skip hoặc commit batch cuối tuần.

CLAUDE.md có support multiple language không?

Có. Bạn viết CLAUDE.md bằng ngôn ngữ nào Claude hiểu ngôn ngữ đó. Mình viết section structure tiếng Anh (technical universal), Active Context tiếng Việt (cá nhân tự nhiên). Mix language hoạt động bình thường, không impact performance.

Khi vault scale lên 1000+ notes, CLAUDE.md cần update gì?

Thêm section “Search Strategy” hướng dẫn Claude khi nào dùng grep direct vs query qmd vs scan index. Thêm Tool Routing section chi tiết hơn (skill nào cho task gì). Tách Wiki Page Template ra file riêng. Update Active Context include “current vault size focus” ví dụ “tuần này focus vào wiki/concepts/, scope khác đợi tuần sau”.

Bạn Bắt Đầu Viết CLAUDE.md Từ Template Nào?

Bắt đầu với template gần với use case nhất, không cố hoàn hảo từ đầu. Personal research và blog → Template 1. Software project → Template 2. Freelance multi-client → Template 3. Daily journal creative → Template 4. Team shared → Template 5. Copy template, thay placeholder, save vào root vault, chạy claude để test.

Tuần đầu tiên focus duy trì Active Context update mỗi sáng. Tuần thứ hai test các Rules có activate đúng không (Claude follow conventions không). Tuần thứ ba refine: bỏ rules không dùng, thêm rules thấy thiếu. Đến tuần thứ tư bạn sẽ có CLAUDE.md fit chính xác workflow của mình.

Cluster Memory Pattern của ongboit gồm Karpathy LLM Wiki story, 3-layer architecture deep-dive, và daily notes research workflow, 3 bài này cung cấp full context cho việc dùng CLAUDE.md hiệu quả. Nếu chưa đọc, recommend đọc kèm để hiểu vì sao schema layer này quan trọng cho compound effect xảy ra.

Tài liệu tham khảo bên ngoài

• Claude Code Memory (CLAUDE.md) (Anthropic official), spec chính thức.
• Claude Code Overview, context model.