docs: align CLI workshop with the App learning flow - #188
Open
GeekTrainer wants to merge 13 commits into
Open
GeekTrainer wants to merge 13 commits into
GeekTrainer wants to merge 13 commits into
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add the First steps Copilot app tour adapted from James Montemagno's lab and move existing scenario workshops under Real-world development. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add accessible alternatives, correct Copilot commands and shortcuts, and clarify review and navigation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Integrate the new optional Foundry Agent series into the real-world development CLI workshop paths. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the VS Code Foundry Toolkit workshop under the real-world development category and preserve localized paths.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Integrate the Copilot app Foundry Canvas workshop under the real-world development category and preserve localized paths.\n\nCo-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
…hop-reordered # Conflicts: # AUTHORING.md # docs/app/7-canvases.md # docs/app/9-review.md # docs/app/README.md # docs/es-es/app/7-canvases.md # docs/es-es/app/9-review.md # docs/es-es/app/README.md # docs/ja-jp/app/7-canvases.md # docs/ja-jp/app/9-review.md # docs/ja-jp/app/README.md # docs/ko-kr/app/7-canvases.md # docs/ko-kr/app/9-review.md # docs/ko-kr/app/README.md # docs/pt-br/app/7-canvases.md # docs/pt-br/app/9-review.md # docs/pt-br/app/README.md # docs/zh-cn/app/7-canvases.md # docs/zh-cn/app/9-review.md # docs/zh-cn/app/README.md # website/astro.config.mjs
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ainer/app-workshop-reordered # Conflicts: # AUTHORING.md # docs/README.md # docs/app/5-mcp-playwright.md # docs/es-es/README.md # docs/es-es/app/5-mcp-playwright.md # docs/es-es/real-world-development/app/10-review.md # docs/es-es/real-world-development/app/2-add-star-rating.md # docs/es-es/real-world-development/app/3-agent-modes.md # docs/es-es/real-world-development/app/3-custom-instructions.md # docs/es-es/real-world-development/app/4-build-filtering.md # docs/es-es/real-world-development/app/4-custom-instructions.md # docs/es-es/real-world-development/app/5-agent-skills.md # docs/es-es/real-world-development/app/5-mcp-playwright.md # docs/es-es/real-world-development/app/6-agent-merge.md # docs/es-es/real-world-development/app/6-mcp-playwright.md # docs/es-es/real-world-development/app/7-canvases.md # docs/es-es/real-world-development/app/7-qa-agent.md # docs/es-es/real-world-development/app/8-create-pull-request.md # docs/es-es/real-world-development/app/9-canvases.md # docs/es-es/real-world-development/app/9-review.md # docs/ja-jp/README.md # docs/ja-jp/app/5-mcp-playwright.md # docs/ja-jp/real-world-development/app/10-review.md # docs/ja-jp/real-world-development/app/2-add-star-rating.md # docs/ja-jp/real-world-development/app/3-agent-modes.md # docs/ja-jp/real-world-development/app/3-custom-instructions.md # docs/ja-jp/real-world-development/app/4-build-filtering.md # docs/ja-jp/real-world-development/app/4-custom-instructions.md # docs/ja-jp/real-world-development/app/5-agent-skills.md # docs/ja-jp/real-world-development/app/5-mcp-playwright.md # docs/ja-jp/real-world-development/app/6-agent-merge.md # docs/ja-jp/real-world-development/app/6-mcp-playwright.md # docs/ja-jp/real-world-development/app/7-canvases.md # docs/ja-jp/real-world-development/app/7-qa-agent.md # docs/ja-jp/real-world-development/app/8-create-pull-request.md # docs/ja-jp/real-world-development/app/9-canvases.md # docs/ja-jp/real-world-development/app/9-review.md # docs/ko-kr/README.md # docs/ko-kr/app/5-mcp-playwright.md # docs/ko-kr/real-world-development/app/10-review.md # docs/ko-kr/real-world-development/app/2-add-star-rating.md # docs/ko-kr/real-world-development/app/3-agent-modes.md # docs/ko-kr/real-world-development/app/3-custom-instructions.md # docs/ko-kr/real-world-development/app/4-build-filtering.md # docs/ko-kr/real-world-development/app/4-custom-instructions.md # docs/ko-kr/real-world-development/app/5-agent-skills.md # docs/ko-kr/real-world-development/app/5-mcp-playwright.md # docs/ko-kr/real-world-development/app/6-agent-merge.md # docs/ko-kr/real-world-development/app/6-mcp-playwright.md # docs/ko-kr/real-world-development/app/7-canvases.md # docs/ko-kr/real-world-development/app/7-qa-agent.md # docs/ko-kr/real-world-development/app/8-create-pull-request.md # docs/ko-kr/real-world-development/app/9-canvases.md # docs/ko-kr/real-world-development/app/9-review.md # docs/pt-br/README.md # docs/pt-br/app/5-mcp-playwright.md # docs/pt-br/real-world-development/app/10-review.md # docs/pt-br/real-world-development/app/2-add-star-rating.md # docs/pt-br/real-world-development/app/3-agent-modes.md # docs/pt-br/real-world-development/app/3-custom-instructions.md # docs/pt-br/real-world-development/app/4-build-filtering.md # docs/pt-br/real-world-development/app/4-custom-instructions.md # docs/pt-br/real-world-development/app/5-agent-skills.md # docs/pt-br/real-world-development/app/5-mcp-playwright.md # docs/pt-br/real-world-development/app/6-agent-merge.md # docs/pt-br/real-world-development/app/6-mcp-playwright.md # docs/pt-br/real-world-development/app/7-canvases.md # docs/pt-br/real-world-development/app/7-qa-agent.md # docs/pt-br/real-world-development/app/8-create-pull-request.md # docs/pt-br/real-world-development/app/9-canvases.md # docs/pt-br/real-world-development/app/9-review.md # docs/real-world-development/app/10-review.md # docs/real-world-development/app/2-add-star-rating.md # docs/real-world-development/app/3-agent-modes.md # docs/real-world-development/app/3-custom-instructions.md # docs/real-world-development/app/4-build-filtering.md # docs/real-world-development/app/4-custom-instructions.md # docs/real-world-development/app/5-agent-skills.md # docs/real-world-development/app/5-mcp-playwright.md # docs/real-world-development/app/6-agent-merge.md # docs/real-world-development/app/6-mcp-playwright.md # docs/real-world-development/app/7-canvases.md # docs/real-world-development/app/7-qa-agent.md # docs/real-world-development/app/8-create-pull-request.md # docs/real-world-development/app/9-canvases.md # docs/real-world-development/app/9-review.md # docs/zh-cn/README.md # docs/zh-cn/app/5-mcp-playwright.md # docs/zh-cn/real-world-development/app/10-review.md # docs/zh-cn/real-world-development/app/2-add-star-rating.md # docs/zh-cn/real-world-development/app/3-agent-modes.md # docs/zh-cn/real-world-development/app/3-custom-instructions.md # docs/zh-cn/real-world-development/app/4-build-filtering.md # docs/zh-cn/real-world-development/app/4-custom-instructions.md # docs/zh-cn/real-world-development/app/5-agent-skills.md # docs/zh-cn/real-world-development/app/5-mcp-playwright.md # docs/zh-cn/real-world-development/app/6-agent-merge.md # docs/zh-cn/real-world-development/app/6-mcp-playwright.md # docs/zh-cn/real-world-development/app/7-canvases.md # docs/zh-cn/real-world-development/app/7-qa-agent.md # docs/zh-cn/real-world-development/app/8-create-pull-request.md # docs/zh-cn/real-world-development/app/9-canvases.md # docs/zh-cn/real-world-development/app/9-review.md # website/astro.config.mjs
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Reuse the App scenarios and teaching approach while adapting interactions for Copilot CLI. Add the star-rating quick win, issue-driven filtering, customization, QA and Agent Merge sequence, followed by practical slash commands. Update navigation and preserve retired English routes while deferring CLI localization. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🔵 Needs a closer look
Two unresolved moderate findings remain regarding the authoring reference and Agent Merge timing.
Review effort: Lite
Findings: None
What changed in this PR
This pull request aligns the Copilot CLI workshop with the refreshed App learning flow while adding CLI-specific workflows and preserving compatibility routes.
Changes:
- Reworks lessons around ratings, filtering, customization, MCP, QA agents, Agent Merge, and slash commands.
- Updates navigation, cross-workshop references, localization content, and redirects.
- Corrects shared image paths and supporting configuration.
Review findings:
- Moderate (1 vote):
.github/instructions/instructions.instructions.mdis deleted whileAUTHORING.mdstill references it. - Moderate (1 vote):
docs/real-world-development/cli/8-create-pull-request.mdcan enable Agent Merge before generated changes are reviewed.
| File | Status |
|---|---|
website/src/pages/real-world-development/cli/9-review.astro |
Reviewed |
website/src/pages/real-world-development/cli/7-slash-commands.astro |
Reviewed |
website/src/pages/real-world-development/cli/6-custom-agents.astro |
Reviewed |
website/src/pages/real-world-development/cli/4-mcp.astro |
Reviewed |
website/src/pages/real-world-development/cli/3-generating-code.astro |
Reviewed |
website/src/pages/real-world-development/cli/2-custom-instructions.astro |
Reviewed |
README.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/README.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/7-foundry-toolkit/2-build-and-deploy.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/zh-cn/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/zh-cn/real-world-development/cli/README.md |
Reviewed |
docs/zh-cn/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/zh-cn/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/zh-cn/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/zh-cn/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/zh-cn/real-world-development/cli/7-slash-commands.md |
Reviewed |
docs/zh-cn/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/zh-cn/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/zh-cn/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/zh-cn/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/zh-cn/README.md |
Reviewed |
docs/zh-cn/app/README.md |
Reviewed |
docs/zh-cn/app/6-agent-merge.md |
Reviewed |
docs/real-world-development/vscode/README.md |
Reviewed |
docs/real-world-development/vscode/images/.gitkeep |
Reviewed |
docs/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/real-world-development/vscode/7-foundry-toolkit/2-build-and-deploy.md |
Reviewed |
docs/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/real-world-development/vscode/5-managing-agents.md |
Reviewed |
docs/real-world-development/vscode/4-custom-agents.md |
Reviewed |
docs/real-world-development/vscode/3-mcp.md |
Reviewed |
docs/real-world-development/vscode/2-agent-mode.md |
Reviewed |
docs/real-world-development/vscode/1-custom-instructions.md |
Reviewed |
docs/real-world-development/vscode/0-prerequisites.md |
Reviewed |
docs/real-world-development/README.md |
Reviewed |
docs/real-world-development/cloud/README.md |
Reviewed |
docs/real-world-development/cloud/images/.gitkeep |
Reviewed |
docs/real-world-development/cloud/4-managing-agents.md |
Reviewed |
docs/real-world-development/cloud/3-custom-agents.md |
Reviewed |
docs/real-world-development/cloud/2-cloud-agent.md |
Reviewed |
docs/real-world-development/cloud/0-prerequisites.md |
Reviewed |
docs/real-world-development/cli/images/.gitkeep |
Reviewed |
docs/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/real-world-development/app/8-create-pull-request.md |
Reviewed |
docs/README.md |
Reviewed |
docs/pt-br/real-world-development/vscode/README.md |
Reviewed |
docs/pt-br/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/pt-br/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/pt-br/real-world-development/vscode/7-foundry-toolkit/2-build-and-deploy.md |
Reviewed |
docs/pt-br/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/pt-br/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/pt-br/real-world-development/cli/README.md |
Reviewed |
docs/pt-br/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/pt-br/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/pt-br/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/pt-br/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/pt-br/real-world-development/cli/7-slash-commands.md |
Reviewed |
docs/pt-br/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/pt-br/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/pt-br/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/pt-br/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/README.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/2-build-and-deploy.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/ko-kr/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/ko-kr/real-world-development/cli/README.md |
Reviewed |
docs/ko-kr/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/ko-kr/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/ko-kr/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/ko-kr/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/ko-kr/real-world-development/cli/7-slash-commands.md |
Reviewed |
docs/ko-kr/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/ko-kr/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/ko-kr/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/ko-kr/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/ja-jp/real-world-development/vscode/README.md |
Reviewed |
docs/ja-jp/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/ja-jp/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/ja-jp/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/ja-jp/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/ja-jp/real-world-development/cli/README.md |
Reviewed |
docs/ja-jp/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/ja-jp/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/ja-jp/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/ja-jp/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/ja-jp/real-world-development/cli/7-slash-commands.md |
Reviewed |
docs/ja-jp/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/ja-jp/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/ja-jp/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/ja-jp/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/first-steps/README.md |
Reviewed |
docs/first-steps/copilot-app/README.md |
Reviewed |
docs/first-steps/copilot-app/8-review.md |
Reviewed |
docs/first-steps/copilot-app/7-canvas.md |
Reviewed |
docs/first-steps/copilot-app/6-automations.md |
Reviewed |
docs/first-steps/copilot-app/5-review.md |
Reviewed |
docs/first-steps/copilot-app/4-issues-and-sessions.md |
Reviewed |
docs/first-steps/copilot-app/3-publish.md |
Reviewed |
docs/first-steps/copilot-app/2-build-and-polish.md |
Reviewed |
docs/first-steps/copilot-app/1-create-workspace.md |
Reviewed |
docs/first-steps/copilot-app/0-prerequisites.md |
Reviewed |
docs/es-es/real-world-development/vscode/README.md |
Reviewed |
docs/es-es/real-world-development/vscode/7-foundry-toolkit/README.md |
Reviewed |
docs/es-es/real-world-development/vscode/7-foundry-toolkit/3-connect-to-site.md |
Reviewed |
docs/es-es/real-world-development/vscode/7-foundry-toolkit/2-build-and-deploy.md |
Reviewed |
docs/es-es/real-world-development/vscode/7-foundry-toolkit/1-project-and-model.md |
Reviewed |
docs/es-es/real-world-development/vscode/6-iterating.md |
Reviewed |
docs/es-es/real-world-development/cli/README.md |
Reviewed |
docs/es-es/real-world-development/cli/8-foundry-agent/README.md |
Reviewed |
docs/es-es/real-world-development/cli/8-foundry-agent/3-connect-to-site.md |
Reviewed |
docs/es-es/real-world-development/cli/8-foundry-agent/2-build-and-deploy.md |
Reviewed |
docs/es-es/real-world-development/cli/8-foundry-agent/1-project-and-model.md |
Reviewed |
docs/es-es/real-world-development/cli/7-slash-commands.md |
Reviewed |
docs/es-es/real-world-development/cli/0-prerequisites.md |
Reviewed |
docs/es-es/real-world-development/app/8-foundry-canvas/README.md |
Reviewed |
docs/es-es/real-world-development/app/8-foundry-canvas/3-connect-to-site.md |
Reviewed |
docs/es-es/real-world-development/app/8-foundry-canvas/2-build-and-deploy.md |
Reviewed |
docs/cli/README.md |
Reviewed |
docs/cli/9-review.md |
Reviewed |
docs/cli/0-prerequisites.md |
Reviewed |
docs/app/README.md |
Reviewed |
docs/app/6-agent-merge.md |
Reviewed |
.vscode/settings.json |
Reviewed |
.github/workflows/content-alignment.md |
Reviewed |
.github/skills/validate-site-playwright/SKILL.md |
Reviewed |
.github/instructions/markdown.instructions.md |
Reviewed |
.github/instructions/instructions.instructions.md |
Reviewed; moderate finding (1 vote) |
.github/instructions/astro.instructions.md |
Reviewed |
.github/copilot-instructions.md |
Reviewed |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The CLI real-world workshop should teach the same continuous story as the refreshed App workshop, rather than introduce different scenarios or a checklist-heavy approach. This adapts the App's prose, scenarios, and teaching flow while changing the interactions needed for Copilot CLI.
Type of change
website/Astro + Starlight wrapper).github/copilot-instructions.md, instructions, agents, skills)Verification
The existing verification wrapper passed after the final edits, including Pagefind and offline link validation. Shared scenarios in CLI lessons 2-8 match their App counterparts verbatim. Changed English routes, compatibility redirects, retained translated pages, and expected English fallbacks were inspected. No fresh Codespaces-to-PR walkthrough or visual browser validation was performed.
Screenshots
N/A - lesson content, navigation, and compatibility redirects; no visual redesign.
Notes for reviewers
Depends on #186; merge that first. This branch was based on its head (
cf162f6), and #186 is still open. The comparison againstmaintherefore currently includes that earlier App/localization/category work. The CLI-specific change is commit0cedefaand touches 32 files.The CLI refresh itself leaves App lessons and all locale source trees unchanged. CLI localization is intentionally deferred: existing translations retain the older flow, while new untranslated destinations use English fallback. This is source/route verification, not a claim that those translations match the refreshed English flow.
CLI-specific differences include ordinary feature branches, restart/resume steps for instruction and agent changes, headless Playwright MCP setup, and commands for PR creation and Agent Merge. The workshop retains the agreed Codespaces
--yoloshortcut without promising subsequent tool-approval prompts. Null-rating behavior is checked through tests because seeded games all have numeric ratings.