Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
53 changes: 0 additions & 53 deletions .cursor/rules/coding.mdc

This file was deleted.

133 changes: 0 additions & 133 deletions .cursor/rules/overview_dev.mdc

This file was deleted.

33 changes: 24 additions & 9 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,30 @@

This file provides guidance to AI coding agents when working with code in this repository.

## STOP β€” Required Reading (Do This First)

Before doing ANYTHING else (including answering questions), you MUST use the Read tool to load these files:
1. `.cursor/rules/coding.mdc`
2. `.cursor/rules/overview_dev.mdc`

Then identify and read any topically relevant `.cursor/rules/*.mdc` files for the area you're working on (e.g., `opentelemetry.mdc` for OTel work, `metrics.mdc` for metrics work). Use the Glob tool on `.cursor/rules/*.mdc` to discover available rule files.

Do NOT skip this step. Do NOT proceed without reading these files first.
## Domain-Specific Rules

This file covers the whole repository. Before working on a specific area, read the matching
rule file in `.cursor/rules/`:

| Rule | Read it when working on |
|---|---|
Comment thread
runningcode marked this conversation as resolved.
| `api` | Public API surface, binary compatibility, `.api` files, `apiDump`, `IScope`/`IScopes`/`Sentry` static API, protocol classes |
| `options` | `SentryOptions`, namespaced options, `ExternalOptions`, `sentry.properties`, `ManifestMetadataReader`, Spring Boot properties |
| `scopes` | Scope management, forking, lifecycle, `ScopeType`, thread-local storage, scope bleeding, Hub β†’ Scopes migration |
| `deduplication` | Duplicate event detection, `DuplicateEventDetectionEventProcessor`, `enableDeduplication` |
| `offline` | Caching, envelope storage, network failure handling, retries, `AsyncHttpTransport`, `EnvelopeCache`, rate limiting |
| `feature_flags` | `addFeatureFlag`, `FeatureFlagBuffer`, `maxFeatureFlags`, LaunchDarkly and OpenFeature integrations |
| `metrics` | `Sentry.metrics()`, `IMetricsApi`, count/distribution/gauge, `MetricsBatchProcessor` |
| `queues` | Queue tracing, `queue.publish`/`queue.process`, `enableQueueTracing`, Kafka instrumentation, messaging span data |
| `continuous_profiling_jvm` | `sentry-async-profiler`, `IContinuousProfiler`, `ProfileChunk`, JFR files, `ProfileLifecycle` |
| `opentelemetry` | `sentry-opentelemetry-*`, agent vs agentless, span processing, sampling, context propagation |
| `new_module` | Adding a new integration or sample module |
| `pr` | Creating pull requests, stacked PRs, changelog entries |
| `e2e_tests` | System tests, sample applications, `system-test-runner.py`, mock Sentry server |

Rules can be combined β€” a tracing scope issue may need both `scopes` and `opentelemetry`.
There is no rule for Android profiling yet; read the `sentry-android-core` profiling code
directly and fetch related rules such as `options`, `offline`, or `api` as needed.

## Project Overview

Expand Down
7 changes: 5 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,8 @@

## STOP β€” Required Reading (Do This First)

Before doing ANYTHING else (including answering questions), you MUST use the Read tool to load [AGENTS.md](AGENTS.md) and follow ALL of its instructions, including reading the required `.cursor/rules/*.mdc` files it references.
Do NOT skip this step. Do NOT proceed without reading these files first.
Before doing ANYTHING else (including answering questions), you MUST use the Read tool to load
[AGENTS.md](AGENTS.md) and follow ALL of its instructions. It is the single source of truth
for build commands, contributing guidelines, workflow rules, and the index of the
domain-specific rules.
Do NOT skip this step. Do NOT proceed without reading it first.
Loading