Spec Layout

April 28, 2026 · View on GitHub

This directory contains the canonical Basecamp spec used for SDK generation. We start with a minimal Smithy model and layer overlays for behavior and ergonomics.

Files

  • basecamp.smithy — canonical model (types + operations)
  • overlays/ — semantic overlays (pagination, retries, idempotency)
  • api-provenance.json — upstream revision tracking (basecamp/bc3 SHA)

Grounding

  • API reference: basecamp/bc3 → doc/api/
  • App code: basecamp/bc3 → app/controllers/

Conventions

  • Keep shapes minimal and accurate; prefer additive updates over churn.
  • Behavior lives in overlays, not in operation docs.
  • OpenAPI is derived output only.