From 452024c432a8c7447ee4186362f7633b705b202c Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 14:22:16 +0200 Subject: [PATCH 1/6] feat(skills): Link agent framework docs guides Add Pi Durable and route Mastra, Eve, and Flue to their own guides. Update AI integration links that moved in the docs. Co-Authored-By: Claude Opus 5.5 (1M context) --- src/SKILL_TREE.md | 2 +- src/references/concepts/ai-monitoring.md | 46 +++++++++++++++--------- src/references/sdk-docs.md | 7 +++- src/skills/sentry-instrument/SKILL.md | 2 +- 4 files changed, 37 insertions(+), 20 deletions(-) diff --git a/src/SKILL_TREE.md b/src/SKILL_TREE.md index 1d629a09..43c095bb 100644 --- a/src/SKILL_TREE.md +++ b/src/SKILL_TREE.md @@ -30,7 +30,7 @@ Each one is self-contained and named for the job it does. If you're not sure wha | [`sentry-debug-issue`](skills/sentry-debug-issue/SKILL.md) | Debug and fix a Sentry issue — find it (by link, ID, or search), pull full context (stack trace, breadcrumbs, trace, logs), optionally run Seer root-cause / autofix, apply the code fix, and resolve it via a `Fixes PROJECT-NAME-12A` commit/PR. Use when working a known error or hunting one down to fix. | | [`sentry-fix-stack-traces`](skills/sentry-fix-stack-traces/SKILL.md) | Make Sentry stack traces readable — upload source maps for JavaScript/TypeScript, or debug files for native and mobile (dSYM, ProGuard/R8, NDK symbols, Dart obfuscation maps, .NET PDBs). Use when frames in Sentry show minified names, bundled paths, hex addresses, "unknown", or method names with no file/line, instead of your original source. | | [`sentry-get-started`](skills/sentry-get-started/SKILL.md) | Guided entry point for using Sentry through your agent. Orients you to your current setup and, for a new project, sets up Sentry end to end with sane defaults — provision a project, install the SDK (errors, tracing, and whatever it enables by default), and confirm real telemetry reaches Sentry. Routes other intents (adding more signals, fixing issues) to the right skill. | -| [`sentry-instrument`](skills/sentry-instrument/SKILL.md) | Instrument an application with Sentry — detect the platform, install and initialize the SDK if needed, and wire up any signal — error monitoring, tracing/performance, logging, metrics, profiling, session replay, user feedback, cron check-ins, uptime monitors for the deployed app, and AI/LLM monitoring (agent runs, token cost, and conversations for OpenAI, Anthropic, Vercel AI, LangChain, Google GenAI, Pydantic AI, Laravel AI, Eve, Flue, the Cloudflare Agents SDK, and Workers AI). Use to add Sentry to a project or to capture more than errors. | +| [`sentry-instrument`](skills/sentry-instrument/SKILL.md) | Instrument an application with Sentry — detect the platform, install and initialize the SDK if needed, and wire up any signal — error monitoring, tracing/performance, logging, metrics, profiling, session replay, user feedback, cron check-ins, uptime monitors for the deployed app, and AI/LLM monitoring (agent runs, token cost, and conversations for OpenAI, Anthropic, Vercel AI, LangChain, Google GenAI, Pydantic AI, Laravel AI, Mastra, Eve, Flue, Pi Durable, the Cloudflare Agents SDK, and Workers AI). Use to add Sentry to a project or to capture more than errors. | | [`sentry-otel-exporter-setup`](skills/sentry-otel-exporter-setup/SKILL.md) | Configure the OpenTelemetry Collector with Sentry Exporter for multi-project routing and automatic project creation. Use when setting up OTel with Sentry, configuring collector pipelines for traces and logs, or routing telemetry from multiple services to Sentry projects. | | [`sentry-setup-releases`](skills/sentry-setup-releases/SKILL.md) | Set up Sentry releases and deploy tracking — tag events with a version and environment, create the release in CI with its commits, and wire up suspect commits and code mappings, so Sentry can show which release introduced an issue, which commit is responsible, and release health. Use when asked to set up releases, track deploys, see what changed, or when issues show an unknown release or no suspect commit. | | [`sentry-snapshots-cocoa`](skills/sentry-snapshots-cocoa/SKILL.md) | Full Sentry Snapshots setup for Apple/Cocoa projects. Use when asked to "setup SnapshotPreviews", "setup Apple snapshot testing", "upload Apple snapshots to Sentry", "setup Apple snapshot GitHub Actions", or "setup Apple selective snapshot testing". | diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index ee24b1f7..450dbd85 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -36,23 +36,36 @@ Open the platform docs before changing code: | React Native | [React Native Agent Tracing](https://docs.sentry.io/platforms/react-native/agent-tracing/) | | Custom spans | [Sentry GenAI conventions](https://github.com/getsentry/sentry-conventions/) | +## Agent framework guides + +These agent frameworks have their own guide, which covers install, `init`, and AI +instrumentation together. +When the project uses one, follow its guide instead of the platform page and the +integration docs below: + +| Agent framework | Follow | +| --- | --- | +| Mastra | [Mastra](https://docs.sentry.io/platforms/javascript/guides/mastra/) | +| Eve | [Eve](https://docs.sentry.io/platforms/javascript/guides/eve/) | +| Flue on Node.js | [Flue](https://docs.sentry.io/platforms/javascript/guides/flue/) | +| Flue on Cloudflare | [Flue Cloudflare Quick Start](https://docs.sentry.io/platforms/javascript/guides/flue/cloudflare/) | +| Pi Durable on Node.js | [Pi Durable](https://docs.sentry.io/platforms/javascript/guides/pi-durable/) | +| Pi Durable on Cloudflare | [Pi Durable Cloudflare Quick Start](https://docs.sentry.io/platforms/javascript/guides/pi-durable/cloudflare/) | + ## Integration docs Follow the matching integration docs after the platform is known: | AI stack | Follow | | --- | --- | -| Vercel AI SDK | [Vercel AI SDK Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/vercelai/) | -| OpenAI (JavaScript) | [OpenAI Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/openai/) | -| Anthropic (JavaScript) | [Anthropic Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/anthropic/) | -| Google Gen AI SDK (JavaScript) | [Google Gen AI Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/google-genai/) | -| LangChain (JavaScript) | [LangChain Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/langchain/) | -| LangGraph (JavaScript) | [LangGraph Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/langgraph/) | -| Mastra | [Mastra Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/mastra/) | -| Flue on Node.js | [Flue Node Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/flue/) | -| Flue on Cloudflare | [Flue Cloudflare Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/flue/) | -| Workers AI | [Workers AI](https://docs.sentry.io/platforms/javascript/guides/cloudflare/features/workers-ai/) | -| Cloudflare Agents SDK | [Cloudflare Agents SDK](https://docs.sentry.io/platforms/javascript/guides/cloudflare/features/agents-sdk/) | +| Vercel AI SDK | [Vercel AI SDK Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/vercelai/) | +| OpenAI (JavaScript) | [OpenAI Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/openai/) | +| Anthropic (JavaScript) | [Anthropic Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/anthropic/) | +| Google Gen AI SDK (JavaScript) | [Google Gen AI Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/google-genai/) | +| LangChain (JavaScript) | [LangChain Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/langchain/) | +| LangGraph (JavaScript) | [LangGraph Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/configuration/integrations/langgraph/) | +| Workers AI | [Workers AI](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/workers-ai/) | +| Cloudflare Agents SDK | [Cloudflare Agents SDK](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/agents-sdk/) | | OpenAI (Python) | [Python OpenAI Agent Tracing](https://docs.sentry.io/platforms/python/agent-tracing/openai/) | | OpenAI Agents SDK (Python) | [OpenAI Agents SDK Agent Tracing](https://docs.sentry.io/platforms/python/agent-tracing/openai-agents/) | | Anthropic (Python) | [Python Anthropic Agent Tracing](https://docs.sentry.io/platforms/python/agent-tracing/anthropic/) | @@ -66,17 +79,16 @@ Follow the matching integration docs after the platform is known: ## Eve -For Eve, support the Sentry Node SDK path so it behaves like the other JavaScript AI -setups. Follow -[Node Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/) -and the -[Vercel AI SDK guide](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/vercelai/). +The [Eve guide](https://docs.sentry.io/platforms/javascript/guides/eve/) sets up the +Sentry Node SDK through Eve’s instrumentation provider, so Eve behaves like the other +JavaScript AI setups. This path requires `@sentry/node` v11 or newer. Do not install Eve’s OTLP exporter for the same runtime unless the user explicitly asks for the trace-only Eve exporter path. If an Eve OTLP exporter already exists, ask whether to keep that trace-only setup or -switch to the Node SDK setup; do not run both. +switch to the Node SDK setup; switching means removing the exporter first, since both +produce AI spans and running them together duplicates spans and token totals. ## Decisions before editing diff --git a/src/references/sdk-docs.md b/src/references/sdk-docs.md index b3a05127..83970661 100644 --- a/src/references/sdk-docs.md +++ b/src/references/sdk-docs.md @@ -16,7 +16,8 @@ don’t assume from files alone — then fetch that platform’s page from the t platform list. When more than one row matches, prefer the most specific framework (Next.js over React -or Node.js, NestJS over Node.js, Cloudflare over Node.js, React Native over React). +or Node.js, NestJS over Node.js, Cloudflare over Node.js, React Native over React, an +agent framework such as Eve, Flue, Mastra, or Pi Durable over Node.js or Cloudflare). If nothing matches, or a framework guide fits better than the row you found (an ASP.NET Core app on .NET, say), pick it from the [platform list](https://docs.sentry.io/platforms.md). @@ -32,13 +33,17 @@ Core app on .NET, say), pick it from the | Deno | `deno.json`, `deno.jsonc` | [Deno](https://docs.sentry.io/platforms/javascript/guides/deno.md) | | .NET | `*.csproj`, `*.sln`, `*.slnx` | [.NET](https://docs.sentry.io/platforms/dotnet.md) | | Elixir | `mix.exs` | [Elixir](https://docs.sentry.io/platforms/elixir.md) | +| Eve | `eve` | [Eve](https://docs.sentry.io/platforms/javascript/guides/eve.md) | +| Flue | `@flue/runtime` | [Flue](https://docs.sentry.io/platforms/javascript/guides/flue.md) | | Flutter | `pubspec.yaml` with a `flutter` dependency | [Flutter](https://docs.sentry.io/platforms/dart/guides/flutter.md) | | Go | `go.mod` | [Go](https://docs.sentry.io/platforms/go.md) | | Laravel | `laravel/framework` in `composer.json` | [Laravel](https://docs.sentry.io/platforms/php/guides/laravel.md) | +| Mastra | `@mastra/core` | [Mastra](https://docs.sentry.io/platforms/javascript/guides/mastra.md) | | NestJS | `@nestjs/core` | [NestJS](https://docs.sentry.io/platforms/javascript/guides/nestjs.md) | | Next.js | `next` | [Next.js](https://docs.sentry.io/platforms/javascript/guides/nextjs.md) | | Node.js | `package.json` without a more specific framework | [Node.js](https://docs.sentry.io/platforms/javascript/guides/node.md) | | PHP | `composer.json` | [PHP](https://docs.sentry.io/platforms/php.md) | +| Pi Durable | `@earendil-works/pi-durable` | [Pi Durable](https://docs.sentry.io/platforms/javascript/guides/pi-durable.md) | | Python | `requirements.txt`, `pyproject.toml`, `Pipfile`, `uv.lock` | [Python](https://docs.sentry.io/platforms/python.md) | | Rails | `rails` in `Gemfile` | [Rails](https://docs.sentry.io/platforms/ruby/guides/rails.md) | | React | `react` without a more specific framework | [React](https://docs.sentry.io/platforms/javascript/guides/react.md) | diff --git a/src/skills/sentry-instrument/SKILL.md b/src/skills/sentry-instrument/SKILL.md index b8d278a9..37975d03 100644 --- a/src/skills/sentry-instrument/SKILL.md +++ b/src/skills/sentry-instrument/SKILL.md @@ -1,6 +1,6 @@ --- name: sentry-instrument -description: Instrument an application with Sentry — detect the platform, install and initialize the SDK if needed, and wire up any signal — error monitoring, tracing/performance, logging, metrics, profiling, session replay, user feedback, cron check-ins, uptime monitors for the deployed app, and AI/LLM monitoring (agent runs, token cost, and conversations for OpenAI, Anthropic, Vercel AI, LangChain, Google GenAI, Pydantic AI, Laravel AI, Eve, Flue, the Cloudflare Agents SDK, and Workers AI). Use to add Sentry to a project or to capture more than errors. +description: Instrument an application with Sentry — detect the platform, install and initialize the SDK if needed, and wire up any signal — error monitoring, tracing/performance, logging, metrics, profiling, session replay, user feedback, cron check-ins, uptime monitors for the deployed app, and AI/LLM monitoring (agent runs, token cost, and conversations for OpenAI, Anthropic, Vercel AI, LangChain, Google GenAI, Pydantic AI, Laravel AI, Mastra, Eve, Flue, Pi Durable, the Cloudflare Agents SDK, and Workers AI). Use to add Sentry to a project or to capture more than errors. license: Apache-2.0 --- # Sentry Instrument From e9a738030d88a4b8f3cec57c70464e56cff5c3a6 Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 14:25:31 +0200 Subject: [PATCH 2/6] fix(skills): Drop React Native agent tracing link Co-Authored-By: Claude Opus 5.5 (1M context) --- src/references/concepts/ai-monitoring.md | 1 - 1 file changed, 1 deletion(-) diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index 450dbd85..97104ee4 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -33,7 +33,6 @@ Open the platform docs before changing code: | Cloudflare Workers / Pages | [Cloudflare Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/) | | Python | [Python Agent Tracing](https://docs.sentry.io/platforms/python/agent-tracing/) | | Laravel / PHP | [Laravel Agent Tracing](https://docs.sentry.io/platforms/php/guides/laravel/agent-tracing/) | -| React Native | [React Native Agent Tracing](https://docs.sentry.io/platforms/react-native/agent-tracing/) | | Custom spans | [Sentry GenAI conventions](https://github.com/getsentry/sentry-conventions/) | ## Agent framework guides From 89bbe7a405efdbc97d42e156210d75f24aa08ec0 Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 14:26:37 +0200 Subject: [PATCH 3/6] fix(skills): Link Bun and Deno agent tracing pages Co-Authored-By: Claude Opus 5.5 (1M context) --- src/references/concepts/ai-monitoring.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index 97104ee4..3e8a9bab 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -27,7 +27,9 @@ Open the platform docs before changing code: | Platform or runtime | Follow | | --- | --- | -| Node.js, Bun, or Deno | [Node Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/) | +| Node.js | [Node Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/node/agent-tracing/) | +| Bun | [Bun Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/bun/agent-tracing/) | +| Deno | [Deno Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/deno/agent-tracing/) | | Next.js | [Next.js Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/nextjs/agent-tracing/) | | NestJS | [NestJS Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/nestjs/agent-tracing/) | | Cloudflare Workers / Pages | [Cloudflare Agent Tracing](https://docs.sentry.io/platforms/javascript/guides/cloudflare/agent-tracing/) | From 573703581b46e730fea50099ca4e43ea81f2c98b Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 14:28:06 +0200 Subject: [PATCH 4/6] ref(skills): Drop duplicate agent framework table Co-Authored-By: Claude Opus 5.5 (1M context) --- src/references/concepts/ai-monitoring.md | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index 3e8a9bab..ffd7973f 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -37,22 +37,6 @@ Open the platform docs before changing code: | Laravel / PHP | [Laravel Agent Tracing](https://docs.sentry.io/platforms/php/guides/laravel/agent-tracing/) | | Custom spans | [Sentry GenAI conventions](https://github.com/getsentry/sentry-conventions/) | -## Agent framework guides - -These agent frameworks have their own guide, which covers install, `init`, and AI -instrumentation together. -When the project uses one, follow its guide instead of the platform page and the -integration docs below: - -| Agent framework | Follow | -| --- | --- | -| Mastra | [Mastra](https://docs.sentry.io/platforms/javascript/guides/mastra/) | -| Eve | [Eve](https://docs.sentry.io/platforms/javascript/guides/eve/) | -| Flue on Node.js | [Flue](https://docs.sentry.io/platforms/javascript/guides/flue/) | -| Flue on Cloudflare | [Flue Cloudflare Quick Start](https://docs.sentry.io/platforms/javascript/guides/flue/cloudflare/) | -| Pi Durable on Node.js | [Pi Durable](https://docs.sentry.io/platforms/javascript/guides/pi-durable/) | -| Pi Durable on Cloudflare | [Pi Durable Cloudflare Quick Start](https://docs.sentry.io/platforms/javascript/guides/pi-durable/cloudflare/) | - ## Integration docs Follow the matching integration docs after the platform is known: From af6279a5196ece505d6a009087c0698ff54a04a4 Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 14:35:00 +0200 Subject: [PATCH 5/6] ref(skills): Drop Eve section now covered by its guide Co-Authored-By: Claude Opus 5.5 (1M context) --- src/references/concepts/ai-monitoring.md | 13 ------------- 1 file changed, 13 deletions(-) diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index ffd7973f..a07dc75c 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -62,19 +62,6 @@ Follow the matching integration docs after the platform is known: | Hugging Face Hub | [Hugging Face Hub Agent Tracing](https://docs.sentry.io/platforms/python/agent-tracing/huggingface_hub/) | | Laravel AI | [Laravel AI integration](https://docs.sentry.io/platforms/php/guides/laravel/integrations/laravel-ai/) | -## Eve - -The [Eve guide](https://docs.sentry.io/platforms/javascript/guides/eve/) sets up the -Sentry Node SDK through Eve’s instrumentation provider, so Eve behaves like the other -JavaScript AI setups. -This path requires `@sentry/node` v11 or newer. - -Do not install Eve’s OTLP exporter for the same runtime unless the user explicitly asks -for the trace-only Eve exporter path. -If an Eve OTLP exporter already exists, ask whether to keep that trace-only setup or -switch to the Node SDK setup; switching means removing the exporter first, since both -produce AI spans and running them together duplicates spans and token totals. - ## Decisions before editing Before making an AI-monitoring change, answer these from the docs and the project state: From bc6c1cc3aa3a515378dbdc568de4fe0790aceaea Mon Sep 17 00:00:00 2001 From: Michael Hoffmann Date: Tue, 20 Oct 2026 15:53:18 +0200 Subject: [PATCH 6/6] feat(skills): Route agent frameworks to their own guides Co-Authored-By: Claude Opus 5.5 (1M context) --- src/references/concepts/ai-monitoring.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/references/concepts/ai-monitoring.md b/src/references/concepts/ai-monitoring.md index a07dc75c..5cca1e89 100644 --- a/src/references/concepts/ai-monitoring.md +++ b/src/references/concepts/ai-monitoring.md @@ -37,6 +37,20 @@ Open the platform docs before changing code: | Laravel / PHP | [Laravel Agent Tracing](https://docs.sentry.io/platforms/php/guides/laravel/agent-tracing/) | | Custom spans | [Sentry GenAI conventions](https://github.com/getsentry/sentry-conventions/) | +## Agent framework guides + +These frameworks have their own guide, which owns install, `init`, and AI +instrumentation. When the project uses one, follow its guide instead of the platform row +and the integration rows below, even when it is built on one of those SDKs (Eve on the +Vercel AI SDK, for example). + +| Agent framework | Follow | +| --- | --- | +| Eve | [Eve](https://docs.sentry.io/platforms/javascript/guides/eve/) | +| Flue | [Flue](https://docs.sentry.io/platforms/javascript/guides/flue/) | +| Mastra | [Mastra](https://docs.sentry.io/platforms/javascript/guides/mastra/) | +| Pi Durable | [Pi Durable](https://docs.sentry.io/platforms/javascript/guides/pi-durable/) | + ## Integration docs Follow the matching integration docs after the platform is known: