Cách xây dựng thư mục ngữ cảnh thương hiệu cho Claude Code

Thư mục ngữ cảnh thương hiệu cung cấp cho Claude giọng điệu, các dấu ấn thiết kế và ICP của bạn, đảm bảo mọi sản phẩm đầu ra đều mang đậm dấu ấn cá nhân. Dưới đây là cách tạo một thư mục như vậy trong 30 phút.

Thư mục ngữ cảnh thương hiệu thực chất là gì?

Hãy tưởng tượng nó như tài liệu hướng dẫn bạn đưa cho một người viết hoặc thiết kế tự do mới vào ngày đầu tiên. Nhưng thay vì một file PDF chỉ được đọc lướt qua một lần rồi quên, nó nằm trong thư mục dự án của bạn, nơi Claude đọc nó mỗi khi cần.

Trong Claude Code, bạn có thể đặt các file ngữ cảnh trong thư mục gốc dự án và tham chiếu chúng một cách rõ ràng trong prompt của mình, hoặc sử dụng file CLAUDE.md mà Claude tự động chọn làm ngữ cảnh cố định. Cả hai cách tiếp cận đều hiệu quả — điều quan trọng là thông tin phải được cấu trúc, cụ thể và nhất quán.

Một thư mục ngữ cảnh thương hiệu hoàn chỉnh thường bao gồm:

• Tài liệu về giọng văn và phong cách — cách bạn viết, những gì bạn nên tránh và các ví dụ về cả sản phẩm tốt và xấu
• Tài liệu về token thiết kế — màu sắc, kiểu chữ, khoảng cách và các biến số hình ảnh khác ở định dạng mà Claude có thể tham chiếu
• Tài liệu về định vị — khách hàng lý tưởng (ICP), đề xuất giá trị, sự khác biệt cạnh tranh và hệ thống phân cấp thông điệp
• Tài liệu về ví dụ — các mẫu văn bản thực tế minh họa hoạt động của thương hiệu

Mỗi file đều là plaintext hoặc Markdown. Không yêu cầu định dạng đặc biệt. Mục tiêu là làm cho kiến ​​thức thương hiệu ngầm định trở nên rõ ràng đến mức AI (hoặc một nhân viên mới) có thể hành động dựa trên đó mà không cần phải đoán.

Bước 1: Xây dựng tài liệu về giọng văn và phong cách

Giọng văn là phần khó nhất để làm đúng, vì vậy hãy bắt đầu từ đây.

Xác định các thuộc tính giọng văn cốt lõi

Chọn 3 đến 5 tính từ mô tả cách thương hiệu của bạn nghe như thế nào — không phải cách bạn muốn nó được cảm nhận, mà là cách bài viết tốt nhất của bạn thực sự được đọc. Hãy trung thực. “Chuyên nghiệp” gần như vô dụng. “Trực tiếp và hơi khô khan, giống như một kỹ sư cấp cao đang giải thích điều gì đó” sẽ khả thi hơn.

Với mỗi thuộc tính, hãy viết hai ví dụ: một ví dụ thể hiện thuộc tính đó và một ví dụ thể hiện thuộc tính đó không đạt yêu cầu.

Ví dụ về định dạng:

THUỘC TÍNH GIỌNG NÓI: Trực tiếp

TỐT: "Bạn cần thêm API key trước khi chức năng này hoạt động."
SAI: "Để tiếp tục quy trình này, bạn cần đảm bảo đã thực hiện các bước cần thiết để cấu hình cài đặt API key của mình."

THUỘC TÍNH GIỌNG NÓI: Chuyên môn kỹ thuật

TỐT: "Agent chạy theo lịch trình cron 15 phút."
SAI: "Agent chạy thường xuyên trong nền."

Cấu trúc trước/sau này hữu ích hơn một đoạn mô tả vì Claude có thể đối sánh mẫu với các ví dụ cụ thể.

Ghi lại những điều bạn không bao giờ nói

Giọng điệu thương hiệu không chỉ bao gồm mà còn cả việc loại trừ. Hãy lập danh sách các từ, cụm từ và cấu trúc câu mà thương hiệu của bạn tránh sử dụng.

Các danh mục phổ biến cần đề cập:

• Từ bị cấm — thuật ngữ chuyên ngành bạn ghét, từ ngữ không phù hợp với thương hiệu, thuật ngữ của đối thủ cạnh tranh
• Cấu trúc bị cấm — không bao giờ sử dụng thể bị động, không bao giờ mở đầu bằng câu hỏi, không bao giờ sử dụng dấu chấm đầu dòng cho nội dung cảm xúc
• Giọng điệu bị cấm — đừng nịnh hót, đừng sử dụng dấu chấm than, đừng viết như một thông cáo báo chí

Nếu bạn đã lập danh sách từ bị cấm cho nhóm của mình, hãy dán nó vào. Nếu không, hãy dành 5 phút để liệt kê những điều khiến bạn khó chịu khi thấy chúng trong văn bản.

Thiết lập mức độ trang trọng và trình độ đọc

Hãy cụ thể về cách dùng từ. "Thân mật nhưng chuyên nghiệp" là quá mơ hồ. Hãy thử cách sau:

MỨC ĐỘ ĐỌC HIỂU: Hướng đến khả năng đọc hiểu lớp 8-10 (điểm số trên ứng dụng Hemingway khoảng 70)
ĐỘ DÀI CÂU: Trung bình 14-18 từ. Kết hợp các câu ngắn gọn, súc tích với các câu dài hơn một chút.
ĐỘ DÀI ĐOẠN VĂN: Tối đa 2-4 câu trong phần nội dung chính. Một câu cũng được.
ĐẠI TỪ: Sử dụng "bạn" và "chúng ta". Tránh sử dụng "ai đó" và các cấu trúc ngôi thứ ba.

Claude phản hồi tốt với các ràng buộc về số lượng. "Đoạn văn ngắn" là không rõ ràng. "2-4 câu" sẽ khả thi hơn.

Thêm ví dụ thực tế

Chọn 5 đến 10 đoạn nội dung tốt nhất hiện có của bạn — một email, một phần trang đích, một mô tả sản phẩm, một bài đăng trên mạng xã hội. Dán chúng nguyên văn vào một phần có tên là VÍ DỤ CHUẨN.

Bước 2: Chuyển đổi nhận diện hình ảnh thành token thiết kế

Đây là bước mà hầu hết mọi người thường bỏ qua. Họ thêm các hướng dẫn về giọng nói nhưng quên rằng Claude thường cần tạo code, viết thông số kỹ thuật thiết kế hoặc mô tả các phương pháp xử lý hình ảnh — và nếu không có thông tin về nhận diện hình ảnh, nó sẽ mặc định chọn các lựa chọn chung chung.

Token thiết kế là câu trả lời. Chúng chỉ là các biến được đặt tên cho các quyết định hình ảnh của bạn.

Màu sắc

Ghi lại bảng màu của bạn bằng mã hex, với các nhãn phản ánh cách sử dụng chứ không phải tên màu:

COLORS:
--color-primary: #1A1A2E
--color-secondary: #16213E
--color-accent: #0F3460
--color-highlight: #E94560
--color-background: #FAFAFA
--color-text-primary: #1A1A2E
--color-text-secondary: #6B7280
--color-success: #10B981
--color-warning: #F59E0B
--color-error: #EF4444

Nếu bạn có bảng màu chế độ tối, hãy ghi chú riêng bằng quy ước tiền tố --dark.

Cũng cần lưu ý các quy tắc sử dụng:

QUY TẮC SỬ DỤNG MÀU SẮC:
- Màu nhấn chỉ dành cho các nút kêu gọi hành động (CTA). Không bao giờ sử dụng cho mục đích trang trí.
- Không bao giờ đặt văn bản trực tiếp lên màu highlight.
- Nền phải luôn sáng trong các quy trình giới thiệu người dùng mới.

Kiểu chữ

Ghi chú hệ thống kiểu chữ của bạn với đủ chi tiết để Claude có thể tạo CSS hoặc viết các thông số kỹ thuật thiết kế chính xác:

TYPOGRAPHY:
Font families:
  --font-heading: 'Inter', sans-serif
  --font-body: 'Inter', sans-serif
  --font-mono: 'JetBrains Mono', monospace

Scale (desktop):
  --text-xs: 12px / 1.5
  --text-sm: 14px / 1.5
  --text-base: 16px / 1.6
  --text-lg: 18px / 1.5
  --text-xl: 20px / 1.4
  --text-2xl: 24px / 1.3
  --text-3xl: 30px / 1.2
  --text-4xl: 36px / 1.1

Weight usage:
  Headings: 700 (bold)
  Subheadings: 600 (semibold)
  Body: 400 (regular)
  Labels/captions: 500 (medium)

Khoảng cách, bán kính và bóng đổ

Những yếu tố này quan trọng hơn hầu hết mọi người nghĩ. Nếu thiếu chúng, Claude sẽ tạo ra các thành phần trông không nhất quán về mặt hình ảnh với sản phẩm thực tế của bạn.

SPACING (base unit: 4px):
  --space-1: 4px
  --space-2: 8px
  --space-3: 12px
  --space-4: 16px
  --space-6: 24px
  --space-8: 32px
  --space-12: 48px
  --space-16: 64px

BORDER RADIUS:
  --radius-sm: 4px
  --radius-md: 8px
  --radius-lg: 12px
  --radius-full: 9999px

SHADOWS:
  --shadow-sm: 0 1px 2px rgba(0,0,0,0.05)
  --shadow-md: 0 4px 6px rgba(0,0,0,0.07)
  --shadow-lg: 0 10px 15px rgba(0,0,0,0.10)

Quy tắc sử dụng logo và asset

Claude không thể nhìn thấy logo của bạn, nhưng nó có thể tuân theo các quy tắc về cách tham chiếu hoặc mô tả logo trong văn bản và code:

CÁCH SỬ DỤNG LOGO:
- Logo chính: bố cục ngang (logo + tên thương hiệu)
- Phiên bản chỉ có biểu tượng: sử dụng khi chiều rộng < 120px
- Khoảng trống tối thiểu: bằng chiều cao của biểu tượng ở tất cả các cạnh
- Không bao giờ đặt trên nền quá nhiều chi tiết
- Nền được chấp nhận: trắng, --màu chính, --màu nền
- Không bao giờ kéo giãn, xoay hoặc đổi màu

Bước 3: Ghi lại định vị và hồ sơ khách hàng lý tưởng (ICP)

Định vị là nơi Claude có xu hướng trở nên chung chung nhanh chóng. Nếu không có hướng dẫn rõ ràng, nó sẽ viết cho một khách hàng trung bình giả định — chứ không phải người mua thực tế của bạn.

Xác định khách hàng lý tưởng của bạn

Hãy cụ thể. Không phải “các công ty SaaS B2B” mà là:

HỒ SƠ KHÁCH HÀNG LÝ TƯỞNG:

CHÂN DUNG CHÍNH: "Người sáng lập thiên về vận hành"
- Quy mô công ty: 5–50 nhân viên
- Ngành nghề: Dịch vụ chuyên nghiệp, công ty quảng cáo hoặc SaaS
- Vai trò: Người sáng lập hoặc Trưởng bộ phận Vận hành
- Vấn đề cốt lõi: Dành hơn 15 giờ/tuần cho các nhiệm vụ đáng lẽ có thể tự động hóa
- Mức độ quen thuộc với công nghệ: Sử dụng các công cụ như Notion, Airtable, Zapier. Không phải là nhà phát triển.
- Điều họ lo sợ: Mất kiểm soát chất lượng khi mở rộng quy mô
- Điều họ muốn: Không còn là nút thắt cổ chai mà không cần tuyển thêm người
- Cách họ nói: Tập trung vào kết quả. Không kiên nhẫn với thuật ngữ chuyên ngành. Hoài nghi về sự cường điệu.

Nếu bạn có nhiều chân dung khách hàng, hãy ghi lại thông tin của từng đối tượng với cùng một cấu trúc. Sau đó, thêm ghi chú về đối tượng nào là chính cho loại nội dung nào (ví dụ: “Nội dung trang đích nhắm mục tiêu Đối tượng A. Chuỗi email nhắm mục tiêu Đối tượng B”).

Viết tuyên bố định vị của bạn

Sử dụng định dạng có cấu trúc mà Claude có thể tham khảo trực tiếp:

ĐỊNH VỊ:

Dành cho [những người sáng lập có nhiều công việc vận hành tại các doanh nghiệp dịch vụ nhỏ]
Những người đang gặp khó khăn với [việc dành quá nhiều thời gian cho công việc lặp đi lặp lại làm chậm sự phát triển của họ]
[MindStudio] là một [công cụ xây dựng AI agent không cần code lập trình]
Cho phép [những người không chuyên về kỹ thuật tạo ra các quy trình làm việc tự động trong vòng chưa đầy một giờ]
Không giống như [các công cụ tự động hóa truyền thống như Zapier hoặc Make]
Chúng tôi [kết nối khả năng suy luận của AI với các công cụ kinh doanh thực tế của bạn, để các agent có thể xử lý những tác vụ nhiều bước phức tạp, chứ không chỉ là các trình kích hoạt đơn giản]

Định dạng này buộc phải rõ ràng. Nếu bạn không thể điền vào một cách mạch lạc, tuyên bố định vị của bạn vẫn chưa sẵn sàng — điều này rất hữu ích để biết trước khi bạn gửi nó cho Claude.

Thêm thứ tự ưu tiên thông điệp

Không phải mọi thông điệp đều xứng đáng được chú trọng như nhau. Hãy cho Claude biết nên dùng những tuyên bố nào làm trọng tâm và nên bỏ qua những tuyên bố nào:

THỨ TỰ PHÂN CẤP THÔNG ĐIỆP:

Cấp 1 (dẫn đầu bằng những điều này):
- Tốc độ xây dựng: hầu hết các quy trình làm việc mất 15-60 phút
- Không cần code lập trình: được xây dựng cho người dùng không chuyên về kỹ thuật
- Suy luận AI thực sự: không chỉ là các quy tắc kích hoạt hành động

Cấp 2 (các tuyên bố hỗ trợ):
- Hơn 200 mô hình AI có sẵn
- Hơn 1.000 tích hợp
- Được sử dụng bởi các nhóm tại TikTok, Microsoft, Adobe

Cấp 3 (đề cập khi có liên quan):
- Miễn phí khi bắt đầu
- Hỗ trợ JavaScript/Python tùy chỉnh cho người dùng chuyên về kỹ thuật
- Hỗ trợ các mô hình cục bộ

NHỮNG TUYÊN BỐ CẦN TRÁNH:
- Không bao giờ nói "tốt nhất" hoặc "duy nhất"
- Không bao giờ so sánh trực tiếp bằng tên trừ khi được hỏi
- Không nên bắt đầu bằng giá cả

Bối cảnh cạnh tranh

Cung cấp cho Claude đủ bối cảnh để viết nội dung khác biệt mà không mang tính miệt thị:

BỐI CẢNH CẠNH TRANH:
Chúng tôi thường được so sánh với Zapier, Make và n8n.
Những điểm khác biệt chính cần nêu ra nếu được hỏi:
- Những công cụ đó dựa trên hành động kích hoạt. Chúng tôi được thiết kế cho suy luận AI đa bước.
- Chúng yêu cầu đăng ký AI riêng và thiết lập API. Chúng tôi đã tích hợp sẵn.
- Chúng tôi dễ dàng xây dựng hơn cho người dùng không chuyên về kỹ thuật.
Giọng điệu khi đề cập đến đối thủ cạnh tranh: tôn trọng, khách quan, không coi thường.

Bước 4: Lắp ráp cấu trúc thư mục

Bây giờ hãy ghép các thư mục lại với nhau. Đây là bố cục thư mục gọn gàng:

/brand-context/
  CLAUDE.md ← file chỉ mục chính mà Claude đọc đầu tiên
  voice-and-tone.md ← Thuộc tính giọng điệu, quy tắc, ví dụ
  design-tokens.md ← Màu sắc, kiểu chữ, khoảng cách, bóng
  positioning.md ← ICP, tuyên bố định vị, hệ thống phân cấp thông điệp
  copy-examples.md ← 5-10 mẫu nội dung chuẩn
  competitive-context.md ← Bối cảnh cạnh tranh và sự khác biệt

Viết một file CLAUDE.md chính

Đây là file mà Claude tự động chọn trong Claude Code. Sử dụng nó như một chỉ mục cho Claude biết nội dung của từng file và khi nào cần tham chiếu đến chúng:

# Chỉ mục bối cảnh thương hiệu

Thư mục này chứa các hướng dẫn về thương hiệu của [Tên công ty].
Luôn tham khảo các file này trước khi tạo bất kỳ nội dung, văn bản hoặc giao diện người dùng nào.

## Các file trong thư mục này:

- `voice-and-tone.md` — Cách chúng tôi viết. Hãy đọc điều này trước khi tạo bất kỳ nội dung nào.
- `design-tokens.md` — Các biến trực quan. Hãy sử dụng chúng cho tất cả các công việc thiết kế giao diện người dùng.
- `positioning.md` — ICP, định vị và thứ bậc thông điệp. Tham khảo khi viết nội dung tiếp thị.
- `copy-examples.md` — Những ví dụ thực tế về phong cách thương hiệu của chúng tôi trong thực tiễn.
- `competitive-context.md` — Cách xử lý việc so sánh với đối thủ cạnh tranh.

## Tham khảo nhanh:

Màu sắc thương hiệu chính: #1A1A2E
Phông chữ chính: Inter
Văn bản kêu gọi hành động chính: "Bắt đầu xây dựng miễn phí"
Giọng điệu thương hiệu trong ba từ: Trực tiếp. Cụ thể. Đáng tin cậy.

Bước 5: Kiểm tra, tinh chỉnh và bảo trì

Việc xây dựng thư mục chiếm 80% công việc. 20% còn lại là quá trình lặp lại.

Chạy prompt hiệu chỉnh

Trước khi sử dụng thư mục trong công việc thực tế, hãy chạy thử nghiệm. Yêu cầu Claude tạo ra một đoạn nội dung mà nó chưa từng thấy trước đây — mô tả sản phẩm, email ngắn, chuỗi văn bản siêu nhỏ trên giao diện người dùng — và so sánh nó với các ví dụ chuẩn của bạn.

Hãy tự hỏi:

• Giọng điệu có khớp không?
• Các quyết định về hình ảnh có nhất quán với các token thiết kế không?
• Thông điệp có đặt đúng cấp độ không?
• Điều gì cảm thấy không ổn?

Sau đó, cập nhật file liên quan để giải quyết bất cứ điều gì còn thiếu.

Thêm quy tắc trường hợp ngoại lệ khi bạn tìm thấy chúng

Mỗi khi Claude làm điều gì đó cảm thấy không ổn, hãy ghi lại quy tắc có thể ngăn chặn điều đó. Theo thời gian, thư mục của bạn sẽ trở thành cơ sở kiến ​​thức về mọi quyết định thương hiệu đã từng xuất hiện.

Điều này đặc biệt hữu ích cho:

• Các loại nội dung bạn chưa đề cập đến (Câu hỏi thường gặp, thông báo lỗi, nội dung thông báo)
• Các trường hợp đặc biệt về giọng điệu (cách viết về giá cả, cách xử lý tin xấu)
• Ngữ cảnh kỹ thuật (cách đặt tên biến, cách viết chú thích code)

Cập nhật thường xuyên

Hướng dẫn thương hiệu có thể thay đổi. Khi bạn cập nhật thông điệp hoặc làm mới hệ thống thiết kế, hãy cập nhật thư mục ngữ cảnh cùng lúc. Một thư mục ngữ cảnh thương hiệu lỗi thời còn tệ hơn là không có – Claude sẽ tự tin tạo ra kết quả lỗi thời.

Đặt lời nhắc hàng quý để xem lại từng file. Chỉ mất 20 phút nếu bạn đã duy trì việc này, và nó rất đáng giá.