basecamp/sdk

Última atividade de origem registrada: 10 de setembro de 2026 às 23:18

Catálogo do SkillsMP atualizado: 2 de novembro de 2026 às 18:02

skills coletadas: 1

Estrelas no GitHub: 5
Forks no GitHub: 0

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/basecamp/sdk.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# 37signals SDKs Official API clients for Basecamp, HEY, and Fizzy. Generated from [Smithy](https://smithy.io/) specifications with consistent authentication, retry, pagination, and error handling. Basecamp ships today in six languages; HEY and Fizzy SDKs are planned. These libraries power our [CLIs](https://github.com/basecamp/cli) and agent skills. | SDK | What it does | Repo | Status | |-----|-------------|------|--------| | Basecamp | Projects, to-dos, messages, schedules, campfires, card tables, and more | [basecamp/basecamp-sdk](https://github.com/basecamp/basecamp-sdk) | Available | | HEY | Email triage, contacts, screening, and search | [basecamp/hey-sdk](https://github.com/basecamp/hey-sdk) | Available | | Fizzy | Boards, cards, columns, and workflows | [basecamp/fizzy-sdk](https://github.com/basecamp/fizzy-sdk) | Available | ## Languages | Language | Package format | Basecamp | HEY | Fizzy | |----------|---------------|:--------:|:---:|:-----:| | Go | Go module | ✓ | ✓ | ✓ | | TypeScript | npm | ✓ | | ✓ | | Ruby | gem | ✓ | | ✓ | | Swift | SPM | ✓ | | ✓ | | Kotlin | GitHub Packages | ✓ | | ✓ | | Rust | crates.io | ✓ | | | ## Related tools **CLIs** — [basecamp/cli](https://github.com/basecamp/cli) ships `basecamp`, `hey`, and `fizzy` command-line tools built on these SDKs. Structured JSON output, shell completion, and full API coverage. **Agent skills** — Each CLI embeds Claude Code skills for AI-agent integration. The SDKs themselves are the runtime layer those skills call into. --- This repo is the shared infrastructure that all SDK repositories consume via subtree. Everything language-agnostic or cross-language lives here; individual SDK repos pull it in as `common/`. ## Directory structure ``` actions/ conformance-run/ Run cross-language conformance tests in CI rubric-check/ Static rubric criteria verification release-orchestrate/ Poll per-language release workflows, create GitHub Release smithy-verify/ Validate Smithy spec and OpenAPI freshness service-drift/ Detect drift between generated services and spec conformance/ schema.json JSON schema for conformance test definitions tests/ Test case files (auth, retry, pagination, error-mapping, etc.) runner/ Per-language runners (go, typescript, ruby, swift, kotlin); a Rust runner is ported per repo (see seed-sdk.md) prompts/ seed-sdk.md Bootstrap a new SDK repository from templates close-gap.md Close one specific rubric criterion gap seed/ Template files for new SDK repos (.tmpl extension) spec/ Smithy model templates go/ ts/ ruby/ Per-language scaffolding (rust/ is a buildable crate; swift/ kotlin/ rust/ the others are fragments) scripts/ .github/ Makefile.tmpl, AGENTS.md.tmpl, README.md.tmpl, etc. skills/ rubric-audit/ Score an SDK repo against the rubric, produce scorecard + artifact smithy-bare-arrays/ Smithy plugin for bare array (non-wrapped) responses ``` ## Consuming sdk/common Add as a git subtree in an SDK repo: ```bash git subtree add --prefix common https://github.com/basecamp/sdk.git main --squash ``` Update later: ```bash git subtree pull --prefix common https://github.com/basecamp/sdk.git main --squash ``` Actions are referenced from CI workflows. Conformance tests and runners live under `common/conformance/` in the consuming repo. Conformance runners reference the SDK via relative paths (e.g., `../../../typescript`, `../../../kotlin`) and are designed to build within a consuming repo, not standalone. ## Bootstrapping a new SDK repo Use the [seed-sdk prompt](prompts/seed-sdk.md) to walk through the full bootstrap process: 1. Copy `seed/*` into the new repo 2. Replace template placeholders (`{{.AppName}}`, `{{.AppTitle}}`, etc.) 3. Rename `.tmpl` files to their final names 4. Initialize Smithy spec, language toolchains, and conformance runners 5. Run `make check` to verify clean state ## Quality criteria All SDK repos are scored against [RUBRIC.md](RUBRIC.md) (91 criteria for full SDK, 76 for single-language). The rubric covers: - **Tier 1** -- API fidelity (spec conformance, type fidelity, path correctness) - **Tier 2** -- Behavioral contracts (errors, retry, pagination, resilience) - **Tier 3** -- Developer experience (auth, observability, security) - **Tier 4** -- Infrastructure (generation pipeline, testing, release, DX) See also [MAKEFILE-CONVENTION.md](MAKEFILE-CONVENTION.md) for required Makefile targets and release architecture.

Carregando o README do repositório…

Skills neste repositório

Analistas de garantia de qualidade de software e testadores

1 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado

rubric-audit

Analistas de garantia de qualidade de software e testadores

Score an SDK repo against the rubric, producing a scorecard and rubric-audit.json artifact

Idioma do texto original: inglês

2026-09-10

Mostrando 1 de 1 skills coletadas.