name	add-a-provider
description	Use when adding or changing a build, storage, credentials, submit, or compute backend in launch-store — implement one of the five provider interfaces and register it, without touching the pipeline.

Add a provider backend

Pick one of the five interfaces in src/core/types/index.ts: BuildEngine / StorageProvider / CredentialsProvider / Submitter / ComputeHost.
Implement it as a named object in src/providers/<kind>/<name>.ts, setting name to the value users put in launch.config.ts.
Register it in src/providers/index.ts (registerBuiltins()), which wires into src/core/services/registry.ts. The pipeline resolves a provider by its name, so you never edit src/core/build/pipeline.ts to add one.
Lazy-load any heavy or optional SDK through requireOptional in src/core/services/optionalDep.ts, so a missing package becomes an actionable install hint instead of a stack trace.
Add a *.test.ts beside the provider, then run the gate (see the run-the-gate skill).

Adding a backend never edits the pipeline — that is the whole point of the registry: implement the interface, register the name, done.

See AGENTS.md → “Adding a backend = implement an interface + register it” for the worked S3 example.

All child processes go through src/core/services/exec.ts (run / capture, shell: false, explicit argv) — never build a shell string or call spawn / exec directly.
Secrets stay in the OS keychain; ~/.launch holds non-secret paths and ids only. Don't log, write, or commit key material.

name	add-a-provider
description	Use when adding or changing a build, storage, credentials, submit, or compute backend in launch-store — implement one of the five provider interfaces and register it, without touching the pipeline.

Pick one of the five interfaces in src/core/types/index.ts: BuildEngine / StorageProvider / CredentialsProvider / Submitter / ComputeHost.
Implement it as a named object in src/providers/<kind>/<name>.ts, setting name to the value users put in launch.config.ts.
Register it in src/providers/index.ts (registerBuiltins()), which wires into src/core/services/registry.ts. The pipeline resolves a provider by its name, so you never edit src/core/build/pipeline.ts to add one.
Lazy-load any heavy or optional SDK through requireOptional in src/core/services/optionalDep.ts, so a missing package becomes an actionable install hint instead of a stack trace.
Add a *.test.ts beside the provider, then run the gate (see the run-the-gate skill).

Adding a backend never edits the pipeline — that is the whole point of the registry: implement the interface, register the name, done.

See AGENTS.md → “Adding a backend = implement an interface + register it” for the worked S3 example.

All child processes go through src/core/services/exec.ts (run / capture, shell: false, explicit argv) — never build a shell string or call spawn / exec directly.
Secrets stay in the OS keychain; ~/.launch holds non-secret paths and ids only. Don't log, write, or commit key material.

add-a-provider