Braintrust Spec

Cross language specs for implementing a Braintrust SDK.

Contains:

• skills/instrumentation-spec/ — installable Braintrust instrumentation skill
  • skills/instrumentation-spec/references/ — markdown specs and guidance
  • skills/instrumentation-spec/references/features/ — feature-specific specs, designs, and API contracts
• test/ — yaml end-to-end test cases and assertions
• semconv/ — yaml cross-language constants such as envars and span attributes
• capabilities/ — SDK compatibility catalog configuration and generated CSV

Consume the instrumentation skill

From a repository initialized with dotagents, run:

npx @sentry/dotagents add braintrustdata/braintrust-spec instrumentation-spec

This adds the following dependency to agents.toml:

[[skills]]
name = "instrumentation-spec"
source = "braintrustdata/braintrust-spec"

Development

Install mise, then run:

mise trust
mise install
mise run install-deps
make test

mise manages the pinned Python and a project-local .venv; requirements.txt pins the YAML parser. Make targets install dependencies automatically. See the compatibility catalog guide for the SDK support YAML format, generated views, and automated assessments.