Skip to content

feat(skills): Link agent framework docs guides #374

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cleptric merged 6 commits into from
Oct 20, 2026
Merged

feat(skills): Link agent framework docs guides #374

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
452024c
feat(skills): Link agent framework docs guides
cleptric Oct 20, 2026
e9a7380
fix(skills): Drop React Native agent tracing link
cleptric Oct 20, 2026
89bbe7a
fix(skills): Link Bun and Deno agent tracing pages
cleptric Oct 20, 2026
5737035
ref(skills): Drop duplicate agent framework table
cleptric Oct 20, 2026
af6279a
ref(skills): Drop Eve section now covered by its guide
cleptric Oct 20, 2026
bc6c1cc
feat(skills): Route agent frameworks to their own guides
cleptric Oct 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/SKILL_TREE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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". |
52 changes: 25 additions & 27 deletions src/references/concepts/ai-monitoring.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,32 +27,44 @@ 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/) |
| 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

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:

| 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/) |
Expand All @@ -64,20 +76,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

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/).
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.

## Decisions before editing

Before making an AI-monitoring change, answer these from the docs and the project state:
Expand Down
7 changes: 6 additions & 1 deletion src/references/sdk-docs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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) |
Expand Down
2 changes: 1 addition & 1 deletion src/skills/sentry-instrument/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
Expand Down
Loading