--- title: "Setting Up a New SDK Repository" url: https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo/ --- # Setting Up a New SDK Repository This document uses key words such as "MUST", "SHOULD", and "MAY" as defined in [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt) to indicate requirement levels. Statuscandidate Version`1.0.0`[(changelog)](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#changelog) ## [Overview](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#overview) This playbook guides SDK maintainers through setting up a new SDK repository from scratch. It covers repository scaffolding, required documentation files, CI pipeline configuration, and verification steps to ensure AI tools can effectively contribute. By following these steps, the repository will have proper branch protection, documentation, testing infrastructure, and release automation in place. Related resources: * [Repository Documentation Standards](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md) — required files and AI context * [Review and CI Standards](https://develop.sentry.dev/sdk/getting-started/standards/review-ci.md) — CI checks and review requirements * [Sentry Skills](https://github.com/getsentry/skills#available-skills) — automation tools for commits, PRs, and AGENTS.md *** ## [Steps](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#steps) #### [1. Repository scaffolding](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#1-repository-scaffolding) Create the repository in the `getsentry` organization. You **MUST** configure branch protection rules: * Require CI checks to pass ([Required CI checks baseline](https://develop.sentry.dev/sdk/getting-started/standards/review-ci.md#required-ci-checks)) * Require at least one approving review ([Required reviewers](https://develop.sentry.dev/sdk/getting-started/standards/review-ci.md#code-review)) You **MUST** set up a `CODEOWNERS` file with team members to automatically request reviews. #### [2. Required files](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#2-required-files) You **MUST** create the following files: * `AGENTS.md` ([AGENTS.md](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files)) — Use the [AGENTS.md template](https://develop.sentry.dev/sdk/getting-started/templates/agents-md-template.md). You **SHOULD** use the [`sentry-skills:agents-md`](https://github.com/getsentry/skills#available-skills) skill to generate initial content. * `CONTRIBUTING.md` ([CONTRIBUTING.md](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files)) — Use the [CONTRIBUTING.md template](https://develop.sentry.dev/sdk/getting-started/templates/contributing-md-template.md), customized for this SDK. * `.github/PULL_REQUEST_TEMPLATE.md` ([PR template](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files)) — Use the [PR template](https://develop.sentry.dev/sdk/getting-started/templates/pr-template.md). * `CHANGELOG.md` or equivalent * `LICENSE` file #### [3. CI pipeline](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#3-ci-pipeline) Set up CI with at minimum: You **MUST** configure: * Build verification * Linting ([Linting and formatting in CI](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#linting-and-type-checking)) * Type checking, if applicable for the language ([Type checking in CI](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#linting-and-type-checking)) * Test suite * Commit message format check ([Commit message format](https://develop.sentry.dev/sdk/getting-started/standards/code-submission.md#commit-message-format)) * Secret scanning ([Security practices](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#security-practices)) #### [4. AI context files](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#4-ai-context-files) You **MUST** create AI context files ([AI context file maintenance](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#ai-context)): * `AGENTS.md` — required You **SHOULD** create: * `CLAUDE.md` * `.cursorrules` * `.github/copilot-instructions.md` #### [5. Release setup](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#5-release-setup) You **MUST** configure release automation: * Craft configuration (`.craft.yml`) * Version bump script (e.g., `scripts/bump-version.sh`) * Release workflow (e.g., `.github/workflows/release.yml`) #### [6. Rollback documentation](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#6-rollback-documentation) You **MUST** document rollback procedures ([Rollback procedures](https://develop.sentry.dev/sdk/getting-started/standards/coordination-maintenance.md#releases)): * Who can publish and yank releases (at least two people) * How to yank a release from the package registry * Backup contact if the primary publisher is unavailable #### [7. Verify with an AI tool](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#7-verify-with-an-ai-tool) Clone the repository fresh. Point an AI coding tool at it with no additional context. Ask it to make a sample contribution. You **MUST** verify that: * `AGENTS.md` gives the tool enough context to understand the architecture * The tool can figure out how to run tests * The tool creates a properly formatted commit * The tool opens a draft PR with a meaningful description If the tool cannot do this, the documentation needs work. ## [Referenced Standards](https://develop.sentry.dev/sdk/getting-started/playbooks/setup/setting-up-new-sdk-repo.md#referenced-standards) * [AGENTS.md](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files) — AI context file requirements * [CONTRIBUTING.md](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files) — contributor guidelines * [PR template](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#repo-files) — pull request template structure * [AI context file maintenance](https://develop.sentry.dev/sdk/getting-started/standards/repository-docs.md#ai-context) — maintaining AI-readable documentation * [Required reviewers](https://develop.sentry.dev/sdk/getting-started/standards/review-ci.md#code-review) — review approval requirements * [Required CI checks baseline](https://develop.sentry.dev/sdk/getting-started/standards/review-ci.md#required-ci-checks) — minimum CI pipeline requirements * [Commit message format](https://develop.sentry.dev/sdk/getting-started/standards/code-submission.md#commit-message-format) — conventional commit format * [Linting and formatting in CI](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#linting-and-type-checking) — automated code style checks * [Type checking in CI](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#linting-and-type-checking) — static type verification * [Security practices](https://develop.sentry.dev/sdk/getting-started/standards/code-quality.md#security-practices) — secret scanning and security checks * [Rollback procedures](https://develop.sentry.dev/sdk/getting-started/standards/coordination-maintenance.md#releases) — release rollback documentation *** | Version | Date | Summary | | ------- | ---------- | ----------------------------------------------------------------------------------------------------- | | `1.0.0` | 2026-02-21 | Initial playbook — standardized SDK repository setup with required files, CI pipeline, and AI context |