Skip to content

[deep-report] Quick Start sample workflow defaults to Copilot — Claude-only users will fail their first run #32423

@github-actions

Description

@github-actions

Problem

The Quick Start (docs/src/content/docs/quick-start.mdx, ~lines 62–73) installs githubnext/agentics/daily-repo-status as the demo workflow. That workflow's frontmatter declares no engine:, so it defaults to copilot.

A developer using only Claude Code (no Copilot subscription, no COPILOT_GITHUB_TOKEN) will follow the Quick Start verbatim, run the workflow, and hit a Copilot engine failure on their very first run. The Quick Start does not flag this; the add-wizard engine prompt is only mentioned in passing.

Source: Claude Code User Documentation Review — 2026-05-15.

This is distinct from #31727 (which tracks adding the ANTHROPIC_API_KEY walkthrough). #31727 covers secret setup; this issue covers the engine selection trap in the sample workflow itself.

Suggested Fix

Either:

Option A (preferred): Patch the Quick Start to instruct non-Copilot users to add engine: claude (or engine: codex) to the workflow .md after add-wizard completes, with a one-line example.

Option B: Update the sample workflow at githubnext/agentics/daily-repo-status (or fork it for the Quick Start) so the engine is explicit, and have add-wizard patch it based on the user's chosen engine.

Also: make the COPILOT_GITHUB_TOKEN (6-step) and ANTHROPIC_API_KEY (2-step) callouts in the Quick Start visually parallel — the asymmetry signals Copilot as the privileged path.

Expected Impact

Removes the most common first-run failure mode for the ~half of evaluators who do not use Copilot.

Estimated Effort

~30 minutes (docs option) or ~1 hour (wizard-patch option).

Suggested Agent

Any coding agent — small, contained docs/wizard change.

Filed by DeepReport — Intelligence Briefing 2026-05-15 (#aw_dr17). Reference: workflow run §25925886771.

Generated by 🔬 DeepReport - Intelligence Gathering Agent · ● 16.7M ·

  • expires on May 17, 2026, 3:37 PM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions