Skip to content

Comments

docs: update init/upgrade/fix help text to remove stale .github/aw/ prompt file references#18218

Merged
pelikhan merged 3 commits intomainfrom
copilot/update-docs-help-text
Feb 24, 2026
Merged

docs: update init/upgrade/fix help text to remove stale .github/aw/ prompt file references#18218
pelikhan merged 3 commits intomainfrom
copilot/update-docs-help-text

Conversation

Copy link
Contributor

Copilot AI commented Feb 24, 2026

PR #14150 removed CLI management of .github/aw/ prompt files — they now live in the gh-aw repo and are resolved directly from GitHub. Multiple help strings and docs still described init/upgrade/fix as creating or verifying those files.

Changes

CLI help text (pkg/cli/)

  • init_command.go: Remove "creating GitHub Copilot instruction files" and the "Verifies workflow prompt files exist in .github/aw/" bullet; keep only the dispatcher agent mention
  • fix_command.go: Drop step about "Update prompt and agent files to latest templates"; fix delete-old-agents description to accurately reflect it deletes old workflow-specific .agent.md files from .github/agents/
  • upgrade_command.go: "Updates all agent and prompt files" → "Updates the dispatcher agent file"; remove "All workflow prompts exist in .github/aw/" from the ensures list; align runtime log messages
  • copilot_agents.go: Fix deleteOldAgentFiles function comment

Docs

  • guides/upgrading.md: Rewrite overview item 1 and section 3.1 to only mention the dispatcher agent; update example output and the Step 8 commit command (drop .github/aw/)
  • setup/cli.md: Fix init one-liner — remove "Copilot instructions, prompt files"
  • install.md: Remove .github/aw/github-agentic-workflows.md from both "What this does" and git status file lists; update "What's Next?" to link to online docs
  • create.md: Remove .github/aw/github-agentic-workflows.md from the post-init file list

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • https://api.github.com/graphql
    • Triggering command: /usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw nonexistent-workinit --limit /opt/hostedtoolcache/go/1.25.0/x64/pkg/tool/linux_amd64/compile -o /tmp/go-build1116092888/b420/_pkg_.a -trimpath /usr/bin/git -p main -lang=go1.25 git (http block)
  • https://api.github.com/repos/actions/ai-inference/git/ref/tags/v1
    • Triggering command: /usr/bin/gh gh api /repos/actions/ai-inference/git/ref/tags/v1 --jq .object.sha ry=1 GO111MODULE 6092888/b387/_pkg_.a GOINSECURE GOMOD GOMODCACHE go env -json (http block)
  • https://api.github.com/repos/actions/checkout/git/ref/tags/v3
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v3 --jq .object.sha g_.a GO111MODULE ache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go env 3358-28012/test-767640884/.github/workflows GO111MODULE ache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE ortcfg (http block)
  • https://api.github.com/repos/actions/checkout/git/ref/tags/v4
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v4 --jq .object.sha bot-detection.md GO111MODULE /opt/hostedtoolcache/go/1.25.0/x-buildmode=exe GOINSECURE GOMOD GOMODCACHE go env runs/20260224-213358-28012/test-2190228036/.github/workflows GO111MODULE /opt/hostedtoolcache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v4 --jq .object.sha vaScript3474671344/001/test-frontmatter-with-env-template-expressions.md GO111MODULE Name,createdAt,startedAt,updatedAt,event,headBranch,headSha,displayTitle GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE /opt/hostedtoolcache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v4 --jq .object.sha t0 sh (http block)
  • https://api.github.com/repos/actions/checkout/git/ref/tags/v5
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v5 --jq .object.sha 4185715229/.github/workflows GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE ache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v5 --jq .object.sha /tmp/go-build3144974230/b001/_pkg_.a -trimpath /usr/bin/git -p main -lang=go1.25 git rev-�� --show-toplevel -goversion /usr/bin/git -c=4 -nolocalimports -importcfg git (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/checkout/git/ref/tags/v5 --jq .object.sha --show-toplevel sh /usr/bin/git "prettier" --chegit node 64/bin/go git rev-�� --git-dir go /opt/hostedtoolcache/node/24.13.0/x64/bin/node -json GO111MODULE 64/bin/go /opt/hostedtoolcache/node/24.13.0/x64/bin/node (http block)
  • https://api.github.com/repos/actions/github-script/git/ref/tags/v8
    • Triggering command: /usr/bin/gh gh api /repos/actions/github-script/git/ref/tags/v8 --jq .object.sha GOSUMDB GOWORK 64/bin/go GOINSECURE GOMOD GOMODCACHE erignore m/_n�� -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/github-script/git/ref/tags/v8 --jq .object.sha ck 'scripts/**/*GOINSECURE GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE sh (http block)
    • Triggering command: /usr/bin/gh gh api /repos/actions/github-script/git/ref/tags/v8 --jq .object.sha GOPATH); \ if coGOINSECURE GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE node (http block)
  • https://api.github.com/repos/actions/setup-go/git/ref/tags/v4
    • Triggering command: /usr/bin/gh gh api /repos/actions/setup-go/git/ref/tags/v4 --jq .object.sha vaScript3474671344/001/test-complex-frontmatter-.github/workflows/test.md GO111MODULE /opt/hostedtoolcache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE /opt/hostedtoolcache/go/1.25.0/x64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
  • https://api.github.com/repos/actions/setup-node/git/ref/tags/v4
    • Triggering command: /usr/bin/gh gh api /repos/actions/setup-node/git/ref/tags/v4 --jq .object.sha ingutil.test GO111MODULE Name,createdAt,startedAt,updated-test.short=true GOINSECURE GOMOD GOMODCACHE 2GrHKbdPFsnY6xQzyS/oFy7E6D7PTBexQgP2YYC/SYVWI1Pjb7L_MWnrvwk8 env runs/20260224-213358-28012/test-2190228036/.github/workflows GO111MODULE g_.a GOINSECURE GOMOD GOMODCACHE go (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/1/artifacts
    • Triggering command: /usr/bin/gh gh run download 1 --dir test-logs/run-1 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 1 --dir test-logs/run-1 go x_amd64/compile -json GO111MODULE 6092888/b392/vet--show-toplevel x_amd64/compile /tmp�� GOMODCACHE go 0/x64/lib/node_modules/npm/node_modules/@npmcli/run-script/lib/node-gyp-bin/sh -json l 0/x64/bin/node git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/12345/artifacts
    • Triggering command: /usr/bin/gh gh run download 12345 --dir test-logs/run-12345 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go estl�� -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 12345 --dir test-logs/run-12345 go x_amd64/compile -json l 6092888/b384/vet--git-dir x_amd64/compile main�� run --auto tions/setup/node_modules/.bin/sh --detach GO111MODULE 0/x64/bin/node git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/12346/artifacts
    • Triggering command: /usr/bin/gh gh run download 12346 --dir test-logs/run-12346 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go estl�� -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 12346 --dir test-logs/run-12346 go x_amd64/asm tructions-test-4git GO111MODULE 6092888/b383/vet.cfg x_amd64/asm rev-�� HEAD go tions/node_modules/.bin/sh -json l /opt/hostedtoolc--show-toplevel git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/2/artifacts
    • Triggering command: /usr/bin/gh gh run download 2 --dir test-logs/run-2 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 2 --dir test-logs/run-2 go /usr/bin/git -json GO111MODULE 6092888/b372/vetuser.email git log --oneline -10 tions/node_modules/.bin/sh -json GO111MODULE ache/go/1.25.0/x--show-toplevel git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/3/artifacts
    • Triggering command: /usr/bin/gh gh run download 3 --dir test-logs/run-3 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 3 --dir test-logs/run-3 go x_amd64/asm RDBU/aWxB70UjWw_git GO111MODULE /opt/hostedtoolcache/go/1.25.0/x/tmp/gh-aw-test-runs/20260224-213446-32118/test-740055094/.github/workflows x_amd64/asm rev-�� HEAD go tions/setup/js/node_modules/.bin/sh -json l 0/x64/bin/node git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/4/artifacts
    • Triggering command: /usr/bin/gh gh run download 4 --dir test-logs/run-4 GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 4 --dir test-logs/run-4 go x_amd64/vet SameOutput321808git GO111MODULE /opt/hostedtoolc--git-dir x_amd64/vet stat�� GOMODCACHE go de_modules/.bin/sh -json stmain.go /tmp/go-build111inputs.version git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/runs/5/artifacts
    • Triggering command: /usr/bin/gh gh run download 5 --dir test-logs/run-5 GO111MODULE x_amd64/compile GOINSECURE GOMOD GOMODCACHE x_amd64/compile env ty-test.md GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run download 5 --dir test-logs/run-5 0FbGgnk7T9XC-/aWxB70UjWw_QvJd_RD../../../.prettierignore x_amd64/cgo ry=1 l 6092888/b381/_pkuser.name x_amd64/cgo bran�� --show-current go tions/setup/node_modules/.bin/sh -json GO111MODULE 0/x64/bin/node git (http block)
  • https://api.github.com/repos/github/gh-aw/actions/workflows
    • Triggering command: /usr/bin/gh gh workflow list --json name,state,path GOSUMDB GOWORK 64/bin/go GOINSECURE GOMOD GOMODCACHE go env e=false GO111MODULE 64/bin/go GOINSECURE %H %ct %D 2b006f9873aa1f54-json go (http block)
    • Triggering command: /usr/bin/gh gh run list --json databaseId,number,url,status,conclusion,workflowName,createdAt,startedAt,updatedAt,event,headBranch,headSha,displayTitle --workflow nonexistent-workflow-12345 --limit 100 GOMOD GOMODCACHE go env xHRU/olnhm9tW-naGOSUMDB GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE 8530471/b395/importcfg (http block)
    • Triggering command: /usr/bin/gh gh run list --json databaseId,number,url,status,conclusion,workflowName,createdAt,startedAt,updatedAt,event,headBranch,headSha,displayTitle --workflow nonexistent-workflow-12345 --limit 6 GOMOD GOMODCACHE x_amd64/compile env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
  • https://api.github.com/repos/github/gh-aw/git/ref/tags/v1.0.0
    • Triggering command: /usr/bin/gh gh api /repos/github/gh-aw/git/ref/tags/v1.0.0 --jq .object.sha -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env 961076296/.github/workflows GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
  • https://api.github.com/repos/nonexistent/action/git/ref/tags/v999.999.999
    • Triggering command: /usr/bin/gh gh api /repos/nonexistent/action/git/ref/tags/v999.999.999 --jq .object.sha -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
  • https://api.github.com/repos/nonexistent/repo/actions/runs/12345
    • Triggering command: /usr/bin/gh gh run view 12345 --repo nonexistent/repo --json status,conclusion GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh run view 12345 --repo nonexistent/repo --json status,conclusion runs/20260224-21git GO111MODULE /opt/hostedtoolcache/go/1.25.0/x--show-toplevel x_amd64/vet add . go tions/setup/js/node_modules/.bin/node -json GO111MODULE /usr/bin/git git (http block)
  • https://api.github.com/repos/owner/repo/actions/workflows
    • Triggering command: /usr/bin/gh gh workflow list --json name,state,path --repo owner/repo 64/bin/go GOINSECURE GOMOD ode-gyp-bin/node-json ache/go/1.25.0/xGO111MODULE env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh workflow list --json name,state,path --repo owner/repo 64/bin/go GOINSECURE GOMOD GOMODCACHE ache/go/1.25.0/xGO111MODULE env 8530471/b388/_pkGOINSECURE GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh workflow list --json name,state,path --repo owner/repo /usr/bin/git -json GO111MODULE 64/pkg/tool/linu--write git rev-�� ath ../../../.pr**/*.json 64/pkg/tool/linu--ignore-path /usr/bin/git -json GO111MODULE ache/go/1.25.0/x"prettier" --write '../../../**/*.json' '!../../../pkg/workflow/js/**/*.json' ---s git (http block)
  • https://api.github.com/repos/owner/repo/contents/file.md
    • Triggering command: /tmp/go-build1116092888/b381/cli.test /tmp/go-build1116092888/b381/cli.test -test.testlogfile=/tmp/go-build1116092888/b381/testlog.txt -test.paniconexit0 -test.v=true -test.parallel=4 -test.timeout=10m0s -test.run=^Test -test.short=true GOINSECURE GOMOD GOMODCACHE go env ck 'scripts/**/*GOINSECURE GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /tmp/go-build3582542384/b381/cli.test /tmp/go-build3582542384/b381/cli.test -test.testlogfile=/tmp/go-build3582542384/b381/testlog.txt -test.paniconexit0 -test.v=true -test.parallel=4 -test.timeout=10m0s -test.run=^Test -test.short=true p/TestGetNpmBinPsh GO111MODULE 64/bin/go git rev-�� ch go /usr/bin/git "; \ else \ echo "��� Warning: .github/aw/actions-lock.json does not exist yet"; \ fi GO111MODULE ache/go/1.25.0/xprettier git (http block)
  • https://api.github.com/repos/test-owner/test-repo/actions/secrets
    • Triggering command: /usr/bin/gh gh api /repos/test-owner/test-repo/actions/secrets --jq .secrets[].name GOSUMDB GOWORK 64/bin/go GOINSECURE GOMOD GOMODCACHE go env -json GO111MODULE 64/bin/go GOINSECURE GOMOD GOMODCACHE go (http block)
    • Triggering command: /usr/bin/gh gh api /repos/test-owner/test-repo/actions/secrets --jq .secrets[].name --show-toplevel go /usr/bin/git -json GO111MODULE 64/bin/go git rev-�� ath ../../../.pr**/*.json go /usr/bin/git -json GO111MODULE ache/go/1.25.0/x"prettier" --write '../../../**/*.json' '!../../../pkg/workflow/js/**/*.json' ---errorsas git (http block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>Update docs/help text: init/upgrade/fix no longer create .github/aw prompt files</issue_title>
<issue_description>PR #14150 removed CLI management of prompt files in .github/aw/. However, multiple docs and help strings still describe init/upgrade/fix as creating or updating those files.

Incorrect wording examples (install.md on main):

  • L45–48:
    • “Creates .github/aw/github-agentic-workflows.md…”
    • “Creates workflow management prompts in .github/aw/ directory”
  • L63–67: lists .github/aw/github-agentic-workflows.md as created by gh aw init

These are outdated after #14150, which keeps prompt files only in the gh-aw repo and has the agent resolve them directly from GitHub.

Other likely outdated references (repo-wide scan):

  • pkg/cli/init_command.go (help text: “creating GitHub Copilot instruction files”, “verifies workflow prompt files exist in .github/aw/”)
  • pkg/cli/fix_command.go (help text: “Update prompt and agent files to latest templates”)
  • docs/src/content/docs/guides/upgrading.md (upgrade says it updates .github/aw/* prompt files)
  • docs/src/content/docs/setup/cli.md (init description says it configures prompt files)
  • create.md (mentions .github/aw/github-agentic-workflows.md as a file that may be created by init)

Expected change:

  • Update doc/help text to reflect that .github/aw/* prompt files live in the gh-aw repo and are not created/updated by CLI commands.
  • Keep mention that init still creates .github/agents/agentic-workflows.agent.md (dispatcher agent) and other local config files.
    </issue_description>

Comments on the Issue (you are @copilot in this section)

@pelikhan init should write the agent file. @pelikhan Validate that init creates .github/agents/agentic-workflows.agent.md

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…ub/aw prompt files

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update docs to remove references for prompt files docs: update init/upgrade/fix help text to remove stale .github/aw/ prompt file references Feb 24, 2026
Copy link

@jeremiah-snee-openx jeremiah-snee-openx left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@pelikhan pelikhan marked this pull request as ready for review February 24, 2026 22:00
Copilot AI review requested due to automatic review settings February 24, 2026 22:00
@pelikhan pelikhan merged commit 6b0af49 into main Feb 24, 2026
44 checks passed
@pelikhan pelikhan deleted the copilot/update-docs-help-text branch February 24, 2026 22:00
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates CLI help text and user-facing docs to remove stale references to .github/aw/ prompt files being created/managed by init/upgrade/fix, reflecting that prompts are now resolved from GitHub instead.

Changes:

  • Adjusted CLI command help strings for init, upgrade, and fix to stop claiming the CLI manages .github/aw/*.md prompt files.
  • Updated docs to describe only the dispatcher agent file (.github/agents/agentic-workflows.agent.md) as being created/updated by the CLI.
  • Updated install/upgrade guides to remove .github/aw/github-agentic-workflows.md from “files created” lists and to link to online documentation.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 7 comments.

Show a summary per file
File Description
pkg/cli/upgrade_command.go Updates upgrade help/log text to focus on dispatcher agent file updates.
pkg/cli/init_command.go Removes help text about creating/verifying .github/aw/ prompt files.
pkg/cli/fix_command.go Removes help steps about updating prompt files and clarifies old agent cleanup wording.
pkg/cli/copilot_agents.go Updates deleteOldAgentFiles comment to match new intent.
install.md Removes .github/aw/... file claims and points readers to online docs.
docs/src/content/docs/setup/cli.md Updates init one-liner description to remove prompt file claims.
docs/src/content/docs/guides/upgrading.md Rewrites upgrade doc section to mention dispatcher agent only and updates example output/commands.
create.md Removes .github/aw/github-agentic-workflows.md from post-init file list.
Comments suppressed due to low confidence (1)

pkg/cli/upgrade_command.go:302

  • The updateAgentFiles doc comment is now inaccurate: the function updates more than the dispatcher agent (it also upgrades copilot-setup-steps.yml). Please update the comment (or rename/split the function) so it reflects the full behavior.
// updateAgentFiles updates the dispatcher agent file to the latest template
func updateAgentFiles(verbose bool) error {

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 47 to 49
• delete-schema-file: Deletes deprecated .github/aw/schemas/agentic-workflow.json
• delete-old-agents: Deletes old .agent.md files moved to .github/aw/
• delete-old-agents: Deletes old workflow-specific .agent.md files from .github/agents/
• delete-old-templates: Removes old template files from pkg/cli/templates/
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The delete-old-agents codemod description says it deletes only workflow-specific .agent.md files from .github/agents/, but deleteOldAgentFiles also deletes several non-.agent.md files (e.g. create-agentic-workflow.md, setup-agentic-workflows.md) and even an entry under .github/aw/. Please update this help text to match what the codemod actually removes (or narrow the deletion list).

Copilot uses AI. Check for mistakes.
Comment on lines 57 to +60
4. Write updated files back to disk (with --write flag)
5. Update prompt and agent files to latest templates (similar to 'init' command)
6. Delete deprecated .github/aw/schemas/agentic-workflow.json file if it exists
7. Delete old template files from pkg/cli/templates/ (with --write flag)
8. Delete old .agent.md files that have been moved to .github/aw/ (with --write flag)
5. Delete deprecated .github/aw/schemas/agentic-workflow.json file if it exists
6. Delete old template files from pkg/cli/templates/ (with --write flag)
7. Delete old workflow-specific .agent.md files from .github/agents/ (with --write flag)
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The help text no longer mentions updating the dispatcher agent, but runFixCommand still calls ensureAgenticWorkflowsDispatcher on every invocation. Please either restore a step noting that the dispatcher agent file is updated (even in dry-run), or change the implementation to match the documented behavior.

Copilot uses AI. Check for mistakes.
Comment on lines +150 to +152
// Step 1: Update dispatcher agent file (like init command)
fmt.Fprintln(os.Stderr, console.FormatInfoMessage("Updating agent file..."))
upgradeLog.Print("Updating agent file")
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This step/message says only the dispatcher agent file is updated, but updateAgentFiles also runs upgradeCopilotSetupSteps (updating .github/workflows/copilot-setup-steps.yml). Please adjust the user-facing text/logs to reflect all files updated, or split setup-steps into its own step.

This issue also appears on line 301 of the same file.

Copilot uses AI. Check for mistakes.
}

// deleteOldAgentFiles deletes old .agent.md files that have been moved to .github/aw/
// deleteOldAgentFiles deletes old workflow-specific .agent.md files from .github/agents/
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This comment says the function deletes old workflow-specific .agent.md files from .github/agents/, but the implementation also deletes at least one file from .github/aw/ via the filesToDelete map. Please update the comment to reflect both locations (or remove the .github/aw deletion if it’s no longer intended).

Suggested change
// deleteOldAgentFiles deletes old workflow-specific .agent.md files from .github/agents/
// deleteOldAgentFiles deletes old workflow-specific agent/template files from .github/agents/ and .github/aw/

Copilot uses AI. Check for mistakes.
#### `init`

Initialize repository for agentic workflows. Configures `.gitattributes`, Copilot instructions, prompt files, and logs `.gitignore`. Enables MCP server integration by default (use `--no-mcp` to skip). Without arguments, enters interactive mode for engine selection and secret configuration.
Initialize repository for agentic workflows. Configures `.gitattributes`, creates the dispatcher agent file (`.github/agents/agentic-workflows.agent.md`), and logs `.gitignore`. Enables MCP server integration by default (use `--no-mcp` to skip). Without arguments, enters interactive mode for engine selection and secret configuration.
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This description says init "logs .gitignore", which is unclear and appears incorrect (init doesn’t create .github/aw/logs/.gitignore; that’s handled by the logs download command). Please reword to either remove this clause or explicitly reference .github/aw/logs/.gitignore and the command that creates it.

Suggested change
Initialize repository for agentic workflows. Configures `.gitattributes`, creates the dispatcher agent file (`.github/agents/agentic-workflows.agent.md`), and logs `.gitignore`. Enables MCP server integration by default (use `--no-mcp` to skip). Without arguments, enters interactive mode for engine selection and secret configuration.
Initialize repository for agentic workflows. Configures `.gitattributes` and creates the dispatcher agent file (`.github/agents/agentic-workflows.agent.md`). Enables MCP server integration by default (use `--no-mcp` to skip). Without arguments, enters interactive mode for engine selection and secret configuration.

Copilot uses AI. Check for mistakes.
Comment on lines +70 to 74
### 3.1 Updates Dispatcher Agent File

The upgrade updates these files to the latest templates (similar to running `gh aw init`):
The upgrade updates the dispatcher agent file to the latest template (similar to running `gh aw init`):

- `.github/aw/github-agentic-workflows.md` - GitHub Copilot custom instructions
- `.github/agents/agentic-workflows.agent.md` - Dispatcher agent for routing tasks
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section says upgrade updates only the dispatcher agent file, but the gh aw upgrade implementation also upgrades .github/workflows/copilot-setup-steps.yml during step 1. Please document that additional file update here so users know what to expect in diffs/commits.

Copilot uses AI. Check for mistakes.
@@ -105,7 +102,7 @@ After successful initialization, the user can:
- **Add workflows from repos**: `gh aw add githubnext/agentics`
- **Create new workflows**: `gh aw new <workflow-name>` os using the agent
Copy link

Copilot AI Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: "os" should be "or".

Suggested change
- **Create new workflows**: `gh aw new <workflow-name>` os using the agent
- **Create new workflows**: `gh aw new <workflow-name>` or using the agent

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update docs/help text: init/upgrade/fix no longer create .github/aw prompt files

3 participants