Skip to content

docs(skills): Cover span descriptions in the port-span-names skill - #24569

Draft
Lms24 wants to merge 1 commit into
developfrom
docs/port-span-names-descriptions
Draft

Lms24 wants to merge 1 commit into
developfrom
docs/port-span-names-descriptions

Conversation

@Lms24

@Lms24 Lms24 commented Sep 21, 2026

Copy link
Copy Markdown
Member

Porting an op to low-cardinality names silently drops information, and the skill never said so. Relay re-derives descriptions from a separate, much shorter set of templates than the name rules — function has exactly one, {{code.function.name}}, with no fallback — so for most ops it cannot rebuild the name the span gave up. The skill now walks that check and says when to set sentry.description locally instead, which is what the react-router and tanstackstart ports ended up doing.

Also widens the enumeration step, which is how this got missed in the first place: its grep only matched string-literal ops, so it skipped every site using the constant from @sentry/conventions/op (nearly all of them), plus ops arriving through a wrapper option, a helper return value, or a parameter default. Drop that second commit-worth of changes if you'd rather keep this PR to the description guidance.

🤖 Generated with Claude Code

Porting an op to low-cardinality names silently drops information: Relay
re-derives descriptions from a separate, much shorter set of templates
than the name rules, and for several ops (`function` has one template and
no fallback) it cannot rebuild the name the span gave up. Document that
check, and when to set `sentry.description` locally instead.

Also widen the enumeration step. Its grep only matched string-literal
ops, so it missed every site using the constant from
`@sentry/conventions/op` - which is nearly all of them - as well as ops
that arrive through a wrapper option, a helper return value or a
parameter default.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant