chore: Improve agent docs, add skills, and curate skill set

[buenaflor]

📜 Description

Improves the developer experience for this repo by:

• Rewriting agent documentation (AGENTS.md) to be actionable and concise
• Adding skills (test-conventions, code-guidelines) that auto-activate during relevant tasks
• Curating agents.toml to only include relevant skills
• Adding melos scripts for analyze, format, and test with proper dart/flutter filtering
• Adding a pre-commit hook that auto-formats staged .dart files and only analyzes changed packages
• Adding FVM integration via sdkPath in melos.yaml

💡 Motivation and Context

The previous agent docs were noisy and not actionable. The repo also lacked local development tooling (pre-commit hooks, melos scripts, FVM). This PR addresses both.

Closes DART-343

💚 How did you test it?

• Verified pre-commit hook scopes correctly by staging changes in individual packages:
  • Staging a packages/dio/ file: dart analyze ran on 1 package, flutter analyze on 0
  • Staging a packages/flutter/ file: dart analyze ran on 0 packages, flutter analyze on 2
  • Staging only root files: hook skips with "No package changes staged"
• Verified auto-format: staged a badly formatted file, hook reformatted and re-staged it
• Verified melos run format, melos run analyze:dart, melos run analyze:flutter work independently

📝 Checklist

• I reviewed submitted code
• I added tests to verify changes
• No new PII added or SDK only sends newly added PII if sendDefaultPii is enabled
• I updated the docs if needed
• All tests passing
• No breaking changes

#skip-changelog

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 88.12%. Comparing base (563056a) to head (e1dd1a4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #3611   +/-   ##
=======================================
  Coverage   88.12%   88.12%           
=======================================
  Files         304      304           
  Lines       10372    10372           
=======================================
  Hits         9140     9140           
  Misses       1232     1232           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[sentry]

Sentry Build Distribution

App Name	App ID	Version	Configuration	Install Page
sentry_flutter_example	io.sentry.flutter.sample	9.16.0 (1)	Release	Install Build

[Copilot]

Pull request overview

Improves developer tooling and AI/agent guidance for the Dart/Flutter monorepo by adding Melos scripts, git hooks, and restructuring agent “skills” documentation.

Changes:

• Added melos.yaml scripts for analyze/format/test plus FVM integration and post-bootstrap hook configuration.
• Introduced a pre-commit hook to auto-format staged Dart files and analyze only affected packages.
• Reworked agent documentation structure (new AGENTS.md content, new skill files, curated agents.toml, and updated contributing docs).

Reviewed changes

Copilot reviewed 15 out of 16 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
packages/flutter/example/pubspec_overrides.yaml	Adjusts melos-managed overrides and simplifies git dependency syntax.
packages/flutter/CLAUDE.md	Adds local pointer content for agent instructions.
packages/flutter/AGENTS.md	Adds package-specific agent guidance for sentry_flutter.
packages/dart/CLAUDE.md	Adds local pointer content for agent instructions.
packages/dart/AGENTS.md	Adds package-specific agent guidance for sentry.
melos.yaml	Adds FVM sdkPath, bootstrap hook, and common scripts (analyze/format/test).
docs/agent_instructions/test-conventions.md	Removes old test conventions doc (replaced by skill).
docs/agent_instructions/code-guidelines.md	Converts to a named skill-like document and expands guidelines.
agents.toml	Introduces curated agent skill sources and trust configuration.
CONTRIBUTING.md	Updates toolchain/environment setup, adds fvm + hook documentation.
AGENTS.md	Rewrites top-level agent guide (commands, conventions, skill references).
.gitignore	Ignores dotagents-generated files.
.githooks/pre-commit	Adds pre-commit hook for formatting and scoped analyzes.
.claude/skills	Points Claude skill discovery at .agents/skills.
.claude/settings.json	Loads the new test-conventions / code-guidelines skills.
.agents/skills/test-conventions/SKILL.md	Adds the new test-conventions skill definition and rules.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Autofix Details

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Pre-commit hook silently skips core sentry package analysis
  • Added special case handling for the dart directory to map to --scope=sentry instead of --scope=*dart* since the packages/dart/ directory contains the package named 'sentry'.

Or push these changes by commenting:

@cursor push 9d343c5fd9

Preview (9d343c5fd9)

diff --git a/.githooks/pre-commit b/.githooks/pre-commit
--- a/.githooks/pre-commit
+++ b/.githooks/pre-commit
@@ -9,9 +9,14 @@
 fi
 
 # Build --scope flags for melos exec
+# Note: packages/dart/ contains the 'sentry' package, not 'sentry_dart'
 SCOPE=""
 for pkg in $CHANGED; do
-  SCOPE="$SCOPE --scope=*${pkg}*"
+  if [ "$pkg" = "dart" ]; then
+    SCOPE="$SCOPE --scope=sentry"
+  else
+    SCOPE="$SCOPE --scope=*${pkg}*"
+  fi
 done
 
 # Auto-format staged .dart files and re-stage them

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}

[github-actions]

iOS Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1253.45 ms	1247.63 ms	-5.82 ms
Size	5.73 MiB	6.17 MiB	455.49 KiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
51520fc	1253.87 ms	1254.87 ms	1.00 ms
0e2b9b0	1248.69 ms	1252.22 ms	3.54 ms
c8596a6	1234.11 ms	1241.19 ms	7.08 ms
bfabaf2	1251.72 ms	1253.38 ms	1.67 ms
29e8ebe	1260.46 ms	1262.60 ms	2.14 ms
1777727	1249.21 ms	1258.40 ms	9.18 ms
6b69699	1254.80 ms	1273.31 ms	18.52 ms
e3f3ea1	1262.83 ms	1264.83 ms	1.99 ms
827bf09	1261.86 ms	1276.41 ms	14.55 ms
944b773	1252.82 ms	1254.08 ms	1.27 ms

App size

Revision	Plain	With Sentry	Diff
51520fc	5.53 MiB	5.96 MiB	443.39 KiB
0e2b9b0	5.73 MiB	6.17 MiB	453.79 KiB
c8596a6	7.86 MiB	9.44 MiB	1.58 MiB
bfabaf2	5.53 MiB	6.01 MiB	487.95 KiB
29e8ebe	5.53 MiB	6.01 MiB	488.12 KiB
1777727	5.73 MiB	6.17 MiB	453.78 KiB
6b69699	7.86 MiB	9.44 MiB	1.58 MiB
e3f3ea1	5.53 MiB	5.96 MiB	443.28 KiB
827bf09	7.86 MiB	9.44 MiB	1.58 MiB
944b773	5.53 MiB	6.00 MiB	479.98 KiB

[denrase]

This is the way

[linear-code]

DART-343 build: Add pre-commit hooks, melos scripts, and agent docs

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[buenaflor]

Failing test is not relevant to this PR