[plan] Annotate `gh aw init` agent-file scaffolding as Copilot-specific in docs

[github-actions]

Context

Created from the Claude Code User Documentation Review in discussion #31206.

Objective

Document that the .github/agents/agentic-workflows.agent.md file created by gh aw init is only used by the Copilot engine, so Claude/Codex/Gemini users aren't confused by a Copilot-only artifact in their repo.

Current State

docs/src/content/docs/setup/cli.md line ~134 says:

"Configures .gitattributes, creates the dispatcher agent file (.github/agents/agentic-workflows.agent.md)"

There is no note that this agent file is Copilot-specific. A Claude user running gh aw init gets a Copilot-only artifact committed to their repo with no guidance on what to do with it.

Approach

1. Open docs/src/content/docs/setup/cli.md around line 134
2. Add a note/callout after the gh aw init description: "The dispatcher agent file (.github/agents/agentic-workflows.agent.md) is only used by the Copilot engine. If you plan to use Claude, Codex, or Gemini exclusively, you can safely delete this file — it has no effect on other engines."
3. Consider also adding --engine <engine> flag documentation to gh aw init if that flag exists (check actual CLI behavior first)

Files to Modify

• docs/src/content/docs/setup/cli.md

Acceptance Criteria

• The gh aw init section clearly states the agent file is Copilot-specific
• Non-Copilot users have explicit guidance ("you can delete this file")
• If gh aw init --engine flag exists, it is documented

Generated by Plan Command for issue #discussion #31206 · ● 4.4M · ◷

• expires on May 11, 2026, 1:00 PM UTC

[github-actions]

🍪 Issue Monster selected this for Copilot

I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

Om nom nom! 🍪

🍪 Om nom nom by Issue Monster · ● 99K · ◷

[github-actions]

This issue was automatically closed because it expired on 2026-05-11T13:00:12.924Z.

Closed by Workflow