[claude-code-user-docs-review] 🔍 Claude Code User Documentation Review - 2026-10-02 #65018
Closed
Replies: 1 comment
|
This discussion was automatically closed because it expired on 2026-10-03T12:51:49.873Z.
|
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Executive Summary
No critical blockers remain for Claude Code users: the
CLAUDE_CODE_OAUTH_TOKENgap stays resolved for a 4th consecutive run, and today the long-standinggh aw initscaffolding-parity gap is newly resolved via an explicit comparison table (cli.md:128-144). The main friction left is a persistent ~2x example/smoke-test parity gap (Claude 58 vs Copilot 115 engine declarations) and Claude's setup requiring two external doc-hops versus Codex's fully self-contained section.Severity Findings
Critical / Major / Minor (click to expand)
Critical Blockers: None found this run.
Major Obstacles
engine: claude(or nestedid: claude) appears 58 times across.github/workflows/*.mdvs 115 for Copilot (~1.98x); smoke-test variants are 9 (smoke-claude*.md,smoke-github-claude.md,smoke-claude-on-copilot.md) vs 15 (smoke-copilot*.md). A Claude-only user has roughly half the reference material to copy from.quick-start.mdx:151links out to "Anthropic Workload Identity Federation," thenquick-start.mdx:155links out again to "Using Claude Code with GitHub Agentic Workflows" for "the complete setup." The Codex block (quick-start.mdx:157-163) has no such hand-off — it's fully inline. (Gemini also has one WIF link at line 171 but no second "complete setup" link, so Claude carries the most hops of any engine.)quick-start.mdx:72) appears before Claude/Codex/Gemini are even named, framing Copilot as default path for a reader who has explicitly opted out of it.Minor Confusion
model:, e.g.model: anthropic/claude-sonnet-5) is an extra indirection layer not required by any other engine (quick-start.mdx:175-177).tools.md:128-130) — easy to misread as a Claude-specific restriction when it applies uniformly to three engines.Engine & Tool Matrix
COPILOT_GITHUB_TOKENPAT (quick-start.mdx:135-143)copilot-requests: writeor PATquick-start.mdx:145-155)ANTHROPIC_API_KEYor WIFquick-start.mdx:157-163)smoke-codex.md)OPENAI_API_KEY/CODEX_API_KEYshared/genaiscript.md)No Claude-exclusive tool gaps were found in
tools.md; the one default-disabled note (tools.md:128) applies equally to Codex, Claude, and Copilot, not Claude alone.Auth Gaps
ANTHROPIC_API_KEYsetup (quick-start.mdx:145-149) is as clear as Copilot's and Codex's — create key,gh secret set, done.quick-start.mdx:151/171) — consistent across engines, not a Claude-specific gap.CLAUDE_CODE_OAUTH_TOKENincompatibility is now explicitly documented inline (quick-start.mdx:153) — this resolves a blocker flagged in every run since 2026-08-22.gh aw init --engine claudebehavior is now fully explained with a side-by-side artifact table and documented replacements (cli.md:128-144) — resolves the scaffolding-parity gap flagged repeatedly since 2026-09-15.Recommended Actions
smoke-copilot-*variants: arm, sdk, sub-agents, auth modes) to close the 9-vs-15 smoke gap.quick-start.mdx, keep WIF as the only external link, matching Gemini's single-hop pattern).quick-start.mdx:72to list all four engines neutrally before any "start here" recommendation, so non-Copilot users don't read the guide as Copilot-primary.Meta Note
For the 18th consecutive day,
.claude/agents/doc-reader.mdand.claude/agents/engine-example-counter.mdfail to register as custom agents (missingname:frontmatter), andEditpermission to fix them was denied again this run. Background general-purpose agents carrying the same instructions were used as a fallback; amissing_toolreport is filed separately so this infrastructure gap gets tracked outside the daily doc-review noise.References:
All reactions