Try it free

Run an AI upgrade skill session

  • Latest Dynatrace
  • How-to guide
  • 2-min read
  • Published Nov 15, 2026

When you use the upgrade skill with a coding agent, for example, Claude Code, the upgrade skill guides you through the migration one step at a time. An upgrade session is a conversation with the upgrade skill in your development environment. It's not a Claude Code session but a back-and-forth exchange in which the skill asks questions, checks with you at key points, and gathers evidence of progress. Understanding how upgrade sessions work helps you get better results and know when to move forward or ask for help.

Prerequisites

  • A coding agent, such as Claude Code.
  • dtctl installed and configured for your environment.
  • The upgrade skill available to your AI agent.

Understand the upgrade session workflow

In every upgrade session, the upgrade skill works step-by-step and checks with you before moving on:

  1. Request classification: The upgrade skill first classifies your request as a question, a single task, or a full program, and tells you which one it chose so you can override it.
  2. Clarifying questions: The upgrade skill asks clarifying questions one at a time and prefers multiple answers.
  3. Checkpoints between tasks: The upgrade skill stops at a checkpoint between tasks and waits for you.
  4. Evidence-based verification: The upgrade skill reruns readiness checks as evidence instead of only stating that a task is complete.
  5. Deletion assessment: One of the skill's first questions is whether you still need a Dynatrace Classic object at all. A large share of Dynatrace Classic configuration is no longer used and should be deleted rather than migrated, which saves you from upgrade work.

Know when the upgrade stops

The upgrade skill doesn't keep trying indefinitely. It stops and hands control back to you in these cases:

  • After three failed attempts at a problem, the upgrade skill stops and escalates instead of trying again.
  • A missing permission or credential is a blocker, not something to retry. The upgrade skill names the missing scope and hands control back to you.

To find out more about what happens when the assistant gives control back to you, see Upgrade to Latest Dynatrace with AI FAQ.

Next steps

  • Learn more about what the upgrade skill produces: What the upgrade skill produces
  • Understand limitations and how to review the output: Limitations and what to check
  • Follow best practices for reliable results: Best practices
Related tags
Dynatrace Platform