Mình rất lười, nên mỗi lần mở một phiên chat AI mới trên cùng máy tính, hoặc đổi app, đổi máy… là mình lại chùng tay. “Giờ bố lại phải giải thích từ đầu cho mày rồi, nào là về bố, về giọng văn, về khách hàng, về những gì mình đang làm…”. Nghỉ nghỉ, méo làm gì nữa. Phiền vô cùng.

Ví dụ vậy thôi, chứ người lười như mình không làm thế.

Mày ngồi xuống đây, bố chỉ kể mày một lần này thôi nhé, rồi ghi lại cho bố đi thằng cháu AI ơi.

Vô bài! Thay vì nhồi lại context mỗi lần, mình chọn cách đơn giản hơn: biến ~/.agents/ thành bộ nhớ dùng chung cho toàn bộ các cháu AI agent của mình: 3 app x 3 máy tính, 9 cháu như 1.

1. Tại sao dùng ~/.agents/ thay vì tạo cấu trúc mới?

Nhìn vào thực tế thì đã rõ. Nhiều agent đang dần hướng tới việc đọc chung một nơi để nắm được ngữ cảnh làm việc.

Thư mục ~/.agents/ của mình hiện tại đi đúng hướng đó:

~/.agents/
├── AGENTS.md              # Hướng dẫn chung cho mọi agent đọc
├── MEMORY.md              # Kiến thức tích lũy theo thời gian
├── TASKS.md               # Theo dõi công việc, dự án
├── user.md                # Thông tin về bản thân
├── preferences.md         # Sở thích, quy ước làm việc
├── ha-tang-ca-nhan.md     # Hạ tầng, thiết bị, môi trường cá nhân
├── cach-lam-viec-ky-thuat.md
├── cong-viec-marketing.md
├── sync-memory-push.md
├── domains/               # Kiến thức domain theo từng mảng
├── skills/                # Quy trình, skill riêng của mình
├── state/                 # Trạng thái hiện tại đang làm
└── scripts/               # Script hỗ trợ đồng bộ

Thay vì phát minh lại một cấu trúc hoàn toàn khác, tốt nhất là mở rộng đúng theo thứ đã có sẵn này.

2. Ý nghĩa của từng file, từng thư mục

Để agent hiểu đúng và dùng đúng, mình cần giữ được logic vốn có, chỉ bổ sung thêm những gì còn thiếu.

File/Thư mụcMục đíchGhi chú
AGENTS.mdFile định hướng chínhĐây là “bản đồ” cho agent. Nó cần biết đọc các file còn lại cái này
MEMORY.mdBộ nhớ dài hạnNơi lưu kiến thức đã được đúc kết, bài học, quy tắc đã hoạt động thực tế
TASKS.mdDanh sách công việcTheo dõi task đang làm, sắp làm, đã xong. Rất hữu ích để agent nắm công việc của mình và hỗ trợ phù hợp
user.mdHồ sơ cá nhânThông tin về bản thân, vai trò, mục tiêu, cách giao tiếp
preferences.mdThói quen làm việcCách mình thích agent hỗ trợ, ưu tiên gì, điều gì tránh
domains/Kiến thức chuyên mônBên trong chia theo folder từng loại chuyên môn. Ví dụ domains/brand/ chứa brand guideline, tone/voice, từ ngữ được dùng/không dùng. domains/client/ chứa thông tin khách hàng, domains/product/ chứa sản phẩm/dịch vụ.
skills/Quy trình tái sử dụngĐây chính là nơi biến kinh nghiệm thành “skill”. Mỗi skill là một file/folder mô tả rõ quy trình để agent có thể làm theo mà không cần mình hướng dẫn lại.
state/Trạng thái thời điểm hiện tạiRất quan trọng. Giúp agent biết mình đang dở dở dang cái gì, đang theo đuổi dự án nào, đang chờ phản hồi gì.
scripts/Tự động hóa đồng bộCó thể dùng để hỗ trợ việc git pull/push hoặc kiểm tra thay đổi trước khi commit
  1. Bổ sung các skill quan trọng

Hiện tại skills/ trên thị trường có khá nhiều thứ. Với nhu cầu làm marketing hằng ngày, mình nghĩ chỉ cần như sau:

SkillMục đíchÝ tưởng triển khai
git-memory-syncAgent tự chủ động lưu kiến thức qua GitThống nhất với agent khi nào nên ghi, commit message thế nào, luôn pull –rebase trước khi push, tuyệt đối không commit thông tin nhạy cảm.
google-driveLấy data, template, báo cáo từ Google DriveKết hợp với MCP. Chỉ rõ cấu trúc folder mình hay dùng, tên file quan trọng, quy ước tìm kiếm. Giúp agent mở đúng file nhanh hơn.
internal-docsTra cứu tài liệu nội bộHướng dẫn cách định vị nhanh tài liệu nội bộ, cách đọc, tải tài liệu, ưu tiên đọc những gì liên quan đến dự án đang làm.
writing-styleTái hiện chính xác văn phong của mìnhAgent sẽ đọc để viết gần giống mình nhất có thể, tránh giọng AI quá. Ví dụ, mình đã chạy riêng dự án tái tạo phong cách với hơn 15K mẫu tin nhắn mình viết để ra skill riêng.
delegateThay mặt mình trả lời tin nhắn với đồng nghiệpQuản lý inbox. Chỉ được trả lời trong giới hạn đã chốt, dùng đúng ngữ cảnh, đúng quan hệ, không tự ý hứa hẹn, không đưa ra quyết định quan trọng chưa được phê duyệt.
daily-opsQuản lý công việc hằng ngàyGiúp tổng hợp nhanh từ TASKS.md, state/, daily-log để báo cáo tình hình, nhắc việc cần follow-up, liệt kê blocker.
project-trackerTheo dõi dự án đang triển khaiNắm timeline, người liên quan, file cần dùng, quyết định đã chốt. Mỗi khi có update, tự cập nhật vào đúng vị trí thay vì để rải rác.

Cốt lõi của các skill trên đều là: quy trình rõ ràng + giới hạn rõ ràng. Chỉ cần mô tả đủ chi tiết để agent làm theo, không cần phức tạp quá.

4. Đồng bộ bằng Git và để agent tự chủ động lưu

Vì ~/.agents/ đã là một git repo, việc đồng bộ cực kỳ đơn giản. Chỉ cần biến thành private repo trên GitHub rồi push lên.

Biến thành skill git-memory-sync

Hãy thêm rule như này vào skills/git-memory-sync/skill.md (hoặc trực tiếp vào AGENTS.md nếu muốn nó được áp dụng toàn cục):

Skill: git-memory-sync

Khi có thay đổi đáng ghi nhớ vào ~/.agents/, thực hiện theo trình tự:

1. Đánh giá: Chỉ commit khi có bài học, quy trình, quyết định, update dự án/brand/giọng văn
2. git pull --rebase origin main (hoặc nhánh đang dùng)
3. git add chỉ các file liên quan
4. git commit -m "[memory] <ngắn gọn, có ngữ cảnh>: ví dụ [memory] update brand tone for client X"
5. git push origin <branch>

TUYỆT ĐỐI KHÔNG commit: .env, token, key, mật khẩu, thông tin thanh toán, dữ liệu cá nhân nhạy cảm.

Ưu tiên ghi NGAY khi phát hiện điều đáng nhớ, thay vì đợi đến cuối phiên.

Quy tắc tự động lưu

Để agent thật sự chủ động, mình thêm vào AGENTS.md một block ngắn gọn như sau:

## Auto-memory
Sau mỗi phiên làm việc có ý nghĩa, tự đánh giá và cập nhật nếu cần:
- MEMORY.md -> bài học đúc kết
- domains/ -> thông tin brand/client/product mới
- skills/ -> quy trình vừa được tối ưu
- state/ -> trạng thái dự án hiện tại
- TASKS.md -> cập nhật tiến độ
- decisions/ (hoặc ghi vào MEMORY.md tùy ngữ cảnh) -> các quyết định quan trọng vừa chốt

Sau khi cập nhật, nếu có thay đổi, chạy git-memory-sync để commit/push.

Chỉ cần vài dòng đơn giản như thế là đã đủ để tạo thói quen tự động.

5. Chuẩn AGENTS.md và tương thích Command Code, OpenCode, Claude

Điểm hay nhất ở cách tiếp cận này là dùng đúng chuẩn đang dần trở thành chung.

  • AGENTS.md: Hiện nay hầu hết các agent hiện đại đều ưu tiên đọc file này. OpenCode gần như theo sát chuẩn này, Command Code cũng hỗ trợ tương đối tốt, Claude Code tự động đọc được mà không cần ép.
  • Cấu trúc phẳng, rõ ràng: domains/, skills/, state/ cực dễ để agent duyệt và load đúng ngữ cảnh.
  • Một nguồn duy nhất: Chỉ cần đồng bộ ~/.agents/ qua private Git repo. Dù bạn dùng Command Code, OpenCode hay Claude trên bất kỳ máy nào, chỉ cần git clone/pull là có ngay toàn bộ bộ nhớ.

Cách này còn hơn cả việc tạo 3 bộ nhớ riêng. Nó đúng tinh thần “viết một lần, dùng cho tất cả”.

6. Hướng dẫn nhanh để bắt đầu

Không cần làm lại từ đầu. Chỉ cần hoàn thiện dần những gì đang thiếu:

  1. Kiểm tra lại AGENTS.md: Bảo agent đọc lại bài viết này và đề xuất bổ sung hướng dẫn để nó luôn load MEMORY.md, TASKS.md, user.md, preferences.md trước khi bắt đầu.
  2. Tập trung vào domains/brand/: Nếu công ty có brand guideline, tone/voice, hãy gom hết vào đây. Đây là thứ bạn sẽ nhờ agent dùng nhiều nhất.
  3. Xây dựng skills/writing-style/: Lấy vài bài viết, email, caption thật nhất của mình cho vào (như mình là mình lấy 15K chứ không phải “vài” đâu). Agent sẽ tự học từ đó nhanh hơn rất nhiều so với mô tả bằng lời.
  4. Bắt đầu dùng git-memory-sync: Tạo skill này ngay hôm nay. Từ lần đầu tiên agent tự commit mà có ngữ cảnh, bạn sẽ thấy sự khác biệt rõ ràng.
  5. Cho agent tự cập nhật: Mỗi khi bạn thấy mình đang phải giải thích lại điều gì, đừng giải thích nữa. Chỉ cần nói: “Ghi cái này vào ~/.agents/ theo đúng cấu trúc đang có đi.” Cứ làm vậy liên tục, nó sẽ tự hoàn thiện theo thời gian.

Kết luận đơn giản: Đừng tạo một thư mục bộ nhớ mới. Hãy biến ~/.agents/ thành bộ não dùng chung. Với 1 repo Git private, agent sẽ nhớ giọng văn, brand, dự án, quyết định của bạn trên mọi máy, và quan trọng nhất là sẽ tự ghi nhớ mà không cần bạn nhắc lại mỗi lần.

Đó là bước đầu. Còn giờ, mình chỉ cầm điện thoại, ôm con ngủ, nhắn tin với agent trên 1 máy chủ. Nó tự liên lạc với 3 máy còn lại để làm. Mình ngủ đây.

Sáng dậy mà chưa xong việc, bố gõ đầu hết tụi máy nhá.