Tài liệu

Đã cài đặt nhưng dường như không được dùng? Ở những nền tảng hỗ trợ hook, bộ nhớ được đẩy đến agent của bạn và không cần phải dạy gì thêm. Ở những nền tảng không hỗ trợ, quá trình cài đặt sẽ ghi một phần bộ nhớ vào tệp ngữ cảnh riêng của nền tảng, để agent biết tự kéo dữ liệu. Nếu bộ nhớ trông như đã kết nối nhưng agent không bao giờ truy xuất nó, thì tệp đó là thứ cần kiểm tra đầu tiên.

Những gì được ghi trên Claude Code

Trên Claude Code, lệnh pip install (brethof-brain install-hooks) giữ một khối được quản lý trong CLAUDE.md của bạn, được viết lại ở mỗi lần bắt đầu phiên. Đó chỉ là một con trỏ tham chiếu, không phải bản sao của nội dung hướng dẫn — nó cho agent của bạn biết rằng bộ nhớ là Brain, cách truy cập vào đó, và rằng khi bạn nói "ghi nhớ điều này", thông tin sẽ đi vào Brain, chứ không phải vào các tệp bộ nhớ riêng của Claude Code trên một máy. Nội dung hướng dẫn thực sự được truyền đến khi bắt đầu phiên. Nó không bao giờ đụng đến bất cứ thứ gì ngoài khối đó: các quy ước của bạn vẫn thuộc về bạn. Để tắt, hãy đặt BRETHOF_BRAIN_NO_CLAUDE_MD=1. Plugin không bao giờ tự ghi khối này: khi cài đặt bằng plugin, hãy dán khối từ README của plugin vào ~/.claude/CLAUDE.md, hoặc yêu cầu agent của bạn làm việc đó.

Các lệnh và phiên bản

Plugin Claude Code cung cấp ba lệnh: /recall (tìm kiếm ngay), /onboard (phút đầu tiên của một dự án) và /curate (kết thúc phiên). Không cần phải chạy gì bằng tay — bộ nhớ tự động sắp xếp và dọn dẹp khi các bản ghi được ghi nhận.

Điều thay đổi là cách bạn trò chuyện với người đại diện của mình. Bây giờ bạn có thể nói những điều như thế này. Chúng ta đã quyết định thế nào về việc thử gửi tiền lại? or Hãy nhớ rằng chiếc hộp đó chính là chiếc có chứa giấy chứng nhận cũ. — Nói một cách đơn giản, trong lúc trò chuyện thôi. Người đại diện của bạn sẽ chọn công cụ phù hợp; bạn không cần phải nêu tên bất kỳ công cụ nào cả.

Những gì đại lý của bạn có thể với tới

Bạn không cần danh sách này. Nó được đưa ra để bạn biết những gì có thể thực hiện được khi yêu cầu một thứ cụ thể.

• Tìm kiếm những thứ — Hãy tìm trong ký ức được sắp xếp của bạn, hoặc trong lịch sử trò chuyện gốc, nếu bạn cần những từ ngữ chính xác từ một phiên trước đó.
• Ghi nhớ mọi thứ — Lưu một thông tin vào một dự án, hoặc vào lớp chia sẻ được sử dụng cho tất cả các dự án đó.
• Dạy mọi thứ — Lưu một quy tắc, hoặc bắt đầu một dự án với một câu mô tả những điều quan trọng trong đó.
• Kiểm tra các thứ — liệt kê các dự án của bạn, liệt kê những gì một dự án biết, liệt kê các quy tắc của nó, hoặc đọc một bản ghi.
• Loại bỏ các mục — xóa một bản ghi riêng lẻ. Việc ẩn một cụm từ cụ thể hoặc xóa toàn bộ dự án được thực hiện trong bảng điều khiển tài khoản.
• Xem lại sổ ghi chép — xem danh sách những ý định chưa được quyết định của một dự án, xóa từng dòng khi bạn đã quyết định xong.
• Giữ lại các sách hướng dẫn chơi. — Lưu một thủ tục một lần, áp dụng cho toàn bộ tài khoản; truy xuất và chạy nó từ bất kỳ dự án nào; liệt kê những thủ tục còn tồn tại; xóa những thủ tục không còn được sử dụng nữa.

Một điều mà một đại lý cố tình không thể làm: Xóa toàn bộ một dự án. Hành động đó sẽ tác động trực tiếp đến kho lưu trữ gốc, vì vậy nó sẽ tồn tại trong bảng điều khiển tài khoản của bạn, nơi mà người dùng sẽ nhập tên vào.

Quy tắc chính là cách để tránh lặp lại những điều đã nói – những quy ước, ràng buộc và những điều chỉnh quan trọng mà các nhân viên phải luôn ghi nhớ. Những quy tắc tốt thì giống như những định luật: “không bao giờ triển khai vào thứ Sáu”, “dự án này dùng dấu tab chứ không phải dấu cách”, “tên của khách hàng là Brethof, tuyệt đối không phải Brefoth”. Ngắn gọn, rõ ràng, và vẫn đúng ngay cả tháng sau.

Hãy yêu cầu agent của bạn lưu một quy tắc, và nó sẽ hỏi bạn một điều: quy tắc này áp dụng cho tất cả những gì bạn làm, hay chỉ cho dự án này?

Lựa chọn thứ ba mới là lựa chọn quan trọng; nó được chọn nhiều hơn hai lựa chọn còn lại. Một quy tắc có giá thành cao: nó chiếm một vị trí nhất định trong mỗi phiên xử lý dữ liệu, và nó giúp người quản lý xác định được điều gì là quan trọng. Việc coi những kiến thức thông thường thành quy tắc chính là cách khiến ký ức bị chất đống lại với nhau, đến mức không còn điều gì nổi bật nữa.

Quy tắc dạy cho người quản lý, không chỉ agent

Một dự án có vài quy tắc sắc bén sẽ ghi nhớ tốt hơn đáng kể so với dự án không có quy tắc nào — vì các quy tắc cho bộ chọn lọc biết điều gì quan trọng ở đó. Lưu một quy tắc, và trong vài phút, bộ nhớ của dự án đó đã học lại dự án là gì.

Giữ chúng luôn sắc bén

Một quy tắc nên đủ ngắn để bạn vẫn có thể đọc to thành lời — nếu nó không vừa, thì có lẽ đó là kiến thức đội lốt quy tắc. Hãy hợp nhất các quy tắc trùng lặp thành một, và xóa những quy tắc đã lỗi thời; sẽ chẳng có gì tự động cắt tỉa chúng thay bạn, bởi không nên để bất kỳ thứ gì khác quyết định luật của bạn là gì. Mười hai quy tắc bạn tin tưởng còn hơn năm mươi quy tắc bạn đã ngừng đọc.

Dự án trong thực tế

Quyết định quan trọng duy nhất là cách sắp xếp chúng: một mã nguồn cho mỗi dự án, khách hàng hoặc sáng kiến – đó là cách làm hiệu quả nhất. Nếu số lượng quá ít thì các công việc không liên quan sẽ bị lẫn lộn vào nhau; còn nếu quá nhiều thì bối cảnh sẽ trở nên rối rắm. Việc bắt đầu một dự án với một mục tiêu rõ ràng – đó là điều gì và cần ghi nhớ điều gì – chính là khoảnh khắc có giá trị nhất mà bạn nên dành thời gian cho. Điều này giúp người quản lý dự án hiểu rõ mục đích từ ngày đầu, thay vì phải suy đoán ý định của bạn từ những thông tin rời rạc.

Ba thứ khác nhau được đo lường theo cách riêng biệt, và việc biết rõ thứ nào là thứ gì là điều đáng quan tâm. Đang ghi âm Bị giới hạn bởi dung lượng lưu trữ. Học tập bị giới hạn bởi khoản chi trả hàng tháng của bạn. Ghi nhớ lại không bị giới hạn bởi bất cứ điều gì — việc tìm kiếm, cung cấp thông tin trong phiên và gợi nhớ theo yêu cầu vẫn hoạt động miễn là bộ nhớ của bạn nằm trên các hệ thống trực tuyến của chúng tôi.

Nếu gói đăng ký hết hạn

Brain tạm dừng ngay lập tức — không có thời gian ân hạn. Bộ nhớ của bạn được lưu trữ sau ngày 7, bạn được cảnh báo vào khoảng ngày 23, và nó bị xóa vào ngày 30. Tài khoản trả phí đang hoạt động không bao giờ bị ảnh hưởng. Lịch trình đầy đủ cùng các email đi kèm có trong Chính sách Bảo mật.

Khoảng trống mà giới hạn để lại, và lý do tại sao chúng ta không bao giờ lấp đầy nó

Mặc dù có sự hạn chế, nhưng không có ký ức mới nào được tạo ra. Điều đó tạo ra một khoảng trống trong ký ức của bạn về khoảng thời gian đó. Chúng tôi sẽ không quay lại để điền vào nó sau đó.. Đó là một quy tắc thiết kế có chủ đích, và bạn nên biết điều đó.

Ký ức chỉ được tạo ra từ những cuộc trò chuyện mà thôi. Thật trùng hợp.. Một bản ghi được viết sau này, dựa trên những thông tin đã cũ vài tuần tuổi, sẽ ghi đè lên những điều vốn đã là sự thật từ trước đó – và ký ức của chúng ta sẽ bắt đầu khẳng định những điều không còn đúng nữa. Chúng ta thà để lại khoảng trống trong thông tin còn hơn là tạo ra những lời nói dối một cách tự tin.

Nói một cách rõ ràng: khoảng trống đó là vĩnh viễn trong bộ nhớ. Lịch sử hội thoại thô của bạn từ giai đoạn đó vẫn còn đó và vẫn có thể tìm kiếm, nên hồ sơ không bị mất — chỉ có lớp đã tinh lọc là bị khuyết. Giới hạn kéo dài càng lâu, bộ nhớ của bạn càng lệch khỏi công việc bạn đang thực sự làm. Và nó không tự sửa khi bạn tiếp tục: agent của bạn sửa các bộ nhớ lỗi thời khi gặp chúng, và bộ nhớ đối chiếu các bản ghi mới với bản ghi cũ khi chúng đến, loại bỏ những bản ghi bị bộ nhớ mới hơn mâu thuẫn. Cả hai quá trình này đều chạy về phía trước, không bao giờ chạy ngược.

Không ai bị ngắt một cách lặng lẽ. Bạn nhận được email khi sắp chạm giới hạn và một email nữa khi giới hạn có hiệu lực, một thông báo trong phiên làm việc của agent khi giới hạn bắt đầu, và một dòng ngắn trên mỗi yêu cầu trong khi giới hạn còn hiệu lực.