Điều gì đang xảy ra → nên làm gì

Gom mọi lần chạy test qua một wrapper script duy nhất, ghi toàn bộ output ra file log, và chỉ trả về cho AI phần tóm tắt các lỗi thất bại.

→ 読まなくなったもの 読まない技術 第1回：テスト結果を読まない技術

context window wrapper script fixed-prefix count line ([observed])

Dùng một PreToolUse hook chạy ngay trước khi ghi memory để bắt AI đọc checklist trước, và chỉ để lại đúng 1 dòng trong file chỉ dẫn (CLAUDE.md): "đọc trước khi ghi".

→ 読まなくなったもの 読まない技術 第2回：メモリを読まない技術

MEMORY.md loaded at session start context rot

Viết một chính sách 1 trang về mutation testing (cố tình phá code để xem test có bắt được không), và cho AI đọc nó mỗi khi bạn yêu cầu rà soát test.

→ 読まなくなったもの 読まない技術 第3回：単体テストを読まない技術

mutation testing positive control vacuous truth

Giữ nguyên lệnh dưới dạng script thông thường, dùng PreToolUse hook chặn các lần gọi sai, và chỉ AI đến đúng tài liệu cần đọc.

→ 読まなくなったもの 読まない技術 第4回：スキルを使わない技術

PreToolUse hook (Bash matcher) hook stderr + exit 2 mission

Định nghĩa bằng YAML những tác vụ nào được phép giao cho sub-agent và những file input nào phải có trước khi khởi chạy, rồi dùng hook kiểm tra điều đó trước khi bắt đầu.

→ 仕組みは一つ: 第 4 回と同じものを当てるだけ 読まない技術 第5回：サブエージェントの出力だけは読め

subagent (Agent tool) subagent (no parent context) contract (inputs / outputs / acceptance)

Chuyển từng rule kiểu "không được làm X" thành một automated test (Minitest) có thể phát hiện vi phạm, làm từng cái một.

→ 読まなくなったもの 読まない技術 第6回：ルールを読まない技術

CLAUDE.md Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop) hook contract (proof of reading)

Chuyển đúng file chính sách đó sang một PostToolUse hook và hiển thị nó cùng với diff ngay sau khi lưu. Giữ nguyên nội dung đọc, chỉ đổi thời điểm.

→ 読まなくなったもの 読まない技術 第7回：共有メモリを整理しない技術

MEMORY.md concurrent test runs hooks / automated tests

Tóm tắt chính sách retry thành vài dòng trong một file, và để hook phát hiện lỗi tự động chèn nó vào.

→ 読まなくなったもの 読まない技術 第8回：修正履歴を読まない技術

auto memory (feedback_*)

Mỗi lần đều đặt các con số lấy một cách máy móc — như từ git diff --stat — ngay cạnh báo cáo hoàn thành.

→ 読まなくなったもの 読まない技術 第9回：引き継ぎを読まない技術

handoff test summary line (full log in a file)

Gắn một tiền tố cố định vào dòng chứa con số, và dùng hook kiểm tra xem nó có được copy nguyên văn hay không.

→ 読まなくなったもの 読まない技術 第10回：AIに要約しろと言わない技術

machine-counted numbers ([observed] / git diff --stat) test summary line (full log in a file) self-report (bias toward completion)

Thay vì để người ngắt lời giữa chừng, hãy để một PostToolUse hook trả lại chính sách ngay sau khi lưu và một hook phát hiện lỗi rồi trả việc lại làm nhiệm vụ can thiệp. Người chờ đến mốc tự nhiên.

→ 言わなくなったもの 読まない技術 第11回：口を挟まない技術

user message during a task recency context window

Đừng đọc thành phẩm hay log làm việc — chỉ xét đạt/không đạt bằng exit code của test hoặc linter.

→ 読まなくなったもの 読まない技術 第12回：作業結果を読まない技術

self-report (bias toward completion) machine-counted numbers ([observed] / git diff --stat) exit code (pass / fail)

Gom mọi quyết định đã bị từ chối vào một tài liệu duy nhất, theo một định dạng cố định.

→ 説明しなくなったもの AIの意見を聞かない技術 第1回：提案を検討しない技術

Trong tài liệu duy nhất gom các quyết định đã bị từ chối (ví dụ non_goals.md), với mỗi điều cấm hãy thêm mục "lý do" đặt cạnh kết luận.

→ 思い出さなくなったもの AIの意見を聞かない技術 第2回：禁止を書かない技術

Trong tài liệu các quyết định bị từ chối, với mỗi điều cấm hãy thêm mục "phạm vi áp dụng" và liệt kê từng dòng các trường hợp biên gây khó phán đoán.

→ 相談されなくなったもの AIの意見を聞かない技術 第3回：禁止ルールを作らない技術

gap between goal pressure and spec rule-to-test mapping

Trong danh sách tác vụ được phép giao cho sub-agent, ghi rõ những file input cần chuẩn bị sẵn trước khi khởi chạy.

→ 仕組み: 用途カタログに、契約を書く AIの意見を聞かない技術 第4回：サブエージェントの入力だけは、確かめろ

subagent mission catalog + launch hook contract (inputs / outputs / acceptance) required input files

Trong tài liệu các quyết định bị từ chối, thêm mục "kiểm chứng bằng máy" vào danh sách và ghi rõ theo từng mục có automated test (Minitest) tương ứng hay không.

→ 読み直さなくなったもの AIの意見を聞かない技術 第5回：自動テストを書かない技術

probabilistic compliance (p^n)

Chuẩn bị sẵn một smoke test bằng Playwright, và xét đạt/không đạt dựa trên bản ghi còn lại trong DB thay vì nhìn giao diện.

→ 確認しなくなったもの AIの意見を聞かない技術 第6回：AIの確認依頼を断る技術

automatic error report from users

Thay vì người giải thích và sửa từng chỗ lệch, hãy ghi lời chỉ ra vào stderr của hook (exit 2) và vào thông báo lỗi của automated test, để đó là con đường nó đến được AI.

→ 指摘しなくなったもの AIの意見を聞かない技術 第7回：AIの話を聞かない技術

SendMessage (retry)

Thêm mục "đề xuất không áp dụng" ở cuối tài liệu các quyết định bị từ chối, và ghi lại các đề xuất bị từ chối vào đó.

→ 整理しなくなったもの AIの意見を聞かない技術 第8回：ルールを整理しない技術

MEMORY.md context rot

Dùng một automated test để đối chiếu xem mọi lệnh mà file chỉ dẫn ghi là "nhất định phải chạy" có thực sự tồn tại trong pre-commit hook hay không.

→ 頼まなくなったもの 言わない技術 第1回：検証を指示しない技術

CLAUDE.md Minitest hooks / automated tests

Thay vì chỉ dẫn cả quy trình, định nghĩa theo từng mục đích sử dụng những file input phải tồn tại trước khi khởi chạy sub-agent.

→ 書かなくなったもの 言わない技術 第2回：具体的な指示を出さない技術

per-mission guide document presupposition launch without a contract

Đặt một form báo lỗi, để người dùng chỉ cần gõ đúng một câu mô tả triệu chứng, còn URL, lịch sử thao tác và thông tin trình duyệt để JavaScript tự thu thập.

→ 書かなくなったもの 言わない技術 第3回：不具合詳細を書かない技術

bug report form (JS collects URL / actions / browser)

Không cần thêm gì mới. Chỉ cần đặt sẵn một tài liệu thiết kế, AI sẽ đọc các tài liệu có sẵn và làm theo đúng thể thức đó.

→ 要求しなくなったもの 言わない技術 第4回：計画を書けと言わない技術

Bỏ việc đo hiệu quả — thay vào đó đếm số dòng dùng cách nhấn mạnh trong file chỉ dẫn, và đặt một automated test (ratchet) báo lỗi khi con số đó vượt ngưỡng.

→ 押さなくなったもの 言わない技術 第5回：念を押さない技術

emphasis count in CLAUDE.md sycophancy Dir.glob scan

Với mỗi mục đích sử dụng sub-agent, định nghĩa điều kiện chấp nhận cho thành phẩm — tên file, định dạng, các trường bắt buộc — trong một tài liệu duy nhất.

→ 仕組み: 完了の形を、1 枚に書き切る 言わない技術 第6回：サブエージェントの出力だけは、細かく指示しろ

subagent (Agent tool) contract (inputs / outputs / acceptance) self-report (bias toward completion)

Thay vì hỏi vặn, cố định câu thứ hai của mỗi yêu cầu thành mẫu câu hỏi "chẳng phải ... hay sao?".

→ 打たなくなったもの 言わない技術 第7回：AI を問い詰めない技術

sycophancy

Thay vì tự chỉ ra, đưa các điều cấm không kèm phương án thay thế qua một PostToolUse hook, hiển thị cùng diff ngay sau khi lưu.

→ 言わなくなったもの 言わない技術 第8回：AI にダメ出ししない技術

SendMessage (retry) guarded_by + marker over-triggering

Bắt AI ghi các marker tương ứng ở cả tài liệu được tham chiếu lẫn trong code, rồi dùng automated test kiểm chứng rằng các marker đó thực sự tồn tại.

→ 考えさせなくなったもの 言わない技術 第9回：AI に考えさせない技術

hallucination escape hatch (SKIP_*= / --no-verify) marker

Ngừng trả lời ngay lập tức — thu xếp để việc lựa chọn được quyết định bởi automated test hoặc hook.

→ 答えなくなったもの 言わない技術 第10回：質問に答えない技術

Dùng một automated test bên ngoài để đếm số lượng, nhằm phát hiện automated test nào quét file nhưng không có assertion chặn dưới về số lượng (ví dụ assert_operator ... :>=).

→ させなくなったもの 言わない技術 第11回：AI にレビューをさせない技術

Minitest vacuous truth Dir.glob scan

Trước khi kiểm tra màn hình, bắt trả lời hai câu hỏi — "đang xác minh điều gì" và "vì sao cách rẻ hơn không đủ" — và đặt sẵn một hướng dẫn 1 trang ưu tiên thử cách rẻ nhất trước, theo thứ tự unit test → integration test → E2E.

→ 眺めなくなったもの 確かめない技術 第1回：スクリーンショットを撮らない技術

Playwright screenshot verification ladder (unit → integration → E2E) verification declaration file + PreToolUse hook

Trước khi chụp màn hình hay chạy E2E, hãy bắt viết một file khai báo nêu rõ đang xác minh điều gì (ví dụ tmp/visual_verification.md), biến sự tồn tại của nó thành điều kiện của một PreToolUse hook, và không có nó thì chụp màn hình hay E2E không được khởi động.

→ 読まなくなったもの 確かめない技術 第2回：宣言を信じない技術

verification declaration file + PreToolUse hook Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop) PreToolUse hook (Bash matcher)

Thêm tùy chọn --last vào wrapper script của test để phát lại log lần trước, khỏi cần chạy lại.

→ 待たなくなったもの 確かめない技術 第3回：テストを再実行しない技術

--last (replay the previous result) mtime check expensive entry point (screenshot / E2E / production)

Cho wrapper script của test lấy một exclusive lock (dựa vào tính nguyên tử của mkdir), và không chạy nếu không lấy được lock.

→ 生まれなくなったもの 確かめない技術 第4回：偽の失敗を読まない技術

flaky failure mkdir lock concurrent test runs

Gắn tag theo tên khu vực cho các E2E nặng, mặc định skip chúng, và mỗi lần đều in ra danh sách các khu vực chưa chạy.

→ 走らせなくなったもの 確かめない技術 第5回：全部走らせない技術

E2E area (E2E=<area>) skipped-area count line pass / fail by DB record

Khi muốn quy trình được tuân thủ, đừng viết chỉ dẫn mạnh hơn — thay vào đó đổi cách làm để dấu vết của việc tuân theo quy trình đó lưu lại trong thành phẩm (ví dụ: in ra 1 dòng cho mỗi file đã mở).

→ 書き直さなくなったもの 動かさない技術 第1回：手順を守らせない技術

sycophancy file existence check tool_use count

Khi muốn wrapper được dùng, đừng viết chỉ dẫn mạnh hơn — thay vào đó kiểm tra xem có còn lý do phải quay lại lệnh gốc không (tức là wrapper còn thiếu chức năng gì).

→ 書き直さなくなったもの 動かさない技術 第2回：ラッパーを使わせない技術

wrapper script the raw command the model defaults to workaround after exit 2

Trước khi gộp nhiều câu trả lời thành một, in ra số lần xuất hiện của từng loại nhận xét — bao nhiêu trong số bao nhiêu đã nêu ra điều đó.

→ 集めなくなったもの 動かさない技術 第3回：集めない技術

one subagent run answer key

Đừng viết chỉ dẫn có điều kiện kiểu "nếu cần thì hãy làm X" — thay vào đó bắt buộc bước đó bằng một hook chặn không cho đi tiếp nếu chưa qua bước đó.

→ 書かなくなったもの 動かさない技術 第4回：役に立たない技術

rule-to-test mapping Claude Code hooks (PreToolUse / PostToolUse / Stop / SubagentStop) file existence check

Thay vì trả lại với câu "hãy suy nghĩ lại lần nữa", chỉ ra cụ thể tiền đề nào đang sai.

→ 選び直させなくなったもの 動かさない技術 第5回：選び直させない技術

sycophancy SendMessage (retry) guarded_by + marker

Đừng chỉ đưa ra điều cấm — kèm theo cả một đầu ra thay thế, kiểu như "nếu không có trường hợp nào phù hợp thì hãy in ra 'không áp dụng'".

→ 塞がなくなったもの 動かさない技術 第6回：逃げ道を塞がない技術

escape hatch (SKIP_*= / --no-verify) hooks + automated tests + ratchet hallucination

Kết thúc phiên làm việc tại mỗi mốc hoàn thành tác vụ, và bắt đầu tác vụ tiếp theo trong một phiên mới.

→ 続けなくなったもの 動かさない技術 第7回：セッションを続けない技術

context window input / output / cache read tokens sycophancy

Khi thành phẩm đã hoàn tất, chạy một script để tổng hợp một lần chính bản thân work log (transcript).

→ 見なくなったもの 動かさない技術 第8回：成果物で判断しない技術

file existence check machine-counted numbers ([observed] / git diff --stat) Dir.glob scan

Đừng ghi kiến thức vào tài liệu — hãy nhúng nó vào thông báo lỗi của automated test hoặc thông báo dừng của hook, để nó hiện ra đúng vào lúc cần.

→ 残さなくなったもの 動かさない技術 第9回：知見を残さない技術

handoff MEMORY.md mtime check

Đếm từ work log số lần đọc liên tiếp mà không thay đổi gì cả, và viết một dòng điều kiện dừng trước khi bắt đầu đào sâu.

→ 深追いしなくなったもの 追わない技術 第1回：深追いしない技術

machine-counted numbers ([observed] / git diff --stat) input / output / cache read tokens Dir.glob scan

Giao cùng một tác vụ cho cả mô hình rẻ lẫn mô hình đắt, rồi chỉ quyết định sau khi đếm riêng số lượt cho tới khi hoàn thành, cùng lượng đọc mới, lượng dùng lại (cache read) và lượng viết ra.

→ 既定にしなくなったもの 追わない技術 第2回：一番安いモデルを使わない技術

rule-to-test mapping Minitest machine-counted numbers ([observed] / git diff --stat)

Giao cùng một tác vụ cho cả mô hình đắt và mô hình rẻ, rồi biến những chỗ chỉ mô hình rẻ bị hỏng thành một kiểm tra cố định.

→ 乗り換えなくなったもの 追わない技術 第3回：最新モデルを使わない技術

rule-to-test mapping Minitest machine-counted numbers ([observed] / git diff --stat)

Trước khi giao việc, xem xem agent cha đã có sẵn tiền đề đó chưa. Nếu có rồi thì tiếp tục làm ở agent cha; chỉ giao cho sub-agent phần đọc khối lượng lớn mà agent cha chưa có.

→ 渡さなくなったもの 追わない技術 第4回：サブエージェントを使わない技術

subagent (Agent tool) context window input / output / cache read tokens

Chỉ giao cho mỗi sub-agent lượng việc vừa đủ trả lời trong một lượt phản hồi. Yếu tố quyết định chi phí không phải là số lượng sub-agent, mà là mỗi sub-agent sau khi chia phải qua lại với agent cha bao nhiêu lượt.

→ 割らなくなったもの 追わない技術 第5回：エージェントチームを使わない技術

subagent (Agent tool) input / output / cache read tokens machine-counted numbers ([observed] / git diff --stat)

Chờ đến mốc tự nhiên của công việc rồi mới đưa yêu cầu bổ sung vào, với phạm vi đã thu hẹp. Khi hỏi chính AI về chỗ thiếu, luôn thêm câu: "nếu đã đủ thì hãy nói rõ là đã đủ". Đó là lối thoát (escape hatch) để nó không phải bịa ra một chỗ thiếu.

→ 差し込まなくなったもの 追わない技術 第6回：途中でレビューさせない技術

subagent (Agent tool) instruction priority (position / recency / system vs user) over-triggering

Trước khi bắt đầu so sánh mô hình, đếm xem việc so sánh đó tốn công bằng bao nhiêu hook hay automated test. Nếu số cơ chế có thể viết ra nhiều hơn con số đó, hãy đặt chúng vào trước rồi mới so sánh.

→ 比べなくなったもの 追わない技術 第7回：モデルを選ばない技術

input / output / cache read tokens rule-to-test mapping

Trước khi kết thúc bằng "không thấy khác biệt", đếm hai điều: nếu có kết quả bị loại khỏi tổng hợp (chẳng hạn các sub-agent thất bại) thì đưa lại vào và đếm lại; nếu hơn một nửa số mục đều bằng 0 ở mọi điều kiện thì đổi cách diễn đạt tác vụ rồi đo lại.

→ 諦めさせなくなったもの 追わない技術 第8回：諦めさせない技術

machine-counted numbers ([observed] / git diff --stat) vacuous truth