---
id: 7666
title: 'Docs: Update AGENTS.md to use new Codebase Overview Guide'
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
assignees:
  - tobiu
createdAt: '2025-10-26T13:53:17Z'
updatedAt: '2025-10-26T16:16:46Z'
githubUrl: 'https://github.com/neomjs/neo/issues/7666'
author: tobiu
commentsCount: 1
parentIssue: 7665
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2025-10-26T16:16:45Z'
---
# Docs: Update AGENTS.md to use new Codebase Overview Guide

Once the new "Codebase Overview" guide is created and the MCP server is enhanced with class query tools, the `AGENTS.md` file must be updated to reflect the new, more efficient agent initialization protocol.

**Tasks:**
1. Remove the step that instructs the agent to parse or probe `docs/output/class-hierarchy.yaml`.
2. Add a new first step instructing the agent to read the new `learn/guides/fundamentals/CodebaseOverview.md` to gain a conceptual understanding of the framework.
3. Update any related instructions to encourage the use of the new MCP class query tools for detailed exploration once they are available.

## Timeline

- 2025-10-26T13:53:19Z @tobiu added the `documentation` label
- 2025-10-26T13:53:19Z @tobiu added the `enhancement` label
- 2025-10-26T13:53:19Z @tobiu added the `ai` label
- 2025-10-26T13:54:31Z @tobiu assigned to @tobiu
- 2025-10-26T13:54:38Z @tobiu added parent issue #7665
### @tobiu - 2025-10-26T16:16:45Z

resolved

- 2025-10-26T16:16:46Z @tobiu closed this issue

