SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor · Cập nhật ngày 2026-10-26

Vì sao coding agent bỏ qua chỉ dẫn của bạn

Rule bảo agent dừng nhưng nó vẫn làm? Tìm 4 nguyên nhân: chưa vào context window, quá mơ hồ, bị mâu thuẫn hoặc nằm quá xa turn hiện tại.

Vì sao coding agent bỏ qua chỉ dẫn của bạn

Coding agent bỏ qua chỉ dẫn của bạn vì 4 lý do, và không lý do nào là do bạn quá lịch sự. Rule đó chưa bao giờ xuất hiện trong context window. Rule quá mơ hồ nên không thể dùng để kiểm tra một hành động. Một nội dung khác trong context mâu thuẫn với rule đó, thường là code mà agent vừa đọc. Hoặc rule vẫn được load nhưng nằm quá xa turn hiện tại, còn agent đang dựa vào những gì ở gần.

Mỗi nguyên nhân có cách xử lý riêng, nên việc đầu tiên là phân biệt chúng. Viết hoa hoặc dùng từ IMPORTANT không giúp chẩn đoán nguyên nhân. Phần dưới đây dùng Claude Code làm ví dụ, vì hành vi load và compaction của công cụ này được tài liệu hóa chi tiết tính đến tháng 10/2026. Các công cụ khác có khác biệt về chi tiết nhưng nhìn chung hoạt động theo cùng nguyên tắc.

Trước hết cần làm rõ 2 thuật ngữ. Context window là khối văn bản model nhìn thấy trong một turn cụ thể: system prompt, các file chứa instruction của bạn, conversation và mọi file agent đã đọc. Harness là chương trình chạy bên ngoài model, chịu trách nhiệm đọc file từ disk và tạo khối văn bản đó. Gần như mọi phàn nàn trong bài này thực chất là phàn nàn về harness, không phải model.

Tệp instruction của bạn là một message, không phải setting

Tệp instruction không phải là configuration. Không có thành phần nào trong runtime đọc CLAUDE.md rồi thực thi nó. Harness đọc tệp từ disk và dán nội dung vào conversation. Trong Claude Code, nội dung đó được gửi dưới dạng user message nằm sau system prompt. Vì vậy, model nhìn thấy các rule của bạn giống như mọi nội dung khác mà bạn nhập vào.

Điều này dẫn đến một hệ quả không dễ chịu. Các rule của bạn phải cạnh tranh với mọi phần văn bản khác trong cửa sổ, trên cùng một mặt bằng. Một rule chỉ là một nhận định. Tệp mà agent vừa mở là bằng chứng. Khi hai bên mâu thuẫn, bằng chứng thường chiếm ưu thế. Không có lỗi nào được báo, vì theo góc nhìn của model thì không có gì sai xảy ra.

Tài liệu chính thức nêu rõ điều này: các tệp instruction được xử lý như context, không phải configuration được thực thi. Nếu muốn chặn một action bất kể model quyết định gì, bạn cần một hook, không phải một câu lệnh. Hãy ghi nhớ ý này. Phần lớn các cách khắc phục ở cuối bài đều áp dụng ý này cho một trường hợp cụ thể.

Các file hướng dẫn được load như thế nào và khi nào

Claude Code duyệt ngược lên cây thư mục từ thư mục bạn bắt đầu chạy. Mọi CLAUDE.md và CLAUDE.local.md từ root của filesystem xuống đến thư mục làm việc của bạn đều được load toàn bộ khi khởi chạy. Chúng được nối tiếp theo thứ tự đó, vì vậy file nằm gần vị trí bạn chạy lệnh nhất sẽ được đọc sau cùng, và trong cùng một thư mục, file .local được thêm vào sau file chính.

Các file trong thư mục con bên dưới thư mục làm việc của bạn hoạt động khác. Chúng không được load khi khởi chạy. Chúng chỉ được load khi agent đọc một file trong thư mục đó. Điều tương tự cũng áp dụng cho các quy tắc theo phạm vi đường dẫn trong .claude/rules/ có chứa trường frontmatter paths:: chúng chỉ đi vào context khi một file khớp với đường dẫn được đọc, chứ không phải trong mọi lượt hội thoại. Kể từ v2.1.309, các file được load theo cách này cũng có giới hạn kích thước trên mỗi file (40.000 ký tự trên cửa sổ context 200K), và agent chỉ nhận được phần đầu của các file dài, vì vậy các quy tắc nằm gần cuối một file lồng nhau lớn có thể không bao giờ được đưa vào context.

Sự khác biệt đó giải thích phần lớn các lỗi được báo cáo. Bạn đặt một quy tắc trong packages/api/CLAUDE.md, bạn hỏi một câu về API, và agent trả lời mà không hề mở file nào bên dưới packages/api/. Quy tắc đó không bị bỏ qua. Nó chưa bao giờ tồn tại trong context. Nếu repository của bạn chia nhỏ hướng dẫn theo các file hướng dẫn cho từng package trong monorepo, đây là điều đầu tiên cần kiểm tra mỗi khi gặp lỗi.

Một bẫy load file khác ảnh hưởng đến các repository đã chuẩn hóa theo AGENTS.md. Kể từ v2.1.277, Claude Code mặc định đọc AGENTS.md làm hướng dẫn dự án, nhưng chỉ khi không có CLAUDE.md, .claude/CLAUDE.md hoặc CLAUDE.local.md trong thư mục làm việc của bạn hoặc bất kỳ thư mục nào bên trên nó (file ~/.claude/CLAUDE.md cá nhân của bạn không được tính). Nếu thêm bất kỳ file nào trong số đó, ngay cả một file CLAUDE.local.md để ghi chú cá nhân, Claude Code sẽ đọc các file CLAUDE.md của bạn thay thế và bỏ qua hoàn toàn AGENTS.md. Để load cả hai, hãy đặt Project instructions thành claude-md-and-agents-md trong /config. Trên các phiên bản trước v2.1.277, hoặc khi bạn muốn giữ lại CLAUDE.md, giải pháp là dùng một CLAUDE.md với dòng đầu tiên là @AGENTS.md, lệnh này sẽ import file khi khởi chạy, cùng với bất kỳ ghi chú cụ thể nào cho Claude ở bên dưới. Một symlink cũng có tác dụng tương tự khi bạn không có gì thêm để bổ sung. Việc quyết định nội dung nào nên nằm trong file đó là một vấn đề riêng biệt, được đề cập trong tách biệt hướng dẫn cho agent và tài liệu cho con người.

Xác nhận file đã được tải trước khi sửa

Không thay đổi nội dung cho đến khi bạn xác nhận agent có thể đọc file. Có 2 bước kiểm tra. Hãy thực hiện bước đơn giản trước.

Chạy /context bên trong session. Lệnh này in ra cửa sổ hiện tại theo từng danh mục. Danh sách Memory files hiển thị tên mọi file hướng dẫn được tải khi khởi động. Nếu file không có trong danh sách này, file đó chưa được tải khi khởi động. Vì vậy, mọi nội dung bạn viết trong file sẽ không có tác dụng cho đến khi có thành phần tải file đó. File lồng nhau trong thư mục con không xuất hiện ở đây vì chúng được tải on demand. Khi được tải, một dòng Loaded kèm đường dẫn của file sẽ xuất hiện trong terminal. /memory liệt kê vị trí các file và mở chúng để chỉnh sửa, kể cả những file chưa tồn tại.

Để có kết quả chắc chắn hơn, hãy ghi log quá trình tải file. Hook event InstructionsLoaded chạy mỗi khi một CLAUDE.md hoặc file rules được đưa vào context. Matcher của event cho biết lý do file được tải: session_start, nested_traversal, path_glob_match, include hoặc compact. Thêm nội dung sau vào .claude/settings.json:

{
  "hooks": {
    "InstructionsLoaded": [
      {
        "matcher": "nested_traversal",
        "hooks": [
          {
            "type": "command",
            "command": "cat >> /tmp/instructions-loaded.log"
          }
        ]
      }
    ]
  }
}

Hook nhận payload dưới dạng JSON qua standard input, nên cat sẽ nối toàn bộ record vào cuối file. Theo dõi file bằng tail -f /tmp/instructions-loaded.log trong khi làm việc. Exit status của event này bị bỏ qua, nên hook chỉ có thể quan sát và không thể chặn. Nếu file lồng nhau không bao giờ xuất hiện trong log trong một session mà bạn dự kiến file phải được tải, hãy dừng việc sửa câu chữ. Vấn đề nằm ở vị trí file. Có một ngoại lệ: AGENTS.md được Claude Code đọc trực tiếp sẽ không kích hoạt event này. Thay vào đó, hãy tìm đường dẫn của file trong /memory. AGENTS.md được import từ CLAUDE.md vẫn kích hoạt event như bình thường.

Ảnh hưởng của phiên làm việc dài đến các quy tắc của bạn

Có hai hiệu ứng riêng biệt xảy ra ở đây và chúng cần các cách xử lý khác nhau.

Khoảng cách. Cho đến khi quá trình nén (compaction) diễn ra, một quy tắc được nêu ở lượt 1 vẫn nằm trong cửa sổ ngữ cảnh tại lượt 90, lúc này phải cạnh tranh với 90 lượt văn bản mới hơn và cụ thể hơn với những gì bạn đang làm hiện tại. Sau khi quá trình nén đã chạy, một quy tắc bạn chỉ nhập vào khung chat có thể không còn nằm trong cửa sổ ngữ cảnh nữa: tài liệu của Claude Code cảnh báo rằng các hướng dẫn từ đầu cuộc hội thoại có thể bị mất, đây chính là hiệu ứng thứ hai bên dưới. Bạn không thể cấu hình để loại bỏ khoảng cách, nhưng bạn có thể đo lường nó. Hãy chạy cùng một tác vụ trong một phiên làm việc mới. Nếu quy tắc vẫn hoạt động ở đó nhưng thất bại khi ở sâu trong một phiên làm việc dài, thì khoảng cách hoặc quá trình nén chính là nguyên nhân.

Nén (Compaction). Khi cửa sổ ngữ cảnh đầy, hệ thống sẽ tóm tắt cuộc hội thoại cho đến thời điểm đó và tiếp tục từ bản tóm tắt đó. Những gì còn sót lại là những gì bộ tóm tắt đánh giá là quan trọng, không giống với những gì bạn coi là quan trọng. Claude Code ghi lại kết quả theo từng cơ chế và sự khác biệt là rất lớn. Project root CLAUDE.md và các quy tắc không được định phạm vi (unscoped) sẽ được nạp lại từ đĩa sau khi nén. Auto memory cũng được nạp lại từ đĩa. Các quy tắc có frontmatter paths: sẽ bị mất cho đến khi một tệp khớp với nó được đọc lại. Các tệp CLAUDE.md lồng nhau trong các thư mục con sẽ bị mất cho đến khi một tệp trong thư mục con đó được đọc lại.

Hãy xếp hạng các hướng dẫn của bạn theo bảng đó và thứ tự độ bền sẽ lộ diện. Một quy tắc bạn chỉ nhập vào khung chat là thứ dễ mất nhất trong phiên làm việc: nó chỉ tồn tại nếu bản tóm tắt tình cờ giữ lại nó. Một quy tắc trong packages/api/CLAUDE.md đứng tiếp theo, vì nó đã được tải một lần, bị tóm tắt loại bỏ và chỉ quay lại khi có lần đọc tiếp theo trong thư mục đó. Một quy tắc trong tệp project root là bền vững nhất, vì nó được đọc lại từ đĩa mỗi lần.

Vì vậy, nếu một hướng dẫn bắt buộc phải duy trì trong suốt cả phiên làm việc, nó phải nằm trong tệp project root và không có frontmatter paths:. Mọi thứ khác đều là sự đánh đổi mà bạn nên chủ động thực hiện. Quản lý những gì lưu lại trong cửa sổ ngữ cảnh đề cập đến /compact với tham số focus và /clear giữa các tác vụ không liên quan, cả hai đều thay đổi tần suất bộ tóm tắt quyết định các quy tắc của bạn là gì.

Vì sao code xung quanh có sức nặng hơn rule

Đây là lỗi mọi người mô tả thường xuyên nhất nhưng lại chẩn đoán ít nhất. File của bạn nói rằng việc truy cập database phải đi qua repository layer. Agent viết một handler gọi trực tiếp ORM (object relational mapper). Agent không bỏ qua bạn vì lý do style. Nó bị bằng chứng áp đảo.

Rule mô tả một lựa chọn ưu tiên. Code thể hiện một lựa chọn cụ thể. Khi agent mở 3 file trong module mà nó sắp chỉnh sửa và cả 3 file đều gọi trực tiếp ORM, context có 1 câu trừu tượng ở một phía và 3 ví dụ cụ thể, mới và phù hợp với task ở phía còn lại. Sao chép pattern cục bộ thường là hành vi đúng. Trong trường hợp này, nó chỉ sai vì bạn biết một điều mà context không biết: các file đó là code legacy.

Vì vậy, hãy ghi rõ điều đó trong rule. Rule tự nêu bằng chứng phản bác sẽ đứng vững khi áp dụng vào repository thực tế. Rule chỉ nêu một lựa chọn ưu tiên chung chung thì không.

Cách truy cập database mới phải đi qua app/repositories/. Các file trong app/legacy/ vẫn gọi trực tiếp ORM. Đó là code cũ, không phải pattern cần dùng. Không được sao chép pattern đó.

Câu thứ 2 mới là phần quyết định. Nó cho agent biết trước điều nó sắp thấy và cách diễn giải điều đó. Cách sửa tương tự áp dụng cho mọi rule mà repository của bạn rõ ràng không tuân theo: style của commit mà lịch sử repository không dùng, cấu trúc test mà một nửa test suite bỏ qua, hoặc quy ước import chỉ được áp dụng trong code mới. Bất cứ nơi nào code không khớp với file, hãy ghi rõ sự không khớp đó trong file.

Quy tắc mơ hồ không thể kiểm tra, nên cũng không thể tuân thủ

"Viết code sạch." "Không over-engineer." "Giữ mọi thứ đơn giản." "Cẩn thận khi migration." Không câu nào trong số này có thể được kiểm tra dựa trên một hành động cụ thể, dù do agent hay do bạn thực hiện. Agent nhận một quy tắc mà nó không thể dùng để kiểm tra output của chính mình sẽ phải đoán, còn bạn thì đánh giá phỏng đoán đó theo cảm nhận.

Hãy áp dụng phép kiểm tra sau cho từng dòng trong file. Viết lệnh shell sẽ thoát với mã khác 0 khi quy tắc bị vi phạm. Nếu không thể viết lệnh đó, quy tắc không thể kiểm tra được. So sánh các cặp sau:

  • Không thể kiểm tra: "Giữ các function ngắn." Có thể kiểm tra: "Function dài hơn 60 dòng phải có một comment ngay phía trên giải thích lý do."
  • Không thể kiểm tra: "Test các thay đổi." Có thể kiểm tra: "Chạy npm test và dán số lượng lỗi trước khi đánh dấu task là hoàn tất."
  • Không thể kiểm tra: "Giữ các file có tổ chức." Có thể kiểm tra: "HTTP handler nằm trong src/api/handlers/. Không có nội dung nào khác được đặt trong directory đó."
  • Không thể kiểm tra: "Format code đúng cách." Có thể kiểm tra: "Dùng indentation 2 space trong các file .ts."

"Không over-engineer" là quy tắc mà mọi người thường bỏ cuộc đầu tiên, vì cách sửa không phải là viết một câu ngắn hơn mà là viết một câu dài hơn: nêu rõ thay đổi nhỏ nhất thực sự đáp ứng yêu cầu sẽ cung cấp cho agent các tiêu chí để tự đối chiếu với diff của nó.

Kích thước cũng là cùng một vấn đề dưới dạng khác. Hướng dẫn của Claude Code khuyến nghị mỗi instruction file nên dưới 200 dòng và nói rõ rằng file dài hơn làm giảm mức độ tuân thủ. File 700 dòng không phải là instruction chặt chẽ hơn. Đó là 700 dòng nhận định, với nhiều khả năng mâu thuẫn với nhau hơn; đồng thời toàn bộ nội dung đó bị tính vào window của bạn trong từng turn, nên thể hiện trực tiếp trong mức sử dụng token của bạn. Việc cấu trúc file để mỗi quy tắc nằm dưới một heading mà người đọc có thể quét nhanh được trình bày trong cách viết instruction file để agent có thể thực thi. Tốt hơn nữa, hãy cắt những phần chỉ mô tả thay vì đưa ra instruction: sơ đồ directory cho biết handler và model nằm ở đâu là thông tin về cấu trúc mà agent có thể tra cứu khi cần từ map đã parse của repository, thay vì phải mang theo trong window ở mỗi turn.

Cách chẩn đoán trong mười phút

Hãy chạy các lệnh này theo thứ tự. Việc nhảy cóc đến bước cuối cùng là lý do khiến người dùng tạo ra một danh sách dài các quy tắc cứng nhắc nhưng vẫn không hoạt động.

  1. Xác nhận file đã được load. Chạy /context và đọc danh sách các file Memory, hoặc đối với file lồng nhau, hãy tìm dòng Loaded của nó trong terminal. Nếu file không xuất hiện, hãy sửa lại vị trí và dừng lại. Các bước còn lại trong danh sách này chưa áp dụng được.
  2. Tái hiện trong một session mới. Bắt đầu một session mới và thực hiện tác vụ nhỏ nhất mà lẽ ra phải kích hoạt quy tắc đó. Nếu thành công ở đây nhưng thất bại trong một session dài, vấn đề nằm ở khoảng cách hoặc quá trình compaction. Nếu vẫn thất bại ở đây, bản thân quy tắc đó chính là vấn đề.
  3. Loại bỏ sự cạnh tranh. Yêu cầu thay đổi tương tự trong một thư mục mà mã nguồn hiện tại đã tuân thủ quy tắc. Nếu sự tuân thủ quay trở lại, mã nguồn xung quanh đã ghi đè lên yêu cầu của bạn.
  4. Tìm kiếm xung đột. Hai file đưa ra hướng dẫn khác nhau cho cùng một hành vi là một lỗi đã được ghi nhận: model có thể chọn ngẫu nhiên một trong hai và nó sẽ không thông báo cho bạn biết.
  5. Làm cho quy tắc có thể kiểm tra được và kiểm tra lại. Viết lại quy tắc với một đường dẫn cụ thể và một điều kiện rõ ràng. Nếu mức độ tuân thủ tăng vọt, nguyên nhân nằm ở cách diễn đạt của bạn.

Bước 4 chỉ là một lệnh. Hãy grep mọi nguồn hướng dẫn cho chủ đề đó, không chỉ file bạn đang chỉnh sửa:

grep -rni "migration" --include="CLAUDE.md" --include="CLAUDE.local.md" --include="AGENTS.md" .
grep -rni "migration" .claude/rules/ ~/.claude/CLAUDE.md ~/.claude/rules/ 2>/dev/null

Kết quả khớp trong hai file với nội dung khác nhau chính là lỗi của bạn. Hãy xóa một file. Đừng cố gắng xếp hạng chúng bằng cách dùng từ ngữ mạnh hơn, vì không có engine xếp hạng nào để xử lý việc đó. Trên Claude Code v2.1.283 trở lên, /doctor prompt-audit sẽ chạy một phiên bản tìm kiếm rộng hơn trên các file hướng dẫn, quy tắc và kỹ năng của bạn, sau đó báo cáo các mâu thuẫn kèm theo đề xuất chỉnh sửa mà không thay đổi bất cứ điều gì cho đến khi bạn yêu cầu.

Các phương án khắc phục, theo thứ tự hiệu quả

Mỗi bước dưới đây có hiệu quả cao hơn bước trước đó nhưng tốn công thiết lập hơn. Hãy bắt đầu từ trên cùng khi quy tắc dễ dàng thay đổi. Chuyển xuống dưới ngay khi quy tắc đủ quan trọng để không thể chấp nhận việc bỏ sót.

  1. Cụ thể hóa quy tắc. Nêu rõ đường dẫn, lệnh hoặc điều kiện. Thêm bằng chứng phản bác mà agent sẽ tìm thấy trong repository như đã trình bày trước đó. Cách này miễn phí và giải quyết được một lượng lớn các trường hợp.
  2. Di chuyển quy tắc đến gần đối tượng quản lý. Một CLAUDE.md lồng nhau, một quy tắc giới hạn phạm vi đường dẫn trong .claude/rules/, hoặc một chú thích ngay đầu file. Quy tắc sẽ xuất hiện cùng lúc với mã nguồn mà nó áp dụng. Chấp nhận đánh đổi: bất kỳ nội dung nào được tải theo cách này sẽ bị loại bỏ ở lần nén tiếp theo và quay lại ở lần đọc khớp tiếp theo.
  3. Chuyển việc thực thi vào một hook. Văn bản chỉ là yêu cầu. Hook mới là thứ quyết định. Hook chạy như mã nguồn tại các sự kiện vòng đời cố định và áp dụng bất kể model kết luận thế nào.
  4. Giao quy tắc cho một công cụ tất định và xóa bỏ văn bản hướng dẫn. Định dạng, thứ tự import, độ dài dòng, các import bị cấm, cấu trúc commit message. ruff format, prettier --write, eslint, một hook pre-commit. Công cụ định dạng luôn đúng và tốn 0 token. Câu lệnh chỉ đúng phần lớn thời gian và tốn token mỗi lần thực hiện.

Chi tiết bước 3. Giả sử các file migration không bao giờ được phép bị agent chỉnh sửa. Hãy đặt nội dung này vào .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard-migrations.sh"
          }
        ]
      }
    ]
  }
}

Và nội dung này vào .claude/hooks/guard-migrations.sh:

#!/usr/bin/env bash
set -euo pipefail

path=$(jq -r '.tool_input.file_path // empty')

case "$path" in
  */migrations/*)
    echo "Files under migrations/ are written by hand. Stop and ask first." >&2
    exit 2
    ;;
esac

exit 0

Chạy chmod +x .claude/hooks/guard-migrations.sh, sau đó bắt đầu một phiên làm việc mới và yêu cầu agent chỉnh sửa một file nằm trong migrations/. Yêu cầu chỉnh sửa sẽ bị từ chối và thông báo của bạn sẽ được trả về làm lý do. Trạng thái thoát 2 trên PreToolUse chặn lệnh gọi công cụ trước khi nó chạy, và văn bản stderr của bạn được chuyển đến model như một thông báo chặn. ${CLAUDE_PROJECT_DIR} phân giải đến root của dự án, vì vậy hook hoạt động bất kể agent đang ở thư mục nào. Agent không cần phải đồng ý với quy tắc, ghi nhớ quy tắc hay giữ quy tắc trong ngữ cảnh. Việc chỉnh sửa sẽ không xảy ra.

Đối với lệnh cấm tuyệt đối không kèm logic, permissions.deny trong cài đặt của bạn thực hiện công việc tương tự mà không cần duy trì script, và các chế độ quyền quyết định những gì được chạy mà không cần hỏi bạn trước. Nếu một chỉ dẫn thực sự cần nằm ở cấp độ system prompt thay vì trong tin nhắn người dùng, --append-system-prompt sẽ đặt nó ở đó, mặc dù đây là một flag khởi chạy cần được truyền lại trong mỗi phiên mới, điều này phù hợp với các script hơn là làm việc tương tác.

Điều bạn không thể chỉ dẫn để loại bỏ

Hãy phân biệt rõ phần nào thuộc về bạn. Vị trí đặt, cách diễn đạt, xung đột giữa các file và kích thước file là vấn đề của tác giả, nên tác giả phải sửa. Phần còn lại là hành vi của model, và cách diễn đạt tốt hơn sẽ không loại bỏ được.

Đồng ý không có nghĩa là tuân thủ. Agent có thể xác nhận một rule, nhắc lại chính xác rule đó với bạn, rồi vi phạm chỉ 2 lần gọi tool sau. Việc xác nhận không tốn gì và không dự đoán được điều gì. Đừng xem đó là bản sửa lỗi và đừng tính nó là một lần kiểm thử.

Một số thói quen có tính dai dẳng. Thêm comment, thêm xử lý lỗi phòng thủ, viết phần tóm tắt kết thúc, chạy command hiển nhiên tiếp theo. Những hành vi này sẽ quay lại khi có rule cấm chúng, chỉ giảm tần suất chứ không về 0. Bạn có thể đo tần suất của mình: chạy cùng một task 10 lần trong các session mới rồi đếm số lần vi phạm. Nếu con số đó cần bằng 0, rule phải được đưa ra khỏi prompt. Gọi một job là đã hoàn tất trong khi vẫn còn phần chưa làm cũng có cùng dạng thói quen này. Cách sửa phải mang tính cấu trúc thay vì chỉ bằng câu chữ: skill unlazy thay câu đó bằng một Depth Tree và các file gate mà agent phải vượt qua trước khi được phép xác nhận đã hoàn tất.

Session của chính bạn sẽ trở thành một ví dụ. Nếu agent vi phạm rule ở turn 12 mà bạn bỏ qua, vi phạm đó sẽ nằm trong context dưới dạng một ví dụ, và nó mới hơn rule rất nhiều. Hãy sửa vi phạm ngay khi bạn thấy. Một vi phạm không được sửa sẽ dạy cho phần còn lại của session.

Instruction file không phải security boundary. Nó định hình hành vi nhưng không thực thi hành vi đó. Bất cứ thứ gì mà việc bỏ sót gây hậu quả nghiêm trọng, chẳng hạn credentials hoặc destructive commands, phải được xử lý bằng permissions hoặc hook. Giữ secrets ngoài tầm với của agent áp dụng cùng nguyên tắc đó cho dữ liệu: đừng yêu cầu agent không đọc một file; hãy sắp xếp để file đó không thể được đọc.

Tóm lại: hãy chứng minh file đã được load, biến rule thành thứ có thể kiểm tra, đặt rule cạnh đối tượng mà nó chi phối, và khi miss rate vẫn còn quan trọng, hãy đưa rule ra khỏi prose. Một rule mà agent không thể bỏ qua là một rule vốn chưa từng được yêu cầu agent tuân thủ.

FAQ

Tại sao Claude Code bỏ qua CLAUDE.md của tôi?

Hãy kiểm tra xem file đã được tải hay chưa trước khi kết luận là nó bị bỏ qua. Chạy /context và xem danh sách Memory files; nếu file không có tên trong danh sách đó thì file chưa được tải khi khởi động. Các file chỉ dẫn được gửi dưới dạng user message sau system prompt và được xử lý như context thay vì cấu hình bắt buộc, nên không có bảo đảm tuân thủ tuyệt đối. Hầu hết trường hợp thực tế thuộc một trong bốn nguyên nhân: file nằm trong một subdirectory mà agent chưa đọc, hai file mâu thuẫn và model chọn một file một cách ngẫu nhiên, rule quá mơ hồ để đối chiếu với một hành động, hoặc code xung quanh thể hiện điều ngược lại với rule.

Việc sửa file chỉ dẫn giữa session có thay đổi gì không?

Không thay đổi bản sao đã có trong conversation. Các file nằm phía trên working directory được tải đầy đủ khi khởi động, nên nội dung model đang giữ là nội dung tại thời điểm khởi động. Để cập nhật thay đổi, hãy bắt đầu session mới hoặc yêu cầu agent đọc file bằng các file tool thông thường. Cách này đưa phiên bản hiện tại vào conversation dưới dạng message mới. Sau khi compact, file trong project root được đọc lại từ disk, nên phiên bản mới cũng được đưa vào lúc đó.

File nào được ưu tiên khi CLAUDE.md ở root và file lồng nhau có nội dung mâu thuẫn?

Không file nào được ưu tiên một cách đáng tin cậy. Các file được phát hiện sẽ được nối vào context thay vì ghi đè lẫn nhau. Chúng được sắp xếp từ filesystem root xuống working directory, nên file gần nhất chỉ được đọc sau cùng. Không có precedence engine để xử lý mâu thuẫn, và tài liệu của Claude Code nêu rõ rằng các rule mâu thuẫn có thể được giải quyết một cách ngẫu nhiên. Hãy viết các file lồng nhau dưới dạng phần bổ sung và ghi rõ path mà chúng áp dụng. Xóa phần mâu thuẫn thay vì cố đặt rule này cao hơn rule kia.

Các instruction của tôi có tồn tại sau /compact không?

Điều đó phụ thuộc vào cách chúng được tải. File ở project root CLAUDE.md, các rule không giới hạn phạm vi và auto memory được chèn lại từ disk sau khi compact. Các rule có frontmatter paths: và các file CLAUDE.md lồng trong subdirectory sẽ bị mất cho đến khi một file phù hợp được đọc lại. Bất kỳ nội dung nào bạn chỉ nhập trong chat chỉ còn lại nếu summariser tình cờ giữ nó. Nếu một rule phải có hiệu lực trong toàn bộ session, hãy đặt rule đó trong file ở project root và không dùng frontmatter paths:.

Khi nào nên chuyển một rule thành hook thay vì viết thành văn bản?

Khi việc kiểm tra mang tính deterministic và chi phí bỏ sót cao hơn chi phí viết một script nhỏ. Các trường hợp phù hợp gồm giới hạn file path, các command bắt buộc trước khi commit và các tool call bị cấm. Một hook PreToolUse thoát với status 2 sẽ chặn hoàn toàn tool call và gửi nội dung stderr cho model làm lý do, nên rule vẫn có hiệu lực dù không còn xuất hiện trong context. Bất kỳ việc gì formatter hoặc linter có thể tự quyết định thì nên giao cho tool đó và xóa hoàn toàn khỏi file chỉ dẫn.

Bài viết này có hữu ích không?