chore: Add AGENTS.md, CLAUDE.md symlink, and Claude Code settings (#515)

Add agent-facing documentation covering build commands, quality gate,
repository structure, KMP conventions, and commit attribution. Add
Claude Code project settings with Gradle, git, and GitHub CLI
permissions tailored for Kotlin Multiplatform development.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: buenaflor

.claude/settings.json

@@ -0,0 +1,66 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls:*)",
+      "Bash(pwd:*)",
+      "Bash(file:*)",
+      "Bash(stat:*)",
+      "Bash(wc:*)",
+      "Bash(tree:*)",
+
+      "Bash(git pull:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git status:*)",
+      "Bash(git log:*)",
+      "Bash(git diff:*)",
+      "Bash(git show:*)",
+      "Bash(git branch:*)",
+      "Bash(git remote:*)",
+      "Bash(git tag:*)",
+      "Bash(git stash list:*)",
+      "Bash(git rev-parse:*)",
+      "Bash(git fetch:*)",
+      "Bash(git ls-files:*)",
+      "Bash(git blame:*)",
+
+      "Bash(gh pr view:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr checks:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(gh issue view:*)",
+      "Bash(gh issue list:*)",
+      "Bash(gh run view:*)",
+      "Bash(gh run list:*)",
+      "Bash(gh run logs:*)",
+      "Bash(gh repo view:*)",
+      "Bash(gh api:*)",
+
+      "Bash(./gradlew tasks:*)",
+      "Bash(./gradlew dependencies:*)",
+      "Bash(./gradlew build:*)",
+      "Bash(./gradlew clean:*)",
+      "Bash(./gradlew test:*)",
+      "Bash(./gradlew detekt:*)",
+      "Bash(./gradlew spotlessKotlinCheck:*)",
+      "Bash(./gradlew spotlessApply:*)",
+      "Bash(./gradlew apiCheck:*)",
+      "Bash(./gradlew koverXmlReport:*)",
+      "Bash(./gradlew dokkaHtmlMultiModule:*)",
+      "Bash(./gradlew publishToMavenLocal:*)",
+      "Bash(./gradlew --stop:*)",
+      "Bash(make:*)",
+
+      "WebFetch(domain:docs.sentry.io)",
+      "WebFetch(domain:develop.sentry.dev)",
+      "WebFetch(domain:kotlinlang.org)",
+      "WebFetch(domain:developer.android.com)",
+      "WebFetch(domain:docs.github.com)",
+      "WebFetch(domain:cli.github.com)",
+
+      "Skill(sentry-skills:agents-md)"
+    ],
+    "deny": []
+  }
+}

AGENTS.MD

@@ -0,0 +1,53 @@
+# AGENTS.md
+
+Sentry Kotlin Multiplatform (KMP) SDK and Gradle Plugin.
+
+## Build
+
+- **Build tool**: Gradle via `./gradlew`
+- **Format**: `./gradlew spotlessApply`
+- **Lint**: `./gradlew detekt`
+- **Test**: `./gradlew build` (builds and runs tests)
+- **API check**: `./gradlew apiCheck` (binary compatibility)
+- **Full CI**: `make compile` (runs apiCheck, detekt, build, samples)
+
+## Quality Gate
+
+Before committing, ensure these pass:
+```bash
+./gradlew spotlessApply
+./gradlew detekt
+./gradlew build
+./gradlew apiCheck
+```
+
+## Repository Structure
+
+```
+├── sentry-kotlin-multiplatform/              # Core KMP SDK
+│   └── src/
+│       ├── commonMain/                       # Shared API & expect declarations
+│       ├── commonJvmMain/                    # Shared JVM + Android code
+│       ├── androidMain/                      # Android actual implementations
+│       ├── jvmMain/                          # JVM actual implementations
+│       ├── appleMain/                        # Shared Apple (iOS/macOS/tvOS/watchOS)
+│       ├── iosMain/                          # iOS-specific
+│       └── commonTvWatchMacOsMain/           # tvOS/watchOS/macOS-specific
+├── sentry-kotlin-multiplatform-gradle-plugin/ # Optional Gradle Plugin
+├── sentry-samples/                           # Sample apps (CocoaPods & SPM)
+└── buildSrc/                                 # Build configuration (Config.kt)
+```
+
+## Key Conventions
+
+- **expect/actual pattern**: Shared API in `commonMain`, platform implementations in `androidMain`, `appleMain`, `jvmMain`, etc.
+- **Public API docs**: All public classes/properties in `commonMain` must have KDoc (enforced by detekt)
+- **Formatting**: Spotless with ktlint — run `./gradlew spotlessApply` before committing
+- **Detekt config**: `config/detekt/detekt.yml`
+
+## Commit Attribution
+
+AI commits MUST include:
+```
+Co-Authored-By: (the agent model's name and attribution byline)
+```

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md