docs: add build, architecture, and convention sections to AGENTS.md#311
Open
dpearson2699 wants to merge 2 commits intogetsentry:mainfrom
Open
docs: add build, architecture, and convention sections to AGENTS.md#311dpearson2699 wants to merge 2 commits intogetsentry:mainfrom
dpearson2699 wants to merge 2 commits intogetsentry:mainfrom
Conversation
Add sections that were already present in CLAUDE.md but missing from AGENTS.md, bringing the two files into sync: - Build & Test: all npm scripts agents need to run - Architecture: component map of src/ layers - Import Conventions: ESM, .ts extensions, no barrel imports - Test Conventions: Vitest patterns, colocated tests, smoke tests - Tool Development: manifest-driven tool registration pattern Also clean up stray trailing hyphens on blank lines.
6e1f57c to
0b49fe9
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Syncs AGENTS.md with CLAUDE.md by adding sections that were already present in CLAUDE.md but missing from AGENTS.md.
Added sections
build,test,lint,typecheck,docs:update, etc.)src/layers with one-line descriptionsdocs/dev/guides (contributing, architecture, testing, manifests, release, code quality).tsextensions insrc/, no barrel importsWhy
AI agents reading AGENTS.md (Copilot, Windsurf, Cursor, etc.) were missing build commands, architecture context, contributing workflows, and convention details that were already documented in CLAUDE.md. This caused agents to guess at import styles, test patterns, and project structure rather than following established conventions. The contributing workflow and dev doc links are critical for agents to know the full PR preparation process.
Other changes