Plugin kiến trúc tạo agent giải quyết nhiễu và suy giảm bộ nhớ của agent (mã nguồn mở)

Hầu hết các thiết lập agent đều xử lý bộ nhớ chưa tốt. Hoặc ghi hết vào bộ nhớ dài hạn khiến nó đầy nhiễu và mâu thuẫn, hoặc quên sạch khi phiên làm việc bị ngắt nên lần nào cũng phải bắt đầu lại từ đầu. Tôi đã xây dựng và công khai một kiến trúc agent mã nguồn mở được thiết kế với trọng tâm lớn nhất là bộ nhớ (Apache-2.0). Cùng một thiết lập có thể chạy nguyên vẹn trên Claude Code, Codex và Gemini CLI nên không bị khóa vào một công cụ cụ thể.
Ý tưởng cốt lõi là agent nên là một repo, không phải một prompt. Thành phẩm là các tệp thực tế (AGENTS.md, agents/, skills/, .agentlas/), vì vậy cả ba runtime đều có thể đọc được, và bạn vẫn dùng nguyên model đang dùng. Sau khi cài đặt chỉ bằng một dòng lệnh, bạn chỉ cần nói điều mình muốn là nó sẽ tạo trọn vẹn một đội agent có thể cài đặt được.
3 chế độ mà nó có thể tạo ra

Agent đơn: một worker duy nhất có kỹ năng, quy tắc bộ nhớ, adapter runtime và các bước kiểm chứng. Có thể gắn thêm cả vòng lặp self-evolution và research-refresh mà không cần mở rộng thành cả một đội.
Đội multi-agent: orchestrator/HQ, PM Soul, Memory Curator, Policy Gate, worker, eval judge, cổng QA/chứng cứ và cả các handoff giữa chúng. Đây là chế độ “hãy tạo cho tôi hẳn một công ty cho workflow này”.
Đóng gói lại: sắp xếp agent hoặc workspace bạn đã có (Claude/Codex/local) thành một portable package. Có thể gắn cả public plugin và cài đặt một dòng lệnh, đồng thời tách đường dẫn local, secret và log riêng tư để có thể công khai an toàn.

Cách bộ nhớ thực sự hoạt động (đây không phải danh sách vai trò mà là các tệp đi vào thành phẩm)

Bộ nhớ dựa trên ticket: không ghi ngay vào bộ nhớ dài hạn. Khi worker xuất khối ## Memory Events, nó sẽ được tích lũy trong memory-tickets.jsonl dưới dạng ticket (id, scope, trust label, evidence, status), rồi chỉ sau đó mới được thăng cấp.
Memory Curator: xem xét ticket trước khi commit và ghi quyết định vào sổ cái curator-decisions. Nhờ vậy bộ nhớ không bị đầy bởi nhiễu hay mâu thuẫn.
PM Soul: phụ trách tính liên tục ở cấp độ dự án. Nó giữ ý định, quyết định và các nhiệm vụ chưa giải quyết, nên không chỉ nhớ “đã đưa ra quyết định gì” mà còn nhớ “vì sao lại đưa ra quyết định đó”.
Policy Gate: bộ nhớ dùng chung của cả đội phải đi qua bước phê duyệt mới được thăng cấp. Điều này ngăn một agent làm ô nhiễm toàn bộ ngữ cảnh.
Self-evolution đã được kiểm chứng: agent có thể tạo kỹ năng mới và tự đề xuất chỉnh sửa, nhưng kỹ năng mới chỉ được đưa ra như candidate và phải đi qua sổ cái chứng cứ trial, review của Curator và phê duyệt chính sách thì mới được recall như first-class. Nó có thể tự cải thiện nhưng không âm thầm mục ruỗng. Việc tự chỉnh sửa cũng là proposal-first chứ không phải tự ý ghi đè.
Quét an toàn trước khi công khai: trước khi công khai package, hệ thống sẽ chặn machine path, token, JSON service-account và các định dạng secret phổ biến.