LearnNewsExamplesServices
Frontmatter
id9723
titleExecution: Add Discovery Mandate to AGENTS_STARTUP.md
stateClosed
labels
enhancementai
assigneestobiu
createdAtApr 5, 2026, 6:30 PM
updatedAtApr 5, 2026, 6:33 PM
githubUrlhttps://github.com/neomjs/neo/issues/9723
authortobiu
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtApr 5, 2026, 6:33 PM

Execution: Add Discovery Mandate to AGENTS_STARTUP.md

Closedenhancementai
tobiu
tobiu commented on Apr 5, 2026, 6:30 PM

The issue of agents hallucinating standard React/Node commands (like npx playwright test) rather than querying the actual repository environment causes frequent context corruption ("Agentic Amnesia"). Furthermore, agents fail to proactively scan .agent/skills to discover expert workflows on boot.

This ticket tracks the addition of a "Zero-Shot Discovery Mandate" to AGENTS_STARTUP.md. Since AGENTS_STARTUP.md is invoked during the "Childhood" handshake of every new session, it is the perfect place to force an agent to run view_file on package.json and .agent/skills to ground itself before touching any code.

Additionally, we will add an explicit instruction encouraging agents to recommend new skills if they identify recurring complex tasks that lack a documented workflow.

Task:

  • Update AGENTS_STARTUP.md to include "Step 6: Discover the Repository Ecosystem & Skills".
  • Add mandate to check package.json for available scripts.
  • Add mandate to check .agent/skills/ for capability workflows.
  • Add encouragement to propose new skills when missing.
  • Re-number subsequent steps.
tobiu added the enhancement label on Apr 5, 2026, 6:30 PM
tobiu added the ai label on Apr 5, 2026, 6:30 PM
tobiu referenced in commit 10e6c85 - "feat: Add startup discovery mandate to AGENTS_STARTUP.md (#9723)" on Apr 5, 2026, 6:33 PM
tobiu assigned to @tobiu on Apr 5, 2026, 6:33 PM
tobiu
tobiu Apr 5, 2026, 6:33 PM

Implemented, mandate added to AGENTS_STARTUP.md.

tobiu closed this issue on Apr 5, 2026, 6:33 PM
tobiu cross-referenced by #9722 on Apr 5, 2026, 6:33 PM