Skip to content

[deep-report] Document non-Copilot init/example parity gaps (Claude/Codex/custom engine) #53791

Description

@github-actions

Document what non-Copilot engines get from gh aw init instead of the Copilot-only artifacts

Description: Per today's Claude Code User Documentation Review (discussion #53691), cli.md:151,155-158 says non-Copilot engines "skip these Copilot-specific artifacts" (the custom agent file and MCP integration) but never explains what a Claude/Codex/Gemini/Pi user gets or should do instead — a prior fix (#52581) clarified why the gating exists but not this follow-on gap. The same review also found Codex has only 8 example workflows vs. Claude's 37 and Copilot's ~72 effective, and zero examples anywhere use the documented flat engine: custom frontmatter form (the one example found, shared/genaiscript.md, uses the nested engine:\n id: custom shape).

Expected Impact: Closes a real onboarding parity gap for non-Copilot engine users without requiring new tooling — pure documentation. Reduces confusion for the ~30% of engine users who aren't on Copilot.

Suggested Agent: New Agent / docs-focused agent

Estimated Effort: Quick (< 1 hour)

Data Source: DeepReport analysis, 2026-08-18 18:23Z cycle, discussion #53691.

Generated by 🔬 Deep Report · agent · 155.1 AIC · ⌖ 9.71 AIC · ⊞ 11.9K ·

  • expires on Aug 20, 2026, 10:32 AM UTC-08:00

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions