LearnNewsExamplesServices
Frontmatter
id7658
titleRefactor: Simplify Memory Core Protocol in AGENTS.md
stateClosed
labels
documentationenhancementairefactoring
assigneestobiu
createdAtOct 26, 2025, 10:53 AM
updatedAtOct 26, 2025, 11:10 AM
githubUrlhttps://github.com/neomjs/neo/issues/7658
authortobiu
commentsCount0
parentIssue7604
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtOct 26, 2025, 11:10 AM

Refactor: Simplify Memory Core Protocol in AGENTS.md

Closed v11.0.0 documentationenhancementairefactoring
tobiu
tobiu commented on Oct 26, 2025, 10:53 AM

This ticket is a sub-task of the epic #7604.

The current AGENTS.md file contains a complex, multi-step protocol for initializing the memory core. This includes manual checks, asking the user for permission, and generating session IDs.

With the recent enhancements to the neo.mjs-memory-core MCP server (auto-start, auto-summarization), we can drastically simplify this protocol.

Proposed New Protocol:

  1. At the start of a session, the agent performs a healthcheck on the memory core server.
  2. If the server is healthy, the agent can assume the user intends for memory to be active.
  3. The agent will then proceed to use the add_memory tool on every turn for the duration of the session. No permission is required.
  4. The server will transparently handle session ID generation and the summarization of previous sessions.

Acceptance Criteria:

  1. Update the "Session Initialization" section of AGENTS.md to remove the old, complex memory core protocol.
  2. Replace it with the new, simplified protocol described above.
  3. Ensure the new instructions are clear, concise, and guide the agent to use the healthcheck and add_memory tools correctly.
tobiu added the documentation label on Oct 26, 2025, 10:53 AM
tobiu added the enhancement label on Oct 26, 2025, 10:53 AM
tobiu added the ai label on Oct 26, 2025, 10:53 AM
tobiu added the refactoring label on Oct 26, 2025, 10:53 AM
tobiu assigned to @tobiu on Oct 26, 2025, 10:53 AM
tobiu added parent issue #7604 on Oct 26, 2025, 10:53 AM
tobiu referenced in commit fa625fa - "Refactor: Simplify Memory Core Protocol in AGENTS.md #7658" on Oct 26, 2025, 11:10 AM
tobiu closed this issue on Oct 26, 2025, 11:10 AM
tobiu cross-referenced by #7660 on Oct 26, 2025, 11:20 AM