docs: Clarify engine selection in Quick Start guide

[Copilot]

Quick Start guide referenced engine selection vaguely, obscuring that Claude, Copilot, and Codex are all first-class options. Users may assume Copilot is required.

Changes

Prerequisites section - Expanded AI Account requirement to explicit list:

• GitHub Copilot subscription (with link)
• Anthropic Claude API key (with link, noted as "recommended for simple setup")
• OpenAI Codex API key (with link)

Interactive process description - Changed from:

1. Select an AI Engine to use

To:

1. **Select an AI Engine** - You'll be prompted to choose between Claude, Copilot, or Codex

Added TIP callout after interactive process:

Don't have a Copilot subscription? No problem! Claude and Codex work just as well for most workflows.

All language treats engines neutrally without suggesting Copilot primacy.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[plan] Document engine selection in Quick Start interactive flow</issue_title>
<issue_description>## Context

As identified in discussion #12027, the Quick Start guide mentions that gh aw init takes users through an "interactive process" but doesn't explicitly clarify that users will be prompted to select their AI engine (Claude, Copilot, or Codex).

Current State

docs/src/content/docs/setup/quick-start.md:54-55 states:

"This will take you through an interactive process to 1. Select an AI Engine to use 2. Add the workflow..."

While this technically mentions engine selection, it's not explicit enough about what engines are available and that Claude is a first-class option.

Problem

• Users approaching the Quick Start may not realize Claude is available
• The phrase "Select an AI Engine" is vague - what are the options?
• Claude Code users may assume Copilot is required before reading further
• Missing opportunity to reassure non-Copilot users early in the onboarding

Objective

Make the engine selection more explicit and welcoming to all engine users, particularly in the Quick Start guide.

Proposed Solution

Update docs/src/content/docs/setup/quick-start.md:54-55:

Current:

This will take you through an interactive process to 1. Select an AI Engine to use 2. Add the workflow...

Proposed:

This will take you through an interactive process to:
1. **Select an AI Engine** - You'll be prompted to choose between Claude, Copilot, or Codex
2. **Add the workflow** - Configure your first agentic workflow

Also consider adding to the Prerequisites section:

✅ **AI Account** - You need one of the following:
   - Anthropic Claude API key (recommended for simple setup)
   - GitHub Copilot subscription
   - OpenAI API key for Codex

Files to Modify

• docs/src/content/docs/setup/quick-start.md (around lines 21 for prerequisites, 54-55 for interactive flow)

Acceptance Criteria

• Update interactive process description to explicitly list engine options
• Add or update Prerequisites to show all three engine options
• Use neutral language that doesn't suggest Copilot is primary
• Verify documentation renders correctly
• Consider adding a note about API key setup timing

Optional Enhancement

Consider adding a callout after the gh aw init command:

> [!TIP]
> Don't have a Copilot subscription? No problem! Claude and Codex work just as well for most workflows. Just select your preferred engine when prompted.

References

• Discussion 🔍 Claude Code User Documentation Review - January 27, 2026 #12027 - Priority 2 recommendation

AI generated by Plan Command for discussion #12027

Comments on the Issue (you are @copilot in this section)

• Fixes [plan] Document engine selection in Quick Start interactive flow #12035

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[github-actions]

🔍 PR Triage Results

Category: docs | Risk: low | Priority: 43/100

Scores Breakdown

• Impact: 18/50 - Documentation - improves user experience
• Urgency: 7/30 - Recent PR, CI unstable
• Quality: 18/20 - CI passing, small focused change

📋 Recommended Action: auto_merge

This PR is an excellent auto-merge candidate:

• ✅ Low-risk documentation change
• ✅ Small, focused scope (16 lines changed, 1 file)
• ✅ CI passing
• ✅ Clear user benefit

This documentation improvement clarifies engine selection options in the Quick Start guide, making it clear that Claude, Copilot, and Codex are all first-class options.

---

Triaged by PR Triage Agent on 2026-01-28T00:34:49Z

AI generated by PR Triage Agent