Source
DeepReport intelligence briefing — 2026-05-11. References: Claude Code User Documentation Review (discussion #31504).
Problem
The Quick Start page lists Claude as an engine choice, but the secret-setup TIP block immediately following it is Copilot-only:
Setting up COPILOT_GITHUB_TOKEN?
- Create a fine-grained PAT under your user account.
- Under Permissions → Account permissions, set Copilot Requests to Read...
There is no parallel "Setting up ANTHROPIC_API_KEY?" note. A Claude Code user has to context-switch to auth.mdx to find equivalent instructions. The README never mentions Claude at all. The asymmetry signals Copilot is the "real" path and Claude is a footnote.
Suggested fix
- Add a sibling NOTE block to
docs/src/content/docs/setup/quick-start.mdx:75-80 for ANTHROPIC_API_KEY mirroring the Copilot one (link to Anthropic Console, scope guidance, etc.).
- Add a one-line callout in
README.md:32-34: "gh-aw supports GitHub Copilot (default), Claude, Codex, and Gemini engines."
- (Optional) Refactor the secret-setup block into a tabbed/per-engine list to scale to 4 engines without prose duplication.
Effort / Impact
- Effort: < 2 hours (docs-only PR)
- Impact: Medium — closes a measurable onboarding asymmetry; the doc review found Claude code examples skew ~6.6:1 toward Copilot.
- Suggested agent: Documentation-writing agent (Claude)
Success criteria
- A Claude Code user can complete Quick Start without leaving the page.
- README mentions all four supported engines at least once.
Related: discussion #31504
Generated by DeepReport - Intelligence Gathering Agent · ● 12.8M · ◷
Source
DeepReport intelligence briefing — 2026-05-11. References: Claude Code User Documentation Review (discussion #31504).
Problem
The Quick Start page lists Claude as an engine choice, but the secret-setup TIP block immediately following it is Copilot-only:
There is no parallel "Setting up
ANTHROPIC_API_KEY?" note. A Claude Code user has to context-switch toauth.mdxto find equivalent instructions. The README never mentions Claude at all. The asymmetry signals Copilot is the "real" path and Claude is a footnote.Suggested fix
docs/src/content/docs/setup/quick-start.mdx:75-80forANTHROPIC_API_KEYmirroring the Copilot one (link to Anthropic Console, scope guidance, etc.).README.md:32-34: "gh-aw supports GitHub Copilot (default), Claude, Codex, and Gemini engines."Effort / Impact
Success criteria
Related: discussion #31504