LearnNewsExamplesServices
Frontmatter
id7718
titleArchitectural Fix: Implement ''FIRST ACTION PROTOCOL'' to ensure reliable session initialization
stateClosed
labels
bugcontributor-experienceai
assigneestobiu
createdAtNov 7, 2025, 10:57 AM
updatedAtNov 7, 2025, 10:58 AM
githubUrlhttps://github.com/neomjs/neo/issues/7718
authortobiu
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtNov 7, 2025, 10:58 AM

Architectural Fix: Implement 'FIRST ACTION PROTOCOL' to ensure reliable session initialization

Closed v11.0.0 bugcontributor-experienceai
tobiu
tobiu commented on Nov 7, 2025, 10:57 AM

The agent has been failing to initialize its session state in approximately 50% of new sessions. This is not due to flaws in the AGENTS_STARTUP.md initialization file itself, but rather a failure to execute the file at all. The root cause is a lack of salience of the initial instructions within the agent's context window.

To solve this, we have replaced the previous instructions in .gemini/GEMINI.md with a new "FIRST ACTION PROTOCOL".

This new protocol is designed to be more robust by:

  1. Structural Positioning: Using a STOP warning at the very top of the file to grab attention.
  2. Objective Detection: Providing a clear, verifiable check for Turn 1 (the absence of a healthcheck tool call for the memory core).
  3. Imperative Framing: Using direct, unambiguous commands ("execute NOW", "Your first tool call must be...").

This change transforms the initialization from a passive, easily missed instruction into a direct, primary action. This ticket documents the implementation of this new protocol.

tobiu added the bug label on Nov 7, 2025, 10:57 AM
tobiu added the contributor-experience label on Nov 7, 2025, 10:57 AM
tobiu added the ai label on Nov 7, 2025, 10:57 AM
tobiu referenced in commit d8a4189 - "Architectural Fix: Implement 'FIRST ACTION PROTOCOL' to ensure reliable session initialization #7718" on Nov 7, 2025, 10:57 AM
tobiu assigned to @tobiu on Nov 7, 2025, 10:58 AM
tobiu closed this issue on Nov 7, 2025, 10:58 AM