Description
The quick-start guide does not surface --engine claude in the prerequisites or gh aw add flow. Omitting engine: silently compiles to Copilot (per how-they-work.mdx:26), and gh aw init emits Copilot-specific artifacts unless --engine claude is passed. This silent default is disclosed only mid-quick-start, not at the start where users make decisions.
Suggested Changes
- In
docs/src/content/docs/quick-start.mdx prerequisites section: add a note that the default engine is Copilot and Claude users should pass --engine claude
- In the
gh aw add / gh aw init flow steps: show the --engine claude flag explicitly alongside the default Copilot invocation
Files Affected
docs/src/content/docs/quick-start.mdx (prerequisites section, init/add steps)
Success Criteria
- Prerequisites section mentions the default engine is Copilot
--engine claude is shown in the gh aw init or gh aw add step for Claude users
- Documentation builds successfully
Source
Extracted from Claude Code User Documentation Review - 2026-07-19
Priority
Medium — prevents Claude users from accidentally creating Copilot-targeted workflows; stable finding across 29 daily reviews
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · 48.6 AIC · ⌖ 5.07 AIC · ⊞ 7K · ◷
Description
The quick-start guide does not surface
--engine claudein the prerequisites orgh aw addflow. Omittingengine:silently compiles to Copilot (perhow-they-work.mdx:26), andgh aw initemits Copilot-specific artifacts unless--engine claudeis passed. This silent default is disclosed only mid-quick-start, not at the start where users make decisions.Suggested Changes
docs/src/content/docs/quick-start.mdxprerequisites section: add a note that the default engine is Copilot and Claude users should pass--engine claudegh aw add/gh aw initflow steps: show the--engine claudeflag explicitly alongside the default Copilot invocationFiles Affected
docs/src/content/docs/quick-start.mdx(prerequisites section, init/add steps)Success Criteria
--engine claudeis shown in thegh aw initorgh aw addstep for Claude usersSource
Extracted from Claude Code User Documentation Review - 2026-07-19
Priority
Medium — prevents Claude users from accidentally creating Copilot-targeted workflows; stable finding across 29 daily reviews