chore(agents): Consolidate SDK dev rules into AGENTS.md#19521
Open
chore(agents): Consolidate SDK dev rules into AGENTS.md#19521
AGENTS.md#19521Conversation
Contributor
size-limit report 📦
|
s1gr1d
reviewed
Feb 25, 2026
|
|
||
| ## Package Manager | ||
|
|
||
| Use **yarn**: `yarn install`, `yarn build`, `yarn test`, `yarn lint` |
Member
There was a problem hiding this comment.
Suggested change
| Use **yarn**: `yarn install`, `yarn build`, `yarn test`, `yarn lint` | |
| Use **yarn**: `yarn install`, `yarn build:dev`, `yarn test`, `yarn lint` |
Locally, we usually don't need to build the browser bundles. Maybe you can add this information somewhere...that using yarn build is only needed for browser bundles (and maybe aws layers in the future @andreiborza )
I see that the commands are also listed in "before every commit" - maybe we can just mention this once.
Comment on lines
+109
to
+117
| Use `/fix-security-vulnerability` skill for Dependabot alerts. See `.claude/skills/fix-security-vulnerability/SKILL.md` | ||
|
|
||
| ### Issue Triage | ||
|
|
||
| Use `/triage-issue` skill. See `.claude/skills/triage-issue/SKILL.md` | ||
|
|
||
| ### CDN Bundles | ||
|
|
||
| Use `/add-cdn-bundle` skill. See `.claude/skills/add-cdn-bundle/SKILL.md` |
Member
There was a problem hiding this comment.
This could be more specific (like above "use /e2e skill to run E2E test). We could add a short description like "Use /triage-issue skill to get a in inspection and fix recommendation for a GitHub issue".
| ### Framework Integrations | ||
|
|
||
| - `packages/{framework}/` — React, Vue, Angular, Next.js, Nuxt, SvelteKit, Remix, etc. | ||
| - Some have client/server entry points (nextjs, nuxt, sveltekit) |
Member
There was a problem hiding this comment.
Suggested change
| - Some have client/server entry points (nextjs, nuxt, sveltekit) | |
| - Some are Meta-Framwork integrations and have client/server entry points (nextjs, nuxt, sveltekit) |
| ### Core | ||
|
|
||
| - `packages/core/` — Base SDK: interfaces, types, core functionality | ||
| - `packages/types/` — Shared types (**deprecated — never modify**) |
Member
There was a problem hiding this comment.
Maybe we could add that those types live in core now
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
2 participants
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.
Both CLAUDE.md and .cursor/rules/sdk_development.mdc contained duplicated SDK development rules that could drift out of sync. AGENTS.md is the standard cross-tool format — Cursor, Claude Code, and other agents all read it automatically, so a single shared file eliminates duplication.
Closes #19522 (added automatically)