Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion workshop/01-prerequisites.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion workshop/02a-setup-codespace.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion workshop/02c-setup-browser.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
3 changes: 1 addition & 2 deletions workshop/05-agentic-workflows-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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 -->

4 changes: 2 additions & 2 deletions workshop/06-install-gh-aw.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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 -->
46 changes: 46 additions & 0 deletions workshop/06c-install-ui.md
Original file line number Diff line number Diff line change
@@ -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 -->
14 changes: 6 additions & 8 deletions workshop/07c-your-first-workflow-copilot.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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"
Expand All @@ -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.
Expand All @@ -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`
Expand All @@ -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 -->


Loading