Update to Temporal

{
  "description": "Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET, Ruby, and Rust. Use when the user is building workflows, activities, workers, or background job queues with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns. Also use when the user mentions \"run a Temporal workflow from the CLI\", \"start a dev server\", \"run temporal server start-dev\", \"temporal workflow start\", \"temporal workflow execute\", \"temporal workflow signal\", \"temporal workflow query\", \"temporal workflow update\".",
  "included_files": [
    {
      "relative_path": "references/core/ai-patterns.md",
      "size_in_bytes": 5652
    },
    {
      "relative_path": "references/core/cli-workflow-commands.md",
      "size_in_bytes": 11369
    },
    {
      "relative_path": "references/core/determinism.md",
      "size_in_bytes": 4366
    },
    {
      "relative_path": "references/core/dev-management.md",
      "size_in_bytes": 4334
    },
    {
      "relative_path": "references/core/error-reference.md",
      "size_in_bytes": 3190
    },
    {
      "relative_path": "references/core/gotchas.md",
      "size_in_bytes": 9878
    },
    {
      "relative_path": "references/core/install_cli.md",
      "size_in_bytes": 1297
    },
    {
      "relative_path": "references/core/interactive-workflows.md",
      "size_in_bytes": 1380
    },
    {
      "relative_path": "references/core/job-queue.md",
      "size_in_bytes": 13489
    },
    {
      "relative_path": "references/core/patterns.md",
      "size_in_bytes": 16107
    },
    {
      "relative_path": "references/core/priority-fairness.md",
      "size_in_bytes": 7826
    },
    {
      "relative_path": "references/core/random-streams.md",
      "size_in_bytes": 2279
    },
    {
      "relative_path": "references/core/standalone-activities.md",
      "size_in_bytes": 8729
    },
    {
      "relative_path": "references/core/troubleshooting.md",
      "size_in_bytes": 9727
    },
    {
      "relative_path": "references/core/versioning.md",
      "size_in_bytes": 9854
    },
    {
      "relative_path": "references/dotnet/advanced-features.md",
      "size_in_bytes": 6771
    },
    {
      "relative_path": "references/dotnet/data-handling.md",
      "size_in_bytes": 5152
    },
    {
      "relative_path": "references/dotnet/determinism-protection.md",
      "size_in_bytes": 2735
    },
    {
      "relative_path": "references/dotnet/determinism.md",
      "size_in_bytes": 2665
    },
    {
      "relative_path": "references/dotnet/dotnet.md",
      "size_in_bytes": 9661
    },
    {
      "relative_path": "references/dotnet/error-handling.md",
      "size_in_bytes": 4633
    },
    {
      "relative_path": "references/dotnet/gotchas.md",
      "size_in_bytes": 7523
    },
    {
      "relative_path": "references/dotnet/observability.md",
      "size_in_bytes": 4393
    },
    {
      "relative_path": "references/dotnet/patterns.md",
      "size_in_bytes": 14242
    },
    {
      "relative_path": "references/dotnet/priority-fairness.md",
      "size_in_bytes": 1519
    },
    {
      "relative_path": "references/dotnet/standalone-activities.md",
      "size_in_bytes": 5904
    },
    {
      "relative_path": "references/dotnet/testing.md",
      "size_in_bytes": 6433
    },
    {
      "relative_path": "references/dotnet/versioning.md",
      "size_in_bytes": 11786
    },
    {
      "relative_path": "references/go/advanced-features.md",
      "size_in_bytes": 6273
    },
    {
      "relative_path": "references/go/data-handling.md",
      "size_in_bytes": 6951
    },
    {
      "relative_path": "references/go/determinism-protection.md",
      "size_in_bytes": 3390
    },
    {
      "relative_path": "references/go/determinism.md",
      "size_in_bytes": 3118
    },
    {
      "relative_path": "references/go/error-handling.md",
      "size_in_bytes": 5744
    },
    {
      "relative_path": "references/go/external-storage.md",
      "size_in_bytes": 18486
    },
    {
      "relative_path": "references/go/go.md",
      "size_in_bytes": 9441
    },
    {
      "relative_path": "references/go/gotchas.md",
      "size_in_bytes": 7635
    },
    {
      "relative_path": "references/go/observability.md",
      "size_in_bytes": 6409
    },
    {
      "relative_path": "references/go/patterns.md",
      "size_in_bytes": 16081
    },
    {
      "relative_path": "references/go/priority-fairness.md",
      "size_in_bytes": 1710
    },
    {
      "relative_path": "references/go/random-streams.md",
      "size_in_bytes": 2093
    },
    {
      "relative_path": "references/go/standalone-activities.md",
      "size_in_bytes": 6452
    },
    {
      "relative_path": "references/go/testing.md",
      "size_in_bytes": 7183
    },
    {
      "relative_path": "references/go/versioning.md",
      "size_in_bytes": 9958
    },
    {
      "relative_path": "references/integrations.md",
      "size_in_bytes": 6091
    },
    {
      "relative_path": "references/java/advanced-features.md",
      "size_in_bytes": 6693
    },
    {
      "relative_path": "references/java/data-handling.md",
      "size_in_bytes": 7683
    },
    {
      "relative_path": "references/java/determinism-protection.md",
      "size_in_bytes": 3436
    },
    {
      "relative_path": "references/java/determinism.md",
      "size_in_bytes": 3490
    },
    {
      "relative_path": "references/java/error-handling.md",
      "size_in_bytes": 6320
    },
    {
      "relative_path": "references/java/gotchas.md",
      "size_in_bytes": 5607
    },
    {
      "relative_path": "references/java/integrations/spring-ai.md",
      "size_in_bytes": 12985
    },
    {
      "relative_path": "references/java/integrations/spring-boot.md",
      "size_in_bytes": 10236
    },
    {
      "relative_path": "references/java/java.md",
      "size_in_bytes": 11727
    },
    {
      "relative_path": "references/java/observability.md",
      "size_in_bytes": 6025
    },
    {
      "relative_path": "references/java/patterns.md",
      "size_in_bytes": 15096
    },
    {
      "relative_path": "references/java/priority-fairness.md",
      "size_in_bytes": 1762
    },
    {
      "relative_path": "references/java/standalone-activities.md",
      "size_in_bytes": 5255
    },
    {
      "relative_path": "references/java/testing.md",
      "size_in_bytes": 8614
    },
    {
      "relative_path": "references/java/versioning.md",
      "size_in_bytes": 11389
    },
    {
      "relative_path": "references/python/advanced-features.md",
      "size_in_bytes": 7180
    },
    {
      "relative_path": "references/python/ai-patterns.md",
      "size_in_bytes": 10557
    },
    {
      "relative_path": "references/python/data-handling.md",
      "size_in_bytes": 5278
    },
    {
      "relative_path": "references/python/determinism-protection.md",
      "size_in_bytes": 8234
    },
    {
      "relative_path": "references/python/determinism.md",
      "size_in_bytes": 2165
    },
    {
      "relative_path": "references/python/error-handling.md",
      "size_in_bytes": 4175
    },
    {
      "relative_path": "references/python/external-storage.md",
      "size_in_bytes": 15906
    },
    {
      "relative_path": "references/python/gotchas.md",
      "size_in_bytes": 7576
    },
    {
      "relative_path": "references/python/integrations/braintrust.md",
      "size_in_bytes": 7424
    },
    {
      "relative_path": "references/python/integrations/google-adk.md",
      "size_in_bytes": 10317
    },
    {
      "relative_path": "references/python/integrations/langgraph.md",
      "size_in_bytes": 8534
    },
    {
      "relative_path": "references/python/integrations/langsmith.md",
      "size_in_bytes": 9552
    },
    {
      "relative_path": "references/python/integrations/openai-agents-sdk.md",
      "size_in_bytes": 20764
    },
    {
      "relative_path": "references/python/integrations/opentelemetry.md",
      "size_in_bytes": 2764
    },
    {
      "relative_path": "references/python/integrations/pydantic-ai.md",
      "size_in_bytes": 11629
    },
    {
      "relative_path": "references/python/observability.md",
      "size_in_bytes": 4957
    },
    {
      "relative_path": "references/python/patterns.md",
      "size_in_bytes": 12351
    },
    {
      "relative_path": "references/python/priority-fairness.md",
      "size_in_bytes": 1569
    },
    {
      "relative_path": "references/python/python.md",
      "size_in_bytes": 9928
    },
    {
      "relative_path": "references/python/standalone-activities.md",
      "size_in_bytes": 5676
    },
    {
      "relative_path": "references/python/sync-vs-async.md",
      "size_in_bytes": 7227
    },
    {
      "relative_path": "references/python/testing.md",
      "size_in_bytes": 5550
    },
    {
      "relative_path": "references/python/versioning.md",
      "size_in_bytes": 12970
    },
    {
      "relative_path": "references/python/workflow-streams.md",
      "size_in_bytes": 21914
    },
    {
      "relative_path": "references/ruby/advanced-features.md",
      "size_in_bytes": 7984
    },
    {
      "relative_path": "references/ruby/data-handling.md",
      "size_in_bytes": 4042
    },
    {
      "relative_path": "references/ruby/determinism-protection.md",
      "size_in_bytes": 5254
    },
    {
      "relative_path": "references/ruby/determinism.md",
      "size_in_bytes": 2981
    },
    {
      "relative_path": "references/ruby/error-handling.md",
      "size_in_bytes": 2714
    },
    {
      "relative_path": "references/ruby/gotchas.md",
      "size_in_bytes": 7102
    },
    {
      "relative_path": "references/ruby/observability.md",
      "size_in_bytes": 2823
    },
    {
      "relative_path": "references/ruby/patterns.md",
      "size_in_bytes": 10453
    },
    {
      "relative_path": "references/ruby/priority-fairness.md",
      "size_in_bytes": 1362
    },
    {
      "relative_path": "references/ruby/ruby.md",
      "size_in_bytes": 7230
    },
    {
      "relative_path": "references/ruby/standalone-activities.md",
      "size_in_bytes": 6008
    },
    {
      "relative_path": "references/ruby/testing.md",
      "size_in_bytes": 7179
    },
    {
      "relative_path": "references/ruby/versioning.md",
      "size_in_bytes": 9071
    },
    {
      "relative_path": "references/rust/rust.md",
      "size_in_bytes": 8339
    },
    {
      "relative_path": "references/typescript/advanced-features.md",
      "size_in_bytes": 5724
    },
    {
      "relative_path": "references/typescript/data-handling.md",
      "size_in_bytes": 5171
    },
    {
      "relative_path": "references/typescript/determinism-protection.md",
      "size_in_bytes": 2412
    },
    {
      "relative_path": "references/typescript/determinism.md",
      "size_in_bytes": 2158
    },
    {
      "relative_path": "references/typescript/error-handling.md",
      "size_in_bytes": 3390
    },
    {
      "relative_path": "references/typescript/external-storage.md",
      "size_in_bytes": 12494
    },
    {
      "relative_path": "references/typescript/gotchas.md",
      "size_in_bytes": 9332
    },
    {
      "relative_path": "references/typescript/integrations/braintrust.md",
      "size_in_bytes": 3897
    },
    {
      "relative_path": "references/typescript/integrations/mastra.md",
      "size_in_bytes": 7727
    },
    {
      "relative_path": "references/typescript/integrations/opentelemetry.md",
      "size_in_bytes": 3717
    },
    {
      "relative_path": "references/typescript/integrations/vercel-ai-sdk.md",
      "size_in_bytes": 8697
    },
    {
      "relative_path": "references/typescript/observability.md",
      "size_in_bytes": 6188
    },
    {
      "relative_path": "references/typescript/patterns.md",
      "size_in_bytes": 11716
    },
    {
      "relative_path": "references/typescript/priority-fairness.md",
      "size_in_bytes": 1562
    },
    {
      "relative_path": "references/typescript/random-streams.md",
      "size_in_bytes": 2118
    },
    {
      "relative_path": "references/typescript/standalone-activities.md",
      "size_in_bytes": 5688
    },
    {
      "relative_path": "references/typescript/testing.md",
      "size_in_bytes": 6794
    },
    {
      "relative_path": "references/typescript/typescript.md",
      "size_in_bytes": 9185
    },
    {
      "relative_path": "references/typescript/versioning.md",
      "size_in_bytes": 9489
    }
  ],
  "name": "temporal-developer",
  "skill_md_contents": "---\nname: temporal-developer\ndescription: Develop, debug, and manage Temporal applications across Python, TypeScript, Go, Java, .NET, Ruby, and Rust. Use when the user is building workflows, activities, workers, or background job queues with a Temporal SDK, debugging issues like non-determinism errors, stuck workflows, or activity retries, using Temporal CLI, Temporal Server, or Temporal Cloud, or working with durable execution concepts like signals, queries, heartbeats, versioning, continue-as-new, child workflows, or saga patterns. Also use when the user mentions \"run a Temporal workflow from the CLI\", \"start a dev server\", \"run temporal server start-dev\", \"temporal workflow start\", \"temporal workflow execute\", \"temporal workflow signal\", \"temporal workflow query\", \"temporal workflow update\".\n---\n\n# Skill: temporal-developer\n\n## Overview\n\nTemporal is a durable execution platform that makes workflows survive failures automatically. This skill provides guidance for building Temporal applications in Python, TypeScript, Go, Java, .NET, Ruby, and Rust.\n\n## Out of Scope\n\n- **Operational CLI commands** such as batch operations, health queries, Cloud administration, `tcld`, and scripting → use the [temporal-ops skill](https://github.com/temporalio/skill-temporal-ops).\n- **Serverless Worker deployment and troubleshooting** → use the [temporal-serverless skill](https://github.com/temporalio/skill-temporal-serverless).\n- **First-time Temporal Cloud setup** including a Namespace, API key, sample app, and first Workflow → use the [temporal-cloud-setup skill](https://github.com/temporalio/skill-temporal-cloud-setup).\n\nIf a task shifts into one of these areas, follow the relevant skill. Local development and developer-facing Workflow CLI commands remain covered here.\n\n## Core Architecture\n\nThe **Temporal Cluster** is the central orchestration backend. It maintains three key subsystems: the **Event History** (a durable log of all workflow state), **Task Queues** (which route work to the right workers), and a **Visibility** store (for searching and listing workflows). There are three ways to run a Cluster:\n\n- **Temporal CLI dev server** — a local, single-process server started with `temporal server start-dev`. Suitable for development and testing only, not production.\n- **Self-hosted** — you deploy and manage the Temporal server and its dependencies (e.g., database) in your own infrastructure for production use.\n- **Temporal Cloud** — a fully managed production service operated by Temporal. No cluster infrastructure to manage.\n\n**Workers** are long-running processes that you run and manage. They poll Task Queues for work and execute your code. You might run a single Worker process on one machine during development, or run many Worker processes across a large fleet of machines in production. Each Worker hosts two types of code:\n\n- **Workflow Definitions** — durable, deterministic functions that orchestrate work. These must not have side effects.\n- **Activity Implementations** — non-deterministic operations (API calls, file I/O, etc.) that can fail and be retried.\n\nWorkers communicate with the Cluster via a poll/complete loop: they poll a Task Queue for tasks, execute the corresponding Workflow or Activity code, and report results back.\n\n## History Replay: Why Determinism Matters\n\nTemporal achieves durability through **history replay**:\n\n1. **Initial Execution** - Worker runs workflow, generates Commands, stored as Events in history\n2. **Recovery** - On restart/failure, Worker re-executes workflow from beginning\n3. **Matching** - SDK compares generated Commands against stored Events\n4. **Restoration** - Uses stored Activity results instead of re-executing\n\n**If Commands don't match Events = Non-determinism Error = Workflow blocked**\n\nSee [Commands and Events](references/core/determinism.md#commands-and-events) for a table showing how Workflow actions are recorded in Event History.\n\n## Choose References for the Task\n\nIdentify the SDK language and the developer's task. Read the relevant core reference in the section below and its language-specific counterpart when available. Load additional references only as the task requires.\n\nFor a new project, a first implementation, or broad SDK guidance, read the appropriate SDK guide:\n\n- Python -> [Python SDK guide](references/python/python.md)\n- TypeScript -> [TypeScript SDK guide](references/typescript/typescript.md)\n- Go -> [Go SDK guide](references/go/go.md)\n- Java -> [Java SDK guide](references/java/java.md)\n- .NET (C#) -> [.NET SDK guide](references/dotnet/dotnet.md)\n- Ruby -> [Ruby SDK guide](references/ruby/ruby.md)\n- Rust -> [Rust SDK guide](references/rust/rust.md) (in Public Preview)\n\nFor tasks that use Temporal CLI or start a local dev server, check whether `temporal` is installed before using it. If it is missing, follow the [Temporal CLI installation guide](references/core/install_cli.md).\n\n## Primary References\n\n- **[Temporal determinism rules](references/core/determinism.md)** - Why determinism matters, replay mechanics, basic concepts of activities\n  - Language-specific info at `references/{your_language}/determinism.md`\n- **Temporal workflow determinism protection** - SDK safeguards, analyzers, runtime checks, and their limits\n  - Language-specific info at `references/{your_language}/determinism-protection.md`\n- **[Temporal workflow patterns](references/core/patterns.md)** - Conceptual patterns (signals, queries, saga)\n  - Language-specific info at `references/{your_language}/patterns.md`\n- **[Temporal common pitfalls](references/core/gotchas.md)** - Anti-patterns and common mistakes\n  - Language-specific info at `references/{your_language}/gotchas.md`\n- **[Temporal versioning guide](references/core/versioning.md)** - Versioning strategies and concepts - how to safely change workflow code while workflows are running\n  - Language-specific info at `references/{your_language}/versioning.md`\n- **[Temporal standalone Activities guide](references/core/standalone-activities.md)** - Standalone Activities: run an Activity directly from a Client without a Workflow — Temporal's job queue\n  - Language-specific info at `references/{your_language}/standalone-activities.md`\n- **[Temporal Task Queue priority and fairness guide](references/core/priority-fairness.md)** - Task Queue Priority and Fairness concepts, configuration, and limitations\n  - Language-specific info at `references/{your_language}/priority-fairness.md`\n- **[Temporal Workflow random streams guide](references/core/random-streams.md)** - SDK-provided named deterministic random streams for Workflow code, plugins, and interceptors\n  - Language-specific info at `references/{your_language}/random-streams.md` (Go and TypeScript)\n- **[Temporal troubleshooting guide](references/core/troubleshooting.md)** - Decision trees, recovery procedures\n- **[Temporal error reference](references/core/error-reference.md)** - Common error types, workflow status reference\n- **[Temporal interactive workflow guide](references/core/interactive-workflows.md)** - Testing signals, updates, queries\n- **[Temporal development management guide](references/core/dev-management.md)** - Dev cycle & management of server and workers\n- **[Temporal CLI workflow command guide](references/core/cli-workflow-commands.md)** - Developer-facing CLI commands for workflow interaction (start, execute, signal, query, update, cancel)\n- **[Temporal AI integration patterns](references/core/ai-patterns.md)** - AI/LLM pattern concepts\n  - Language-specific info at `references/{your_language}/ai-patterns.md`, if available. Currently Python only.\n\n## Job Queues and Background Jobs\n\n**Temporal's job queue is Standalone Activities.** When the developer asks for a job queue, background or async jobs, a work queue, or whether Temporal can replace Celery, Sidekiq, BullMQ, Resque, Hangfire, or SQS-plus-workers, build it with a Standalone Activity — not a Workflow wrapping a single Activity, and not a dispatcher Workflow that receives jobs by Signal.\n\nTemporal **Task Queues** are the routing mechanism Workers poll, not a queue that producers push jobs into. Do not answer a job queue question by describing Temporal Task Queues.\n\nWhen a developer says \"task queue\" they may mean \"job queue\": Celery, Dramatiq, Huey, and Asynq all use Task nomenclature, while Sidekiq, Hangfire, BullMQ, Resque, RQ, and Faktory use Job. Read \"can I use Temporal as a task queue?\" as a job queue question, and reserve Temporal's Task Queue meaning for your own reply.\n\n- **[Temporal job queue guide](references/core/job-queue.md)** - Job-queue vocabulary mapped to Temporal, migrating off an existing job queue, anti-patterns, and per-language SDK guides and runnable samples\n\n## Additional Topics\n\n- **`references/{your_language}/observability.md`** - See for language-specific implementation guidance on observability in Temporal\n- **`references/{your_language}/advanced-features.md`** - See for language-specific guidance on advanced Temporal features and language-specific features\n\n## Third-Party Integrations\n\nFor Temporal plugins and integrations with third-party frameworks and SDKs (Spring Boot, Spring AI, OpenAI Agents SDK, Google ADK, etc.), see **[integrations catalog](references/integrations.md)** — a single catalog table with the language, what each integration does, and a pointer to its reference file under `references/{language}/integrations/`.\n\n## Feedback\n\n### Reporting Issues in This Skill\n\nIf you (the AI) find this skill's explanations are unclear, misleading, or missing important information—or if Temporal concepts are proving unexpectedly difficult to work with—draft a GitHub issue body describing the problem encountered and what would have helped, then ask the user to file it at https://github.com/temporalio/skill-temporal-developer/issues/new. Do not file the issue autonomously.\n"
}