DESIGN.md, AGENTS.md, SKILL.md: agent specification cho cả team, best practice và tầng user, tầng project

Tilde Thurium và Annie Wang giải thích DESIGN.md, AGENTS.md, SKILL.md, benchmark AGENTS.md của Agentic AI Foundation và cách chia preference theo tầng.

Đã duyệt độc lập · cập nhật 21/11/2026 · 13 min

1. Agent specification là gì, và vì sao cần: "stop repeating yourself"

Video là cuộc trò chuyện giữa hai người của Google Cloud: Tilde Thurium, làm Developer Marketing, và Annie Wang, Software Engineer (theo thẻ tên trong video đăng ngày 08/10/2026).

Annie Wang và Tilde Thurium ngồi hai bên một bàn gỗ, mỗi người một micro, thẻ tên hiện bên dưới
Annie Wang (bên trái) và Tilde Thurium (bên phải) trong studio; thẻ tên ghi Annie Wang, Software Engineer, Google Cloud và Tilde Thurium, Developer Marketing, Google Cloud (video đăng ngày 08/10/2026).

Tilde mở đầu: AGENTS.md, SKILL.md và DESIGN.md là những file markdown tĩnh, cho agent của bạn context về thứ bạn đang cố build và cách bạn muốn build nó. Gộp lại, có thể gọi chung các file này là agent specification. Hai người sẽ đi vào chi tiết từng file sau, nhưng trước hết Tilde hỏi Annie: vì sao chúng ta cần agent specification (video đăng ngày 08/10/2026)?

Annie đáp "Yeah, that's a good question", rồi đưa ra một hình dung: hãy nghĩ như bạn đang onboard một kỹ sư mới vào team. Coding agent giống như người kỹ sư mới đó, dù họ biết code. Nhưng bạn cần cho họ context: project của bạn nói về gì, làm việc với nhau ra sao, có những file nào được động vào và không được động vào, chạy test cụ thể thế nào, viết test mới thế nào. Tất cả những project guidance đó (video đăng ngày 08/10/2026).

Annie nói bạn muốn chia sẻ những điều này với coding agent của mình, nhưng không muốn chia sẻ đi chia sẻ lại cho từng task một. Giải pháp là ghi chúng xuống một file, để bạn không phải lặp lại. Và ở mỗi task, agent luôn có thể tham chiếu tới guidance này để giúp bạn viết code (theo Annie, video đăng ngày 08/10/2026).

Slide Reusable project guidance as context: ba ô đầu vào nối vào một ô Coding agent
Slide "Reusable project guidance as context" lúc Annie nói về việc ghi guidance vào file: ba ô "Today's request" (Add a dashboard filter), "Project instructions" (Use existing components • run tests) và "Other context" (Relevant code • tool results • history), qua mũi tên "Selected by the tool / harness" đi vào ô "Coding agent: Work on this task" (slide trong video đăng ngày 08/10/2026).

Tilde nói: "Yes, stop repeating yourself", đừng lặp lại chính mình nữa. Có tiếng đáp "Yeah".

2. Khác gì prompt engineering: theo Annie, rất gần nhau

Tilde hỏi: vậy agent specification khác với prompt engineering ư? Annie đáp thật ra chúng rất gần nhau, gần như là một (about the same). Theo chị, prompt engineering là bạn liên tục cải thiện và tinh chỉnh prompt của mình (video đăng ngày 08/10/2026).

Ví dụ của Annie: bạn bảo agent "hey, can you add this button to the front end page?", thêm nút này vào trang front end giúp tôi. Rồi bạn muốn nó cụ thể hơn, chi tiết hơn: "tôi muốn thêm nút này vào trang front end, và nút này dùng component library của tôi". Làm như vậy là bạn đang cải thiện prompt cho cụ thể hơn (video đăng ngày 08/10/2026). Ô prompt hiện lên trong lúc Annie nói về ví dụ này ghi (video đăng ngày 08/10/2026):

Add this button to the frontend page.

Rồi Annie hỏi tiếp: nếu bạn muốn mỗi lần thêm một nút, nút đó luôn lấy từ component library này thì sao? Khi đó, bạn gần như đang chia sẻ điều này như một project guidance trong file AGENTS.md. Thế là mỗi lần tạo một nút, nó tự động được lấy từ component library, và bạn không phải lặp lại điều đó hết lần này tới lần khác. Theo Annie, chúng rất gần với prompt engineering (video đăng ngày 08/10/2026).

Một cửa sổ nhỏ hiện nội dung file AGENTS.md với mục Front end, đè lên cảnh hai người đang nói chuyện
Cửa sổ hiện một đoạn AGENTS.md trong lúc Annie nói về component library: tiêu đề "# AGENTS.md", mục "## Front end" và một dòng quy tắc về Button component (video đăng ngày 08/10/2026).

Nội dung file trên cửa sổ đó (video đăng ngày 08/10/2026):

# AGENTS.md

## Front end
- Use the existing Button component from our library anytime a new button is added.

3. Theo Annie, một phần của context engineering

Tilde hỏi tiếp: vậy cái này khác gì context engineering? Annie nói thêm một câu: "I know we have a lot of engineering nowadays", dạo này có nhiều loại engineering quá.

Annie trả lời: thật ra nó là một phần của context engineering. Theo chị, context engineering về cơ bản là cho model đúng memory, đúng context. Khi bạn tạo một file AGENTS.md, model sẽ luôn tham chiếu tới file đó, và lấy nó làm context. Ví dụ như cái nút cần lấy từ component library. Bằng cách đó, bạn đang cho model một context tốt (video đăng ngày 08/10/2026).

Annie nói thêm: lát nữa hai người sẽ nói tới file SKILL.md, thứ mà bạn gần như đang lazy load như một prompt, như context cho model. Như vậy model luôn biết đâu là context tốt để đưa ra câu trả lời tốt hơn (theo Annie, video đăng ngày 08/10/2026).

AGENTS.mdmodel luôn tham chiếu tới SKILL.mdlazy load như prompt, như context context cho modelđể có câu trả lời tốt hơn
Hình 3.1Cách Annie đặt agent specification vào context engineering: AGENTS.md là thứ model luôn tham chiếu tới, SKILL.md được lazy load khi cần (theo Annie, video đăng ngày 08/10/2026).

Rồi Annie quay sang Tilde: chị biết hai người có ba file, AGENTS.md, DESIGN.md và SKILL.md, và nhờ Tilde giải thích chúng.

4. Ba file: DESIGN.md, AGENTS.md và SKILL.md

Tilde giới thiệu từng file một (video đăng ngày 08/10/2026):

  • DESIGN.md cho agent những guardrail về hình ảnh (visual guardrails): ứng dụng bạn đang build nên trông như thế nào (theo Tilde, video đăng ngày 08/10/2026).
  • AGENTS.md quy định hành vi chung (global behavior) của agent, thứ bạn muốn xảy ra ở mọi request, mọi lượt của cuộc hội thoại (theo Tilde, video đăng ngày 08/10/2026).
  • File SKILL.md quy định hành vi theo task (task behavior) cho agent, hoặc theo domain (theo Tilde, video đăng ngày 08/10/2026).
DESIGN.mdvisual guardrails:app nên trông thế nào AGENTS.mdglobal behavior: mọi request,mọi lượt hội thoại SKILL.mdtask behavior,hoặc theo domain
Hình 4.1Ba file theo lời Tilde giới thiệu (video đăng ngày 08/10/2026).

Tilde nói giờ sẽ đi vào chi tiết từng file, bắt đầu với DESIGN.md.

5. DESIGN.md: lớp văn xuôi và ví dụ tờ handout khoa học máy tính

Theo Tilde (video đăng ngày 08/10/2026), DESIGN.md là một specification mã nguồn mở, cho coding agent một hiểu biết bền vững (persistent) và có cấu trúc về một design system, để chúng có thể đưa ra lựa chọn thông minh khi build, khi lặp đi lặp lại và khi thay đổi UI của bạn. Bạn có thể định nghĩa visual identity của một thương hiệu và một sản phẩm.

Tilde nói một file DESIGN.md gồm hai lớp. Phần quan trọng nhất được viết bằng ngôn ngữ tự nhiên, chỉ đại khái (just kind of) mô tả thiết kế trông ra sao, cảm giác ra sao và hoạt động ra sao. Đây là phần quan trọng nhất của file, và mọi thứ khác trong DESIGN.md nên tồn tại để hỗ trợ nó (theo Tilde, video đăng ngày 08/10/2026).

Tilde nói mọi thứ luôn rõ ràng khi có ví dụ, rồi đọc một ví dụ từ spec DESIGN.md: "A graduate level computer science lecture handout in the tradition of an old established university", một tờ handout bài giảng khoa học máy tính bậc sau đại học, theo truyền thống của một trường đại học lâu đời, đã có vị thế. Tilde nói câu đó vẽ ra một bức tranh: bạn có thể hình dung trong đầu một tờ pamphlet của MIT trông như thế nào (video đăng ngày 08/10/2026).

Annie đáp: "Yeah, I could", chị hình dung được.

Tilde: "Totally. And your agent can too", agent của bạn cũng hình dung được. Theo Tilde (video đăng ngày 08/10/2026), agent biết là không nên đặt những animation nhấp nháy hay hiệu ứng lấp lánh vào đó, dù nếu là Tilde quyết thì sẽ có những thứ đó.

Annie: "I would too", chị cũng vậy.

Tilde nói tiếp: nhưng chúng ta không sống trong thế giới đó. Pamphlet khoa học máy tính lẽ ra không trông như vậy. Và agent của bạn cũng biết điều đó, nên nó có thể đưa ra lựa chọn thông minh (theo Tilde, video đăng ngày 08/10/2026).

Lớp 1: văn xuôi bằng ngôn ngữ tự nhiên, phần quan trọng nhất thiết kế trông ra sao, cảm giác ra sao, hoạt động ra sao Lớp 2: YAML front matter giá trị cụ thể cho chữ, màu; thành token, dùng lại trong phần văn xuôi
Hình 5.1Hai lớp của DESIGN.md theo lời Tilde: mọi thứ khác nên tồn tại để hỗ trợ phần văn xuôi (video đăng ngày 08/10/2026).

6. DESIGN.md: YAML front matter và token

Annie hỏi: còn một màu thương hiệu hay một font cụ thể thì sao?

Tilde trả lời: phần thứ hai của DESIGN.md là chỗ bạn có thể dùng YAML front matter để ghi những giá trị cụ thể cho chữ, cho màu, bất cứ thứ gì bạn thường dùng CSS để làm. Rồi những giá trị đó được biến thành token, và bạn có thể tham chiếu tới chúng trong phần văn xuôi (theo Tilde, video đăng ngày 08/10/2026).

Slide DESIGN.md Anatomy: Two Layers of UI Guidance, với một ô mô tả mẫu và một khối YAML
Slide "DESIGN.md Anatomy: Two Layers of UI Guidance" (slide trong video đăng ngày 08/10/2026): ô trên là "Sample Description" ghi "A graduate-level computer science handout in the tradition of an established university.", ô dưới là khối YAML với colors, primary '#1a73e8', font 'Inter', radius '8px'. Bên phải: "1.Natural Language Prose (Look, Feel & Tone)", "Model understands aesthetics through prose + tokens" và ô đang được làm nổi "2.YAML Frontmatter Tokens (Designs Systems Spec)". Câu mẫu trên slide ngắn hơn câu Tilde đọc, không có chữ "lecture" và "old".

Khối YAML trên slide đó (slide trong video đăng ngày 08/10/2026):

---
colors:
  primary:  '#1a73e8'
font:  'Inter'
radius:  '8px'

Tilde nói spec DESIGN.md mã nguồn mở nằm trên GitHub của Google Labs, cho ai muốn tìm hiểu thêm (video đăng ngày 08/10/2026). Rồi Tilde mời Annie kể thêm về AGENTS.md.

7. AGENTS.md: project guidance, các coding agent và cách nhờ agent viết file

Annie nói hai người đã chạm một chút tới file AGENTS.md lúc trước. Về cơ bản, bạn đặt project guidance vào file AGENTS.md, để mỗi lần coding agent tạo ra thứ gì, nó sẽ tham chiếu tới file này và làm theo guidance, giống như cái nút luôn được tạo từ component library (theo Annie, video đăng ngày 08/10/2026).

Theo Annie (video đăng ngày 08/10/2026), các coding agent, ví dụ Antigravity CLI, Codex, Claude Code, đều có file AGENTS.md của mình. Nhưng chủ yếu là Antigravity CLI và Codex có file AGENTS.md, còn Claude Code có file CLAUDE.md. Lát nữa hai người sẽ nói cách để chúng dùng chung một context.

Annie đưa ví dụ (video đăng ngày 08/10/2026): nếu bạn dùng Antigravity CLI để bắt đầu một project, bạn chỉ cần bảo coding agent đại ý: "hey, quét project của tôi đi, rồi cho tôi biết một số task guidance, cách chạy ứng dụng lên (spin up), cho tôi biết kiến trúc", rồi đặt tất cả vào file AGENTS.md, để về sau mọi thứ đều đọc từ file AGENTS.md này.

Annie nói, một ô New prompt hiện ở dưới với câu nhờ agent soạn AGENTS.md
Ô "New prompt" hiện lên trong lúc Annie nói về việc nhờ agent quét project và viết AGENTS.md (video đăng ngày 08/10/2026). Câu trong ô khác lời chị nói: nó nhắc tới test command và coding guideline.

Câu trong ô "New prompt" đó (video đăng ngày 08/10/2026):

Look through this project and draft an AGENTS.md with its test commands and coding guidelines.

8. Benchmark của Agentic AI Foundation: AGENTS.md trên task mơ hồ

Annie nói tiếp: bạn có thể thắc mắc tại sao lại cần tạo file AGENTS.md. Rồi chị hỏi Tilde: chị nghe nói có file AGENTS.md thì thật ra tiết kiệm token và cải thiện hiệu năng khá nhiều, có đúng không (câu hỏi của Annie, video đăng ngày 08/10/2026)?

Tilde đáp "Yes", và nói có bằng chứng cho điều này: Agentic AI Foundation đã chạy một nghiên cứu benchmark vào tháng 7/2026. Cụ thể hơn, thứ họ kiểm tra là hiệu năng trên những task được định nghĩa lỏng lẻo (loosely defined tasks). Khi agent được giao một task như vậy, việc có mặt file AGENTS.md cho ra ít wall clock time hơn: request chạy nhanh hơn; ít token hay credit hơn; và diff nhỏ hơn (theo Tilde, video đăng ngày 08/10/2026).

Tilde nói điều đó tốt, vì nói chung, nếu bạn diễn đạt cùng một ý bằng ít dòng code hơn, thì tốt hơn cho mọi thứ (theo Tilde, video đăng ngày 08/10/2026).

Biểu đồ cột AGENTS.md usage lead to với ba cột giảm 27, 24 và 26 phần trăm
Biểu đồ "AGENTS.md usage lead to" (slide trong video đăng ngày 08/10/2026): ba cột ghi -27% cho "Wall-clock Time", -24% cho "API Credits Tokens" và -26% cho "Diff Size". Tilde không đọc các con số này thành lời.

Theo Tilde (video đăng ngày 08/10/2026), thêm AGENTS.md không làm mọi task đều nhanh lên. Nó thật sự cắt bớt phần đuôi dài (long tail) của những trường hợp agent bị rối và cứ quay vòng, chẳng hạn cố đọc một file build không tồn tại, hoặc bị lạc theo cách nào đó khác.

Có tiếng đáp "I see".

9. AGENTS.md nên khá ngắn, khoảng 12 dòng, theo nghiên cứu Tilde dẫn

Tilde nói còn một điều nữa từ nghiên cứu này mà Tilde thấy thú vị: file AGENTS.md của bạn nên khá ngắn, khoảng 12 dòng (theo Tilde, video đăng ngày 08/10/2026).

Annie hỏi lại: "Really? Only 12 lines?", thật à, chỉ 12 dòng thôi sao?

Tilde: "Yeah, according to this study", đúng, theo nghiên cứu này.

Có tiếng đáp "Cool".

Annie nói vậy là bạn phải rất ngắn gọn với những gì bạn thật sự muốn áp đặt trong file AGENTS.md, để nó có ích. Chị nói thêm "I think that makes sense", chị thấy điều đó hợp lý (video đăng ngày 08/10/2026).

AGENTS.md khá ngắn,khoảng 12 dòng rất ngắn gọn với thứthật sự muốn áp đặt
Hình 9.1Bên trái là điều Tilde nói theo nghiên cứu, bên phải là cách Annie hiểu nó (video đăng ngày 08/10/2026).

Rồi Annie nhờ Tilde kể thêm về file SKILL.md, thứ hai người chưa nói tới.

10. SKILL.md: một kiểu prompt tái sử dụng cho task theo domain

Theo Tilde (video đăng ngày 08/10/2026), về bản chất skill là một kiểu (flavor) khác của prompt tái sử dụng, bạn có thể dùng cho những task theo domain cụ thể. Ví dụ, bạn có thể viết một skill để deploy app của mình lên Google Cloud qua Cloud Run.

Tilde nói một điều hay về skill là bạn không phải tự viết tất cả. Có rất nhiều repository skill tuyệt vời, trong đó có của Google, theo Tilde là khá đầy đủ (quite comprehensive). Chúng có sẵn trên internet, mã nguồn mở, miễn phí (theo Tilde, video đăng ngày 08/10/2026).

Trang GitHub của repository google/skills với danh sách thư mục và phần About
Trang repository "google / skills" trên GitHub hiện lên lúc Tilde nói về repository skill của Google (video đăng ngày 08/10/2026): phần About ghi "Agent Skills for Google products and technologies", các thư mục .agents/plugins, .claude-plugin, plugins/cloud, skills, và con số 20.7k stars, 1.7k forks trên trang lúc đó.

Tilde nói với skill không phải do mình viết, bạn chắc chắn nên đọc chúng, chỉ để chắc là trong đó không có gì bất ngờ, giống như cách bạn vẫn làm khi dùng bất kỳ dependency bên thứ ba nào trong phần mềm (theo Tilde, video đăng ngày 08/10/2026).

11. Skill không chỉ để viết code

Theo Tilde (video đăng ngày 08/10/2026), một điều hay nữa là skill không chỉ để viết code. Bạn có thể dùng chúng để viết copy nhất quán về thương hiệu và giọng điệu, để biên tập copy (copy editing), thậm chí để viết bản đánh giá hiệu suất hằng năm (annual performance review) của mình, "because who likes doing that?", vì ai thích làm việc đó chứ?

Annie đáp: "Yeah, I won't use this for my annual performance", chị sẽ không dùng cái này cho bản đánh giá hằng năm của mình, rồi nói "That's a cool idea", đó là một ý hay.

Tilde nói tiếp: skill không chỉ dành cho developer, chúng dành cho tất cả mọi người. Nếu bạn viết được một prompt cho việc gì đó mà bạn có thể muốn dùng lại, thì có lẽ bạn viết được một skill cho nó (theo Tilde, video đăng ngày 08/10/2026).

SKILL.md deploy app qua Cloud Runviết copy đúng brand, tone copy editingannual performance review
Hình 11.1Các ví dụ dùng skill Tilde nêu; theo Tilde, viết được prompt cho việc mình có thể muốn dùng lại thì có lẽ viết được skill cho nó (video đăng ngày 08/10/2026).

12. Best practice thứ nhất: giữ mỗi file tập trung vào một việc

Tilde hỏi Annie: có những best practice chung nào cho agent specification? Annie nói chị sẽ bắt đầu với ba điều.

Điều thứ nhất, theo Annie (video đăng ngày 08/10/2026), là bạn cần giữ mọi thứ tập trung. Nó giống như một "single design principle": một file chịu trách nhiệm cho một thứ.

  • File AGENTS.md nên chịu trách nhiệm cho project guidance. Ví dụ, cách bạn chạy test, và việc bạn luôn cần có unit test mỗi lần thay đổi, những thứ như vậy, bạn cần đặt vào file AGENTS.md (theo Annie, video đăng ngày 08/10/2026).
  • File DESIGN.md chủ yếu là cho việc bạn muốn app trông như thế nào: phong cách, màu thương hiệu, những thứ như vậy (theo Annie, video đăng ngày 08/10/2026).
  • File SKILL.md là cho task lặp lại. Ví dụ như annual performance review, hoặc cách bạn muốn dùng một số tool nhất định. Bạn có thể ghi rõ tất cả những thứ đó trong một file skill (theo Annie, video đăng ngày 08/10/2026).
Slide Three useful kinds of guidance với ba cột AGENTS.md, DESIGN.md và SKILL.md
Slide "Three useful kinds of guidance" (slide trong video đăng ngày 08/10/2026): AGENTS.md "Working in this project" (Build and test commands, Generated-file rules, Team conventions); DESIGN.md "Visual intent" (Colors and typography, Layout and components, Natural-language direction); SKILL.md "A particular procedure" (When to use this skill, Steps and checks, Supporting resources).

Annie nói đó là gợi ý thứ nhất.

13. Best practice thứ hai và thứ ba: instruction dùng chung nhất quán, quản lý như code

Gợi ý thứ hai của Annie (video đăng ngày 08/10/2026): bạn cần đảm bảo những thứ dùng chung, instruction dùng chung, phải nhất quán. Ví dụ, như hai người đã nói lúc trước, với Antigravity CLI ta dùng file AGENTS.md, còn với Claude Code ta dùng file CLAUDE.md. Nếu đang phát triển với nhiều coding agent khác nhau, ta vẫn có thể dùng một file AGENTS.md chung.

Theo Annie (video đăng ngày 08/10/2026), với Claude Code, bạn chỉ cần dùng "at AGENTS.md file", để mọi người đều dùng một file chung. Điều đó giúp cả team giao tiếp với nhau trên cùng một trang.

Gợi ý cuối cùng của Annie (video đăng ngày 08/10/2026): bạn có thể đối xử với những file specification đó, những file markdown đó, y như code, và dùng version control, để mọi người trong team biết về các thay đổi khác nhau, cùng ở trên một trang, và nắm được mọi guideline và mọi preference.

Slide Best practices for agent specification với hai ô 01 và 02
Slide "Best practices for agent specification" (slide trong video đăng ngày 08/10/2026) lúc Annie nói về gợi ý thứ hai: ô "01 Keep it focused: Include the essentials the agent needs regularly." và ô "02 Keep shared instructions consistent: Keep common guidance in one place."

14. Mỗi người một IDE, vẫn chung một file AGENTS.md

Tilde nói điều Tilde thích ở đây là hai người có thể dùng những IDE khác nhau. Như Annie có thể dùng Antigravity còn Tilde có thể dùng Claude. "No, just kidding", Tilde nói đùa thôi: Tilde làm ở Google, Tilde dùng Antigravity (video đăng ngày 08/10/2026).

Theo Tilde (video đăng ngày 08/10/2026), nếu hai người dùng những IDE khác nhau, hai người vẫn có thể giữ cùng một file AGENTS.md, vì developer có những preference rất cụ thể về cách mình muốn môi trường local được thiết lập.

IDE AIDE B một AGENTS.md chungtrong version control
Hình 14.1Theo Tilde và Annie, khác IDE, khác coding agent vẫn có thể dùng chung một file AGENTS.md (video đăng ngày 08/10/2026).

Có tiếng đáp "Yeah".

Tilde hỏi tiếp, nhân chuyện đó: nếu Tilde có một số preference không muốn chia sẻ với team, chỉ muốn giữ riêng cho mình thì sao?

15. Preference riêng: tầng user và tầng project

Annie đáp: "Yeah, so here's a trick", có một mẹo. Theo chị (video đăng ngày 08/10/2026), dù bạn có cùng một file AGENTS.md, nhưng nếu đặt file đó ở một chỗ khác, nó thật ra được áp dụng ở một phạm vi (scope) khác.

Theo Annie (video đăng ngày 08/10/2026), nếu đặt nó ở tầng project, nó chỉ áp dụng cho một project đó. Còn nếu đặt ở tầng user, nó áp dụng cho tất cả các project bạn muốn.

Về cơ bản, nếu bạn có preference ở tầng user, chẳng hạn với chính Annie, chị thích agent giải thích cho mình bằng hình ảnh. Chị sẽ đặt preference này ở tầng user, để mỗi lần agent giải thích một khái niệm cho chị, nó luôn giải thích bằng hình ảnh (theo Annie, video đăng ngày 08/10/2026).

Còn riêng cho project, ví dụ chị luôn muốn thêm một số integration task cho một số thay đổi nhất định. Chị sẽ đặt điều này ở tầng project, và khi đó nó nằm trong Git, trong version control cùng với team, để cả team dùng chung một guidance. Annie nói đó là mẹo: đặt ở chỗ nào thật sự quan trọng (video đăng ngày 08/10/2026).

Slide Agent Context Hierarchy and Scope với ba tầng User, Project, Task đổ vào LLM Context Window
Slide "Agent Context Hierarchy & Scope" (slide trong video đăng ngày 08/10/2026): "User Level (~/.gemini, ~/.claude)" với Personal Preferences (tone, brevity, terminal defaults); "Project Level (AGENTS.md & DESIGN.md)" với Shared Team Standards (build commands, linting, UI design tokens, repo rules); "Task Level (SKILL.md)" với On-Demand Progressive Disclosure (specialized workflows loaded into context only when needed, e.g. Cloud Run deployment); cả ba đi xuống ô "LLM Context Window".

16. Ví dụ open source: Google ADK và DeepMind Simply

Annie hỏi Tilde: có project open source nào hay để tham khảo, học từ ví dụ không?

Tilde đáp "Yes": theo Tilde (video đăng ngày 08/10/2026), Agent Development Kit của Google, hay ADK, là một ví dụ rất tốt.

Annie chen vào: "I love ADK", chị rất thích ADK.

Tilde nói AGENTS.md của ADK đưa ra một phần giới thiệu ngắn, trỏ tới các skill cho những thứ như thiết lập môi trường phát triển và kiến trúc. Bạn có thể đi theo những link này để xem team tách phần hướng dẫn khởi đầu khỏi phần guidance chi tiết ra sao (theo Tilde, video đăng ngày 08/10/2026).

Trang README của Agent Development Kit (ADK) 2.0 trên GitHub với logo ADK
README của "Agent Development Kit (ADK) 2.0" trên GitHub, hiện lên lúc Tilde nói về ADK (video đăng ngày 08/10/2026): dòng mô tả ghi "An open-source, code-first Python framework for building, evaluating, and deploying sophisticated AI agents with flexibility and control."

Theo Tilde (video đăng ngày 08/10/2026), repo Simply của DeepMind là một ví dụ khác: AGENTS.md của nó có lệnh setup và test, ghi chú kiến trúc và quy ước code.

File AGENTS.md của repo simply trên GitHub với các mục Project Overview, Common Commands, Installation
File AGENTS.md của repo simply trên GitHub (video đăng ngày 08/10/2026): dòng đầu ghi "This file provides guidance to AI coding agents working with code in this repository.", rồi các mục Project Overview, Common Commands và Installation với các lệnh pip install.

Cuối video, Annie cảm ơn mọi người đã xem.

Nguồn và liên kết 9 nguồn

  1. Tên gốc: Scaling agentic coding practices across your team
  2. Sự kiện: YouTube
  3. Video gốc: https://www.youtube.com/watch?v=TiH2E2mPZIk youtube.com
  4. Kênh YouTube Google Cloud Tech (Tilde Thurium & Annie Wang): youtube.com/channel/UCJS9pqu9BzkAMNTmzNMNhvg youtube.com
  5. DESIGN.md, repository của Google Labs, tự mô tả là "A format specification for describing a visual identity to coding agents" (đọc ngày 21/11/2026): github.com/google-labs-code/design.md github.com
  6. Bài "Measuring AGENTS.md: What Five Runs Show That One Doesn't" trên blog của Agentic AI Foundation, đề ngày 22/07/2026; bài ghi thử nghiệm dùng một AGENTS.md mười hai dòng, và trên task mơ hồ nó giảm wall time 27%, credit 24%, diff nhỏ hơn 26%; bài cũng ghi tài liệu của Claude Code khuyên nối CLAUDE.md với AGENTS.md bằng một dòng import @AGENTS.md hoặc một symlink (đọc ngày 21/11/2026): aaif.io/blog/measuring-agents-md-what-five-runs-show-that-one-doesn-t aaif.io
  7. google/skills, "Agent Skills for Google products and technologies" (đọc ngày 21/11/2026): github.com/google/skills github.com
  8. Google Agent Development Kit (ADK) cho Python (đọc ngày 21/11/2026): github.com/google/adk-python github.com
  9. DeepMind Simply, codebase nghiên cứu viết bằng JAX (đọc ngày 21/11/2026): github.com/google-deepmind/simply github.com