Skip to content

COM-293: Fix skill issues found during manual review - #6

Merged
tomba7 merged 2 commits into
mainfrom
serverless-skill-provider-scope-and-cli
Aug 17, 2026
Merged

COM-293: Fix skill issues found during manual review#6
tomba7 merged 2 commits into
mainfrom
serverless-skill-provider-scope-and-cli

Conversation

@tomba7

@tomba7 tomba7 commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Changes

Provider scope

  • SKILL.md gains a Supported compute providers table — provider, compute service, support status, reference directory — replacing release-status prose spread across four files. Provider support is now answerable without reading paragraphs
  • Only a provider marked Supported is covered; a request naming another stops rather than being served adapted Lambda material
  • Workflow steps and the routing table use references/<provider>/... with the directory layout stated once, so the file stays provider-neutral as providers are added
  • GCP survives in exactly two places, both load-bearing: the support table, and the gcp- region prefix used to classify ineligible Namespaces in step 1
  • Skill description no longer names Cloud Run

Control-plane CLI

  • temporal cloud ... is still pre-release, so tcld is the supported path for control-plane work today — accounts, Namespaces, API keys, users, service accounts. The comparison table presenting the two as alternatives is gone
  • Worker Deployments and Workflows are not control-plane operations: they live on the Namespace frontend, have no tcld equivalent, and keep using temporal worker deployment ...
  • Namespace and API-key commands rewritten to tcld, including teardown. Confirmation flag corrected to --auto_confirm (underscore) — the temporal cloud spelling exits clean having deleted nothing
  • Adds the two agent-shell mechanics: tcld login --disable-pop-up prints the URL instead of relying on auto-open, and mutating operations need --auto_confirm or AUTO_CONFIRM=true
  • To revisit once temporal cloud ... reaches GA

Namespace and provider pairing

  • Generalized from "a GCP Namespace can't run Lambda" to the rule: a Serverless Worker runs only on the cloud provider hosting its Namespace, and there is no cross-cloud pairing
  • Step 1's Namespace pick now settles the provider answer, so a mismatch is caught there rather than at connection time several steps later

Browser fallback

  • Where the Temporal CLIs cannot authenticate, "fix the CLI" and "work in the browser" are presented as equals rather than a preference and a fallback. Every control-plane and frontend step exists in the Cloud UI, and setup.md now names which steps belong to which plane
  • "None" in the access matrix means no authenticated CLI, not no access — the user still has the Cloud UI and their provider's console. Both middle rows rewritten to walk the user through the UI, not just generate commands to hand off

Environment-specific content removed

  • A real test-account Namespace was used as the "names are long and error-prone" example. Replaced with the shape, <name>-<suffix>.<account>

Run transparency

  • The checklist is reprinted in full at every step boundary, marked ✅/⏳/⬜, rather than narrated as "stage complete." A narration says where you are but not what remains, and the user cannot see it without scrolling back
  • Commands are announced in message text above the block — the user sees a collapsed "Ran 6 shell commands," and the tool's own description field renders underneath the command it describes
  • Step 8 delivers the inventory before offering teardown, and does not write a teardown script until asked. Generating it unprompted buries the inventory the user needs in order to decide

Skill version 0.5.00.6.0.

Testing

Manually verified — driven end-to-end against Temporal Cloud on with a Go Worker on Lambda arm64 and a Namespace on AWS us-west-2, after these changes:

🤖 Generated with Claude Code

Provider scope. GCP Cloud Run was described as Pre-release and gated,
which reads as "attempt it and see." Replace the scattered prose with a
Supported compute providers table (provider, compute service, support,
reference directory) and a rule that only a Supported provider is
covered. Workflow steps and the routing table now use
references/<provider>/... so the file stays provider-neutral.

Control-plane CLI. Guidance mixed tcld and the unified CLI's
`temporal cloud ...` subcommands, presenting them as interchangeable in
a comparison table. They are not. `temporal cloud ...` is still
pre-release, so tcld is the supported path for control-plane work
today. The two also diverge in ways that fail quietly: the confirmation
flags differ (--auto-confirm vs --auto_confirm), and
TEMPORAL_CLOUD_API_KEY and TEMPORAL_API_KEY authenticate different
planes. Standardize on tcld and reserve `temporal worker deployment
...` for the Namespace frontend, which has no tcld equivalent. Revisit
and move the skill to `temporal cloud ...` once it is generally
available.

Namespace/provider pairing. Generalize from "a GCP Namespace can't run
Lambda" to the rule itself: a Serverless Worker runs only on the cloud
provider hosting its Namespace, and regions need not match. Step 1's
Namespace pick now settles the provider answer, catching a mismatch
there rather than at connection time several steps later.

Browser fallback. Where the Temporal CLIs cannot authenticate, offer
fixing the CLI and working in the Cloud UI as equals rather than as a
preference and a fallback; every step exists in the UI. Clarify that
"None" in the access matrix means no authenticated CLI, not no access.
Restore the unauthenticated-vs-unauthorized classification so a stale
credential is not mistaken for a permissions wall.

Environment-specific content. Drop a real test-account Namespace used
as an example, and the IdP-initiated corporate SSO diagnosis, which
generalized one org's root cause into a universal claim. The rule it
justified — stop, do not retry, do not install another CLI — survives
on its own.

Also in this pass: reprint the run checklist at every step boundary
rather than narrating progress; announce what a command will do above
the command block, since the user sees a collapsed "Ran N shell
commands"; deliver the inventory before offering teardown, and do not
write a teardown script unasked. Version 0.5.0 -> 0.6.0.

Refs: https://temporalio.atlassian.net/browse/COM-293

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@tomba7
tomba7 requested a review from starfleeth August 14, 2026 22:59
Comment thread references/aws-lambda/setup.md Outdated
Comment thread SKILL.md Outdated
Comment thread SKILL.md
@tomba7
tomba7 requested a review from starfleeth August 15, 2026 06:13

@starfleeth starfleeth left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@tomba7
tomba7 merged commit 3f8114f into main Aug 17, 2026
2 checks passed
@tomba7
tomba7 deleted the serverless-skill-provider-scope-and-cli branch August 18, 2026 01:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants