- File andrej-karpathy-skills đạt 106.000 stars chỉ sau vài tháng - một markdown file không có dòng code nào.
- 4 nguyên tắc cốt lõi được báo cáo tăng độ chính xác của AI từ 65% lên 94%.
- Không chỉ dành cho developer - writer, marketer, researcher đều có thể dùng ngay hôm nay trong 2 phút.
TL;DR
Ngày 27/1/2026, developer Forrest Chang tạo một file markdown 65 dòng lên GitHub. File không có một dòng code nào. Chỉ có 4 nguyên tắc viết bằng tiếng Anh thông thường. Trong 24 giờ đầu: gần 9.300 stars. Đến tháng 5/2026: 106.000 stars, 10.500 forks, xếp hạng #337 toàn cầu trên GitHub.
Tên file: CLAUDE.md. Mục đích: dạy AI cách làm việc với bạn - thay vì bắt đầu từ zero mỗi session.
Khi 80% workflow chuyển sang AI
Ngày 26/1/2026 - một ngày trước khi repo được tạo - Andrej Karpathy đăng một tweet. Ông mô tả điều vừa xảy ra với workflow của mình: chỉ trong vài tháng, ông chuyển từ 80% code tay + 20% AI agent sang 80% AI agent + 20% chỉnh sửa. Đây là sự thay đổi lớn nhất trong hai thập kỷ lập trình của ông.
Nhưng kèm theo đó là 3 vấn đề ông gặp phải với AI agents:
- Đoán thay vì hỏi - AI tự chọn một interpretation và chạy luôn, không confirm
- Over-engineer mọi thứ - viết 1.000 dòng khi 100 dòng là đủ, thêm abstraction không ai yêu cầu
- Chỉnh code không liên quan - bạn nhờ fix 1 bug, AI rewrite cả file, xóa comments, đổi naming
Forrest Chang đọc tweet đó, chuyển 3 vấn đề thành 4 nguyên tắc, viết vào một file markdown. Repo forrestchang/andrej-karpathy-skills ra đời.
Không chỉ dành cho lập trình viên
Đây là điểm quan trọng nhất mà hầu hết bài viết về CLAUDE.md bỏ qua: file này hoạt động cho bất kỳ ai dùng Claude thường xuyên.
Vấn đề cốt lõi không phải là code - mà là bộ nhớ. Mỗi session Claude mới là một trang trắng. Không nhớ tên bạn, không nhớ dự án, không nhớ văn phong, không nhớ những gì bạn đã từng yêu cầu. Bạn tốn 5-10 phút đầu mỗi buổi để re-explain, hoặc nhận được output không khớp với cách bạn làm việc.
CLAUDE.md đọc tự động mỗi khi mở session. Nó là thẻ nhớ vĩnh viễn của dự án:
- Writer - lock in giọng văn cụ thể, Claude không bao giờ viết generic lại
- Marketer - define audience, Claude hiểu đang viết cho ai và không generalize
- Researcher - quy định cách tổ chức thông tin theo ý muốn
- Business owner - đưa full context công ty vào, mọi output fit thực tế của bạn
4 nguyên tắc cốt lõi - trái tim của file
File gốc của Forrest Chang chỉ có 4 nguyên tắc. Đây là những gì chúng thực sự làm:
| Nguyên tắc | Rule | Vấn đề giải quyết |
|---|---|---|
| Think Before Coding | Don't assume. Ask. | AI tự đoán intent, chạy sai hướng |
| Simplicity First | Minimum code. Nothing speculative. | Over-engineer, 1.000 dòng thay vì 100 |
| Surgical Changes | Touch only what you must. | Rewrite cả file khi fix 1 bug |
| Goal-Driven Execution | Give success criteria, not commands. | Output mơ hồ, không verifiable |
Nguyên tắc thứ 4 đặc biệt mạnh: thay vì nói "fix cái bug này", bạn nói "viết test reproduce bug đó, sau đó làm test đó pass". AI có thể loop tự kiểm tra kết quả mà không cần bạn can thiệp từng bước.
Một số nguồn báo cáo rằng 4 nguyên tắc này cải thiện coding accuracy từ 65% lên 94% - tuy nhiên methodology chưa được công bố đầy đủ, nên nên xem đây là tín hiệu định hướng hơn là benchmark cứng.
21 quy tắc - từ communication đến memory
Post viral của @anatolikopadze mở rộng thêm 17 quy tắc nữa cho mọi Claude users, chia thành 4 nhóm:
Cách Claude giao tiếp (1-4): Xóa filler phrases ("Great question!"), show 2-3 options trước khi làm, thú nhận khi không chắc, match độ dài response với task complexity.
Hành vi Claude (5-8): Confirm trước khi đổi lớn, chỉ sửa đúng những gì được yêu cầu, báo cáo những gì đã thay đổi, không bao giờ gửi email hay post lên mạng xã hội mà không xin phép.
Context của bạn (9-11): Khai báo background, dự án đang làm, và giọng văn riêng. Đây là những gì biến Claude từ generic assistant thành người cộng tác hiểu bạn thật sự.
Memory & continuity (12-15): Maintain file MEMORY.md lưu mọi quyết định quan trọng, ghi session summary, log những approach đã fail để không lặp lại, và list permanent facts luôn đúng với dự án của bạn.
Sự thật phía sau 106.000 stars
106.000 stars không phải là bằng chứng của technical sophistication. Đó là bằng chứng của sự thất vọng lan rộng.
Trên Reddit, cộng đồng Claude Code có một thuật ngữ riêng: "the confident junior dev" - AI nhanh, thông minh, nhưng tự tin quá mức và hay mắc sai lầm ngây thơ nếu không được giám sát. 106.000 người star cái repo đó vì họ nhận ra mình cần guardrails - không phải vì file quá phức tạp.
Một số điểm cần biết trước khi dùng:
- CLAUDE.md là behavioral context, không phải code - AI follow theo kiểu probabilistic, không phải deterministic. Claude Code thậm chí có thể ignore file nếu nó thấy không relevant.
- Quá 200 dòng: model bắt đầu ignore rules đồng đều, kể cả rules quan trọng.
- Karpathy không viết file này - Forrest Chang viết, lấy cảm hứng từ tweet của Karpathy. Tên repo là marketing decision.
- Dùng CLAUDE.md để enforce code formatting = sai. Đó là việc của linter (Biome, Prettier), không phải AI.
Bắt đầu trong 2 phút
Cài file gốc (4 nguyên tắc Karpathy) vào project của bạn:
curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.mdSau đó mở file, thêm 3-4 quy tắc phù hợp nhất với workflow của bạn từ danh sách 21 quy tắc. Đừng copy tất cả - less is more. File càng ngắn, Claude càng follow nghiêm.
Và đây là insight thực sự phía sau 106.000 stars: vấn đề không nằm ở file. Vấn đề là khoảng cách rất lớn giữa AI có thể làm gì và AI thực sự làm đúng những gì bạn muốn. CLAUDE.md thu hẹp khoảng cách đó - một chút. Phần còn lại vẫn cần better model training, better evaluation, và người dùng hiểu rõ mình muốn gì.
Nguồn: forrestchang/andrej-karpathy-skills, antigravity.codes, Alex Rusin Blog.