Giới thiệu

Bạn đã bao giờ gặp tình trạng Claude hay Cursor đang code ngon lành bỗng dưng... "ngáo"? Sau khoảng 50-60 câu lệnh, AI bắt đầu quên mục tiêu ban đầu, lặp lại các lỗi cũ hoặc làm rối tung context window của chính nó. Đây chính là vấn đề mà Manus AI - startup vừa được Meta thâu tóm với giá 2 tỷ USD - đã giải quyết triệt để.

Planning with Files là một repository cực kỳ hot (hơn 13,400 stars và 1,200 forks) hiện thực hóa quy trình làm việc của Manus ngay trên các công cụ AI bạn dùng hàng ngày như Claude Code hay Cursor. Dự án sử dụng ngôn ngữ chính là Python và các script tự động để biến AI của bạn thành một cộng sự có "trí nhớ dài hạn" trên ổ cứng.

Tính năng nổi bật

  • Mô hình 3-File Pattern: Thay vì nhồi nhét mọi thứ vào context, tool này ép AI tạo ra 3 file: task_plan.md (lập kế hoạch), findings.md (ghi chép kết quả) và progress.md (nhật ký thực hiện).
  • Context Engineering: Coi Context Window là RAM (biến động) và Filesystem là Disk (vĩnh viễn). Mọi thông tin quan trọng đều được ghi xuống đĩa.
  • Session Recovery: Tự động khôi phục phiên làm việc khi context bị đầy hoặc khi bạn dùng lệnh /clear.
  • Hỗ trợ đa nền tảng: Tương thích với 14 IDE/CLI khác nhau như Claude Code, Cursor, Gemini CLI, OpenClaw, và Kiro.
  • Cơ chế Hooks: Tự động nhắc AI đọc lại kế hoạch trước khi hành động và cập nhật trạng thái sau khi làm xong.

Cài đặt

Nếu bạn đang sử dụng Claude Code, việc cài đặt vô cùng đơn giản bằng cách chạy các lệnh sau:

/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

Đối với các bạn muốn cài đặt thủ công vào thư mục skills của Claude trên macOS/Linux:

cp -r ~/.claude/plugins/cache/planning-with-files/planning-with-files/*/skills/planning-with-files ~/.claude/skills/

Hướng dẫn sử dụng

Bắt đầu một phiên làm việc

Sau khi cài đặt, bạn chỉ cần gọi lệnh:

/plan

Ngay lập tức, AI sẽ yêu cầu bạn mô tả nhiệm vụ. Sau đó, nó sẽ tự động khởi tạo bộ 3 file thần thánh để bắt đầu theo dõi tiến độ.

Use Case: Xây dựng một tính năng mới

  1. Bước 1: Bạn ra lệnh /plan "Xây dựng hệ thống authentication bằng JWT".
  2. Bước 2: AI tạo task_plan.md liệt kê các bước: Setup DB, Viết Middleware, Tạo Route Login...
  3. Bước 3: Trong quá trình code, nếu gặp lỗi, AI sẽ ghi lại vào findings.md để không bao giờ lặp lại lỗi đó ở các bước sau.
  4. Bước 4: Trước khi kết thúc, AI chạy lệnh kiểm tra toàn bộ checklist trong task_plan.md để đảm bảo không sót tính năng nào.

Kết luận

Ưu điểm

  • Giúp AI xử lý các task phức tạp (trên 3 bước) cực kỳ ổn định.
  • Tiết kiệm token vì không cần nhắc lại hướng dẫn nhiều lần.
  • Dễ dàng kiểm soát những gì AI đang làm thông qua các file markdown.

Nhược điểm

  • Hơi thừa thãi đối với các task cực ngắn (như sửa 1 dòng code).
  • Tạo ra thêm file rác trong project nếu bạn không dọn dẹp sau khi xong việc.

Ai nên dùng tool này? Mình cực kỳ khuyến khích các bạn Developer đang sử dụng AI để xây dựng các dự án từ con số 0 hoặc thực hiện các đợt Refactor mã nguồn lớn. Đây chính là bí kíp để biến AI từ một "trợ lý hay quên" thành một "kỹ sư thực thụ".

Chúc các bạn có những trải nghiệm lập trình hiệu quả hơn với Planning with Files!

GitHub - OthmanAdi/planning-with-files: Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition.
Claude Code skill implementing Manus-style persistent markdown planning — the workflow pattern behind the $2B acquisition. - OthmanAdi/planning-with-files
GitHubOthmanAdi