oxidecomputer

API docstring style guide for public endpoint handlers and external API types. Use when writing or reviewing doc comments in nexus/external-api or nexus/types/src/external_api.

Generate CockroachDB SQL and migrations for schema changes. Use when creating migrations, updating the database schema, or when the user mentions migrations, schema changes, or dbinit.sql.

Review code for patterns known to cause flaky tests. Use when the user asks to review tests or a change for flakiness, or when reviewing a diff that adds or modifies tests.

Add a new Nexus background task. Use when the user wants to create a periodic background task in Nexus that runs on a timer.

Add a new version to a Dropshot HTTP API. Use when the user wants to make versioned changes to a Dropshot-managed HTTP API, such as adding, making changes to, or removing an API endpoint.

Onboard a new tokio or Rust toolchain release into the version matrix — matrix.sh mechanics, classifying the divergence, adding a Family when one is needed, and the golden-blessing gates. Use when matrix.sh update reports the matrix is behind, when asked to…

Add or fix a reify type formatter — pick the DisplayNode shape, write the exegesis detector, add golden coverage, and debug a detector that does not fire. Use when teaching hansei to render a new known type (a tokio primitive, a std/crate container, a…

Profile and optimize hansei's render/startup path — the A/B measurement bar a perf change must clear, the profiler traps, and the size-vs-speed policy for bundle changes. Use when investigating hansei performance, proposing a perf optimization, or judging…

Debug flaky Playwright E2E test failures from CI

Audit and improve help text, microcopy, and "Relevant docs" links across console networking and other UI pages. Use when adding or updating documentation links in side modals, page headers (DocsPopover), or inline help text.

Sources Terraform schema descriptions from the pinned oxide.go SDK's Go doc comments, which already mirror the OpenAPI spec. Adapts the text to the TF surface (translating reshaped attribute names, clarifying NameOrId inputs, trimming API-internal paragraphs,…

Renames a Terraform attribute safely without changing its schema or producing an unnecessary diff, while enabling users to use both the previous and subsequent attribute names for a deprecation period.

Activate narration mode for this session. Use when the user asks you to start listening, attend, or enable voice narration.

Stop narration mode for this session

Write, review, or organize documentation following the Diátaxis framework. Use when writing docs, reviewing docs, creating tutorials, how-to guides, reference material, or explanatory content.

Generates a plan to coordinate a dependency upgrade across multiple Oxide repos with cyclic dependencies. Triggered when upgrading a shared dependency (like progenitor, reqwest, dropshot) that must be synchronized across omicron, crucible, propolis, dendrite,…

Bump @oxide/api to a new omicron release tag locally, then (after the user pushes, merges, and CI publishes) hand off the npm dist-tag command.