Recommend gh aw upgrade command in upgrade instructions

[Copilot]

The upgrade instructions directed agents through manual steps (fix, compile, init) without mentioning the unified gh aw upgrade command that automates the entire process.

Changes

Added primary upgrade path (Section 2)

• Explicit recommendation to use gh aw upgrade with code example
• Documents what the command does automatically (updates agents/prompts, applies codemods, updates actions, compiles workflows)
• Lists optional flags: --push, --no-fix, --no-actions, --dir

Restructured manual steps as fallback (Section 3)

• Demoted previous sections 2-3 to subsections 3.1-3.2
• Labeled "Manual Upgrade Steps (Fallback)" for when fine-grained control needed

Updated output templates

• PR description template now reflects using gh aw upgrade
• Changed "Automatic Fixes Applied (via codemods)" → "Automatic Fixes Applied"
• Added "Upgrade Method" section documenting command usage

Files changed

• .github/aw/upgrade-agentic-workflows.md (active)
• pkg/cli/templates/upgrade-agentic-workflows.md (template)

Example

Before:

### 2. Apply Automatic Fixes with Codemods
Use the `fix` tool with the `--write` flag...

### 3. Attempt Recompilation
Use the `compile` tool to compile all workflows...

After:

### 2. Run the Upgrade Command

**The primary and recommended way to upgrade is to use the `gh aw upgrade` command**

```bash
gh aw upgrade

Tip

Use gh aw upgrade for most upgrade scenarios.

3. Manual Upgrade Steps (Fallback)

If the gh aw upgrade command is not available...

<!-- START COPILOT CODING AGENT SUFFIX -->



<!-- START COPILOT ORIGINAL PROMPT -->



<details>

<summary>Original prompt</summary>

> Make sure the "upgrade-agentic-workflows.md" explicitely tells the agent to call "gh aw upgrade" to upgrade to the latest version of the cli.


</details>


> **Custom agent used: agentic-workflows**
> GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing



<!-- START COPILOT CODING AGENT TIPS -->
---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey).