User-facing documentation is organized along Diátaxis: learning-oriented tutorials, task-oriented how-to guides, information-oriented reference, and understanding-oriented explanation.
Start here if you are new to the SDK.
- Your first Slack bot — zero to a running Slack bot in under 30 minutes.
Task-oriented guides for people already running a bot.
- Choose a state backend — memory, Redis, Postgres, or NATS JetStream.
- Defer long-running work (ack-then-work) — acknowledge webhooks fast and run handlers on a detached context.
- Handle slash commands — route Slack slash
commands through
OnCommand. - Handle interactive components — buttons, menus, Block Kit content, and modals.
- Install into multiple workspaces (multi-tenant) —
resolve per-tenant credentials with an
InstallStore. - Run Linear agent sessions — build a Linear agent with thoughts, responses, actions, elicitations, and plans.
- API and package reference — pkg.go.dev pointers, module layout, and per-adapter capability status.
- Linear agent capability gaps — tracked list of Linear agent APIs the adapter does not yet wrap.
- Architecture and design decisions — an index over
CONTEXT.md(the ubiquitous language and architecture document) and the ADRs that record every significant decision.
docs/agents/— instructions for coding agents working on this repository, not for SDK users.