Description
gh aw init --engine claude (and codex/gemini/pi) intentionally skips the Copilot-specific custom-agent/MCP scaffolding, and cli.md's "Initializing for non-Copilot engines" table correctly documents what to do instead ("author an agent file in your own agent's format... from the same instructions") — but no worked example of that replacement exists in any of the six core docs pages. A Claude Code user has no concrete Claude Code subagent file to copy, unlike Copilot users who get .github/agents/agentic-workflows.md generated automatically. Verified live on main (commit f2e8122): cli.md's non-Copilot table states the replacement instruction with no linked example. (Distinct from closed #35509, which added the --engine flag itself; the flag exists and works — this is about the missing worked example for the documented manual step.)
Fix
Add a short worked example (e.g. a minimal .claude/agents/agentic-workflows.md subagent file pointing at the dispatcher skill) either inline in cli.md's non-Copilot section or as a linked snippet, mirroring the concreteness of the Copilot auto-generated artifact.
Expected Impact
Gives Claude Code users an equivalent on-ramp to Copilot users for driving gh-aw via their own agent, closing the "bring your own, no example" gap flagged as a Critical Blocker in today's docs review.
Suggested Agent
Claude Code Docs Review workflow follow-up / Copilot coding agent.
Estimated Effort
Medium (1-4 hours)
Data Source
DeepReport Intelligence Briefing 2026-08-21, mining discussion #54536, Critical Blocker #2.
Generated by 🔬 Deep Report · agent · 106.7 AIC · ⌖ 8.62 AIC · ⊞ 12.4K · ◷
Description
gh aw init --engine claude(and codex/gemini/pi) intentionally skips the Copilot-specific custom-agent/MCP scaffolding, andcli.md's "Initializing for non-Copilot engines" table correctly documents what to do instead ("author an agent file in your own agent's format... from the same instructions") — but no worked example of that replacement exists in any of the six core docs pages. A Claude Code user has no concrete Claude Code subagent file to copy, unlike Copilot users who get.github/agents/agentic-workflows.mdgenerated automatically. Verified live onmain(commit f2e8122):cli.md's non-Copilot table states the replacement instruction with no linked example. (Distinct from closed #35509, which added the--engineflag itself; the flag exists and works — this is about the missing worked example for the documented manual step.)Fix
Add a short worked example (e.g. a minimal
.claude/agents/agentic-workflows.mdsubagent file pointing at the dispatcher skill) either inline incli.md's non-Copilot section or as a linked snippet, mirroring the concreteness of the Copilot auto-generated artifact.Expected Impact
Gives Claude Code users an equivalent on-ramp to Copilot users for driving gh-aw via their own agent, closing the "bring your own, no example" gap flagged as a Critical Blocker in today's docs review.
Suggested Agent
Claude Code Docs Review workflow follow-up / Copilot coding agent.
Estimated Effort
Medium (1-4 hours)
Data Source
DeepReport Intelligence Briefing 2026-08-21, mining discussion #54536, Critical Blocker #2.