Fix broken workshop links and restore the missing browser-path Step 6c page (#1842)

Copilot · pelikhan · web-flow · commit 8c106e6d763e · 2026-07-22T04:35:47.000-07:00
* Initial plan

* Fix workshop broken links

Co-authored-by: pelikhan &lt;4175913+pelikhan@users.noreply.github.com&gt;

* Clarify browser-path initialization flow

Co-authored-by: pelikhan &lt;4175913+pelikhan@users.noreply.github.com&gt;

* Remove premature skill usage from browser init step

Co-authored-by: pelikhan &lt;4175913+pelikhan@users.noreply.github.com&gt;

---------

Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: pelikhan &lt;4175913+pelikhan@users.noreply.github.com&gt;
Co-authored-by: Peli de Halleux &lt;pelikhan@users.noreply.github.com&gt;
diff --git a/workshop/01-prerequisites.md b/workshop/01-prerequisites.md
@@ -10,7 +10,7 @@ In this step, you confirm your account and tool prerequisites, then choose your
 
 ## Confirm account access
 
-Sign in at [github.com](https://github.com). If you do not have an account yet, create one at [github.com/signup](https://github.com/signup).
+Sign in at [github.com](https://github.com). If you do not have an account yet, use the **Sign up** option there first.
 
 ## Choose your development environment
 
diff --git a/workshop/02a-setup-codespace.md b/workshop/02a-setup-codespace.md
@@ -43,7 +43,7 @@ Codespaces auto-save your work. If you close the tab, open [github.com/codespace
 <details>
 <summary>Codespace not appearing or taking too long?</summary>
 
-- **"Create codespace on main" is greyed out** — your account may not have Codespaces enabled. Check [github.com/settings/billing](https://github.com/settings/billing) or ask your organization admin.
+- **"Create codespace on main" is greyed out** — your account may not have Codespaces enabled. Check your GitHub plan details or ask your organization admin.
 - **Spinner runs more than 3 minutes** — refresh the browser tab. If still stuck, go to [github.com/codespaces](https://github.com/codespaces), find the pending Codespace, click **⋯ → Delete**, and try again.
 - **"Codespace storage limit reached"** — you may have existing Codespaces using your quota. Visit [github.com/codespaces](https://github.com/codespaces), delete any you no longer need, and retry.
 - **VS Code desktop opens instead of the browser** — click **Open in Browser** in the dialog, or close VS Code desktop and return to the browser tab.
diff --git a/workshop/02c-setup-browser.md b/workshop/02c-setup-browser.md
@@ -28,7 +28,7 @@ You'll create your practice repository on github.com. No terminal, no local inst
 You now have a practice repository. Keep this tab open — you will use it throughout the workshop.
 
 > [!NOTE]
-> The browser path skips the `gh` CLI installation (Steps 6a–6b). When the workshop reaches [Install the gh-aw CLI Extension](06-install-gh-aw.md), your path automatically continues to [Write Your First Agentic Workflow](07-your-first-workflow.md) — no terminal installation is needed.
+> The browser path skips the `gh` CLI installation (Steps 6a–6b). When the workshop reaches [Install the gh-aw CLI Extension](06-install-gh-aw.md), your path automatically continues to [No Installation Needed — GitHub UI Path](06c-install-ui.md).
 
 ## ✅ Checkpoint
 
diff --git a/workshop/05-agentic-workflows-intro.md b/workshop/05-agentic-workflows-intro.md
@@ -106,7 +106,7 @@ as an issue with the title "Weekly PR Digest".
 - [ ] My brief specifies what the agent should post when done
 
 > [!TIP]
-> Struggling to think of a task? Browse the [gh-aw patterns](https://github.github.com/gh-aw/patterns/) for inspiration. You will write a real version of your brief in Step 7.
+> Struggling to think of a task? Browse the [gh-aw issue-ops pattern](https://github.github.com/gh-aw/patterns/issue-ops/) for inspiration. You will write a real version of your brief in Step 7.
 
 ## ✅ Checkpoint
 
@@ -118,4 +118,3 @@ as an issue with the title "Weekly PR Digest".
 <!-- journey: all -->
 **Next:** [Install the gh-aw CLI Extension](06-install-gh-aw.md)
 <!-- /journey -->
-
diff --git a/workshop/06-install-gh-aw.md b/workshop/06-install-gh-aw.md
@@ -8,7 +8,7 @@
 ## 📋 Before You Start
 
 - You have completed [Agentic Workflows Intro](05-agentic-workflows-intro.md)
-- Your development environment is ready (Codespace or local terminal)
+- Your development environment is ready (Codespace, local terminal, or browser path)
 
 ## Choose Your Path
 
@@ -23,5 +23,5 @@ The diagram below shows how the three paths diverge and then rejoin at Step 7.
 **Next:** [Install gh-aw — Local Terminal](06b-install-local.md)
 <!-- /journey -->
 <!-- journey: ui,copilot -->
-**Next:** [Write Your First Agentic Workflow](07-your-first-workflow.md) — no installation needed on the browser path.
+**Next:** [No Installation Needed — GitHub UI Path](06c-install-ui.md)
 <!-- /journey -->
diff --git a/workshop/06c-install-ui.md b/workshop/06c-install-ui.md
@@ -0,0 +1,46 @@
+<!-- page-journey: ui -->
+<!-- page-adventure: setup -->
+# No Installation Needed — GitHub UI Path
+
+## 🎯 What You'll Do
+
+You'll use GitHub Copilot to initialize your repository for GitHub Agentic Workflows, review the pull request it opens, and continue to workflow authoring with no local installation required.
+
+If you decide you want a terminal after all, switch to [Install gh-aw — Codespace Terminal](06a-install-terminal.md) or [Install gh-aw — Local Terminal](06b-install-local.md).
+
+## How this path works
+
+On the GitHub UI path, you do not install `gh-aw` locally. You stay on github.com, ask GitHub Copilot to initialize the repository for agentic workflows, and let GitHub-hosted automation handle compilation and execution.
+
+![GitHub-hosted execution flow for the UI path](images/06c-github-hosted-execution.svg)
+
+In practice, that means:
+
+- You write or review workflow changes in the GitHub web UI.
+- An agent initializes the repository files for you in a pull request.
+- GitHub Actions runs the committed lock file on GitHub's infrastructure.
+
+## Initialize the repository
+
+Open your practice repository in the GitHub Copilot app and start a session in **Interactive** mode, or open the repository's **Copilot** or **Agents** tab and start a new session.
+
+**Paste this prompt:**
+
+```text
+Initialize this repository for GitHub Agentic Workflows using https://raw.githubusercontent.com/github/gh-aw/main/install.md
+
+Run the setup in the session workspace, commit the initialized repository files, and open a pull request. Show me the diff before merging.
+```
+
+Review the pull request and confirm it adds the initialization files you need for the browser path, such as `.github/skills/agentic-workflows/`, `.github/mcp.json`, and `.github/workflows/copilot-setup-steps.yml`. Then merge it into `main`.
+
+## ✅ Checkpoint
+
+- [ ] You understand that the browser path does not require a local `gh-aw` install
+- [ ] `.github/skills/agentic-workflows/` exists in your repository
+- [ ] You know you can stay on github.com for the rest of this path
+- [ ] You are ready to create your first workflow with GitHub Copilot
+
+<!-- journey: ui -->
+**Next:** [Write Your First Agentic Workflow — GitHub Copilot Path](07c-your-first-workflow-copilot.md)
+<!-- /journey -->
diff --git a/workshop/07c-your-first-workflow-copilot.md b/workshop/07c-your-first-workflow-copilot.md
@@ -12,6 +12,7 @@ You'll ask an agent in the [GitHub Copilot app](side-quest-01-02-environment-ref
 
 - Your practice repository is connected to the GitHub Copilot app or available in the Agents tab
 - You have an active GitHub Copilot plan
+- You completed [No Installation Needed — GitHub UI Path](06c-install-ui.md) and merged the repository-initialization pull request
 
 ## Start a session
 
@@ -23,8 +24,7 @@ Open your practice repository in the GitHub Copilot app and start a session in *
 **GitHub Copilot app — paste this prompt:**
 
 ```text
-Using the agentic-workflows skill, initialize this repository for GitHub Agentic Workflows using https://raw.githubusercontent.com/github/gh-aw/main/install.md
-and then create a workflow using https://raw.githubusercontent.com/github/gh-aw/main/create.md
+Using the agentic-workflows skill, create a workflow using https://raw.githubusercontent.com/github/gh-aw/main/create.md
 
 The workflow must:
 - Be named "Daily Report Status"
@@ -35,17 +35,17 @@ The workflow must:
   "This issue has the most community support! We'll prioritise it in our next planning session."
 - Create an issue titled "Community Voting Test" and post the same comment if no open issues exist
 
-Run `gh aw compile` in the session workspace, fix any errors, commit the source and generated lock file (plus any initialized skill files), and open a pull request. Show me the diff before merging.
+Run `gh aw compile` in the session workspace, fix any errors, commit the source and generated lock file, and open a pull request. Show me the diff before merging.
 ```
 
 **Agents tab — paste this prompt instead:**
 
 ```text
-/agentic-workflows Follow the prompt above to initialize this repository and create the Daily Report Status workflow.
+/agentic-workflows Follow the prompt above to create the Daily Report Status workflow.
 ```
 
 > [!NOTE]
-> The `agentic-workflows` skill is installed as part of initialization. If the skill is not yet available in your repository, the agent falls back to the install and create URLs above and the skill becomes available for future sessions after the pull request is merged.
+> The `agentic-workflows` skill is installed during [Step 6c](06c-install-ui.md). If it is not yet available in your repository, return to that step and merge the initialization pull request first.
 
 The agent runs validation in its isolated session workspace. You do not need a terminal for this path.
 Before you approve the merge, the agent presents the file changes in its session response for you to review.
@@ -63,7 +63,7 @@ Before you approve the merge, the agent presents the file changes in its session
 ## ✅ Checkpoint
 
 - [ ] `.github/workflows/daily-report-status.md` exists in the repository
-- [ ] `.github/skills/agentic-workflows/` exists in the repository from `gh aw init`
+- [ ] `.github/skills/agentic-workflows/` exists in the repository from the initialization step
 - [ ] The agent validated the workflow in its session workspace
 - [ ] You reviewed the source and generated lock file
 - [ ] You merged the pull request into `main`
@@ -72,5 +72,3 @@ Before you approve the merge, the agent presents the file changes in its session
 <!-- journey: copilot -->
 **Next:** [Confirm Model Access](07d-confirm-model-access.md)
 <!-- /journey -->
-
-
