Skip to content

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

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions