메뉴
Use when adding a new cloud provider adapter, or extending an existing one with a new service, in internal/provider/<name>/. Covers the Store interface, SDK confinement, error mapping, version-spec parsing, CLI/registry wiring, and staging support.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
| name | add-provider-adapter |
| description | Use when adding a new cloud provider adapter, or extending an existing one with a new service, in internal/provider/<name>/. Covers the Store interface, SDK confinement, error mapping, version-spec parsing, CLI/registry wiring, and staging support. |
A provider adapter implements the neutral seam in internal/provider so the rest
of suve never sees a cloud SDK. Google Cloud (PR #231), Azure Key Vault + App
Configuration (PR #239), and the AWS re-implementation (PR #224) all follow the
same shape.
provider.Store — the composition of Reader, Writer, and
Tagger (internal/provider/provider.go) — over a narrow in-package client
wrapper. Keep the cloud SDK confined to internal/provider/<name>/**.Wrap() adapter so the seam
returns neutral domain types, never SDK types.internal/provider/errors.go:
provider.ErrNotFound and provider.ErrAlreadyExists. Missed error mappings
are a recurring defect source (#318, #481) — enumerate every not-found and
already-exists SDK error shape and cover it in unit tests.internal/version/<name>version (see the existing
gcloudversion, azurekvversion, azureappconfigversion). It resolves
#VERSION / ~SHIFT / :LABEL per the provider's capabilities and cleanly
rejects unsupported specifiers before any API call. Google Cloud rejects
labels with a dedicated error at parse time (ErrLabelUnsupported, #231);
App Configuration is unversioned and rejects all specifiers.Factory (internal/provider/registry.go) that returns
provider.ErrUnsupportedKind for services the provider does not offer.internal/cli/commands/app.go.internal/architecture_test.go and the depguard block in
.golangci.yaml to gate the new SDK module so it can only be imported from
the provider directory. Confinement is enforced across all of internal/
(#488, #502) — keep that breadth.Staging is a distinct increment on top of read/write (#247 → #261, #262):
ScopeResolver.GlobalConfig (#261).mise test + mise lint are green.Use when restructuring the README or the GitHub Pages site generated from it — the left-nav/left-pane, section reorg, or per-provider command docs. Covers the build-docs-site.py split + literate-nav SUMMARY pipeline, its HTML-comment directives and site-only transforms (nav-group, site:skip, hero <h1>, asset ../ prefix, DOC_NAV grouping), the python-markdown gotchas GitHub hides, and the `mise docs-build` strict gate.
Use when authoring or backfilling the "## Highlights" section of a GitHub release — the human-written summary that prepends the auto-generated notes. Covers when a release earns highlights, the fixed format (bold lead + breaking-change note, `###` subsections, PR-referenced bullets), and the prepend-in-place mechanics.
Use when re-recording the CLI, TUI, or GUI demo GIFs after a UI change or a user-visible output change. Covers the record scripts, robust Playwright selectors, output-drift triggers, frame verification, and Git LFS.
Load when writing or reviewing Go that builds or transforms slices/maps. Prefer samber/lo, samber/lo/it, and stdlib slices/maps callback & iterator utilities over hand-rolled make + range + append; keep an explicit loop only where side effects or control flow are genuinely complex.
Load when you need the per-provider capability, versioning, and alias matrix for suve's CLI without reading the full docs/{aws,azure,gcloud}.md option tables. A one-page orientation; link out for per-command detail.
Load when adding or modifying a provider adapter, or when touching internal/provider/** or internal/domain/**. Captures the invariants that keep the provider-neutral seam honest: the neutral domain model, opaque version refs, the typed write/delete option pattern, interface segregation, and SDK confinement.