chore: add AGENTS.md for AI agent guidance with CLAUDE.md symlink

[devin-ai-integration]

Description

Adds an AGENTS.md file to provide guidance for AI agents working with this repository. Also creates a CLAUDE.md symlink pointing to AGENTS.md for backward compatibility with tools that look for that specific filename.

The documentation covers:

• Project overview and capabilities
• Repository structure (monorepo layout with packages, apps, examples)
• Key development commands
• Architecture overview (adapters, controllers, UI components, chain namespaces)
• Development notes (code quality standards, import rules, testing patterns)
• Versioning and publishing workflow (Changesets, release channels)

Type of change

• Chore (non-breaking change that addresses non-functional tasks, maintenance, or code quality improvements)
• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Associated Issues

N/A - Documentation addition requested via Slack

Checklist

• Code in this PR is covered by automated tests (Unit tests, E2E tests) - N/A (documentation only)
• My changes generate no new warnings
• I have reviewed my own code
• I have filled out all required sections
• I have tested my changes on the preview link - N/A (documentation only)
• Approver of this PR confirms that the changes are tested on the preview link - N/A

Human Review Checklist

• Verify technical accuracy of the architecture overview section
• Confirm key commands are correct and complete
• Check if any important development guidelines are missing from the Development Notes section
• Verify the versioning/publishing workflow description matches current practices

---

Requested by: @tomiir
Link to Devin run: https://app.devin.ai/sessions/04eeb73cb4734890bb0d8dee8549a8df

[changeset-bot]

⚠️ No Changeset found

Latest commit: 6c7da1f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
appkit-basic-html	Ready	Preview, Comment	Jan 14, 2026 1:50pm
appkit-demo	Ready	Preview, Comment	Jan 14, 2026 1:50pm
appkit-gallery	Ready	Preview, Comment	Jan 14, 2026 1:50pm
appkit-headless-sample-app	Ready	Preview, Comment	Jan 14, 2026 1:50pm
appkit-laboratory	Ready	Preview, Comment	Jan 14, 2026 1:50pm

10 Skipped Deployments

Project	Deployment	Review	Updated (UTC)
appkit-basic-example	Ignored		Jan 14, 2026 1:50pm
appkit-basic-sign-client-example	Ignored		Jan 14, 2026 1:50pm
appkit-basic-up-example	Ignored		Jan 14, 2026 1:50pm
appkit-ethers5-bera	Ignored		Jan 14, 2026 1:50pm
appkit-nansen-demo	Ignored		Jan 14, 2026 1:50pm
appkit-vue-solana	Ignored		Jan 14, 2026 1:50pm
appkit-wagmi-cdn-example	Ignored		Jan 14, 2026 1:50pm
ethereum-provider-wagmi-example	Ignored		Jan 14, 2026 1:50pm
next-wagmi-solana-bitcoin-example	Ignored		Jan 14, 2026 1:50pm
vue-wagmi-example	Ignored		Jan 14, 2026 1:50pm

[github-actions]

Visual Regression Test Results ✅ Passed

⚠️ 15 visual change(s) detected

Chromatic Build: https://www.chromatic.com/build?appId=6493191bf4b10fed8ca7353f&number=637
Storybook Preview: https://6493191bf4b10fed8ca7353f-pfudzjpioa.chromatic.com/

👉 Please review the visual changes in Chromatic and accept or reject them.

[github-actions]

	Warnings
⚠️	🌐 Non-company domain introduced (host: github.com) in AGENTS.md (line 138): https://github.com/changesets/changesets)
⚠️	🌐 Non-company domain introduced (host: github.com) in AGENTS.md (line 138): https://github.com/changesets/changesets)

Generated by 🚫 dangerJS against 6c7da1f

[github-actions]

📦 Bundle Size Check

✅ All bundles are within size limits

📊 View detailed bundle sizes

> @reown/appkit-monorepo@1.7.1 size /home/runner/work/appkit/appkit

> size-limit

@reown/appkit - Main Entry
Size limit:   80 kB
Size:         75.21 kB with all dependencies, minified and gzipped
Loading time: 1.5 s    on slow 3G
Running time: 288 ms   on Snapdragon 410
Total time:   1.8 s
@reown/appkit/react
Size limit:   235 kB
Size:         233.03 kB with all dependencies, minified and gzipped
Loading time: 4.6 s     on slow 3G
Running time: 751 ms    on Snapdragon 410
Total time:   5.4 s
@reown/appkit/vue
Size limit:   80 kB
Size:         75.21 kB with all dependencies, minified and gzipped
Loading time: 1.5 s    on slow 3G
Running time: 248 ms   on Snapdragon 410
Total time:   1.8 s
@reown/appkit-scaffold-ui
Size limit:   220 kB
Size:         213.09 kB with all dependencies, minified and gzipped
Loading time: 4.2 s     on slow 3G
Running time: 387 ms    on Snapdragon 410
Total time:   4.6 s
@reown/appkit-ui
Size limit:   500 kB
Size:         13.16 kB with all dependencies, minified and gzipped
Loading time: 258 ms   on slow 3G
Running time: 85 ms    on Snapdragon 410
Total time:   342 ms

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🔵	Lines	78.62%	39385 / 50090
🔵	Statements	78.62%	39385 / 50090
🔵	Functions	76.38%	4243 / 5555
🔵	Branches	86.73%	9569 / 11032

File Coverage

No changed files found.

Generated in workflow #16687 for commit 6c7da1f by the Vitest Coverage Report Action