Skip to content

Commit ecf66d2

Browse files
author
UncleBats
committed
update 8
1 parent 687e822 commit ecf66d2

1 file changed

Lines changed: 55 additions & 44 deletions

File tree

docs/workshop/participant-handout.md

Lines changed: 55 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -2179,74 +2179,85 @@ Now that you have well-structured sub-issues, you can let Copilot implement them
21792179

21802180
---
21812181

2182-
### Exercise 8: Implementation Workflow
2182+
### Exercise 8: Explore on Your Own
21832183

2184-
**Use VS Code Copilot Chat with repository agent:**
2184+
You now have all the skills to create, install, and manage agentic workflows. Use the remaining time to try one (or more!) of the following challenges. Pick whatever interests you — there are no step-by-step instructions this time.
21852185

2186-
1. Type `/agents` and select agentic-workflows agent
2187-
2. Use this prompt:
2186+
---
21882187

2189-
```
2190-
create a workflow that triggers when someone comments "/implement" on an issue. The workflow should:
2188+
**🔄 Challenge A: Keep Your Workflows Up to Date**
21912189

2192-
1. Read the issue description and any plans
2193-
2. Create a new branch for the feature
2194-
3. Implement the first task in the plan
2195-
4. Run tests to verify it works
2196-
5. Create a draft pull request
2197-
6. Comment back on the original issue with progress
2190+
Your installed workflows have a `source:` reference in their frontmatter that pins them to a specific commit. Open one of your compiled workflows and look for it:
21982191

2199-
This enables iterative development triggered by humans.
2192+
```yaml
2193+
source: githubnext/agentics/workflows/issue-triage.md@b0e9cfd3a20372ce7fe0462bb7bbca2272df4a88
22002194
```
22012195

2202-
**Then test it:**
2196+
This is like a dependency version — it can go stale. Build a workflow (or use the repository agent) that:
2197+
- Runs weekly
2198+
- Checks each workflow's `source:` reference against the latest version in the remote repository
2199+
- Opens a PR to update outdated workflows
22032200

2204-
- Comment `/implement` on the Ruby issue
2205-
- Watch the workflow create a branch and start implementation
2201+
Think of it as **Dependabot for your agentic workflows**. Hints: you can use `gh aw add` to re-install a workflow and it will update to the latest version. Diff the before/after to generate a changelog.
22062202

22072203
---
22082204

2209-
### Exercise 9: Reuse Workflows
2205+
**📊 Challenge B: Re-run Your Daily Report**
22102206

2211-
```bash
2212-
# Add a workflow from the community library
2213-
gh aw add githubnext/agentics/continuous-documentation-updates
2207+
Remember Exercise 1? Your daily-report workflow has been quietly collecting data. Trigger it again now:
22142208

2215-
# Review what was added
2216-
cat .github/workflows/continuous-documentation-updates.yml
2209+
1. Go to **Actions** → **daily-report** → **Run workflow**
2210+
2. Compare this report to the first one you generated
22172211

2218-
# Commit
2219-
git add .github/workflows/continuous-documentation-updates.yml
2220-
git commit -m "Add continuous documentation updates"
2221-
git push
2222-
```
2212+
With all the PRs you've merged, issues you've created, and workflows you've added, the report should be **much more interesting** now. It demonstrates how visibility workflows become more valuable over time as repository activity grows.
22232213

22242214
---
22252215

2226-
### Exercise 10: Workflow Maintenance
2216+
**📦 Challenge C: Browse and Install Community Workflows**
22272217

2228-
**Use VS Code Copilot Chat with repository agent:**
2218+
Explore the community workflow libraries and install something that catches your eye:
22292219

2230-
1. Type `/agents` and select agentic-workflows agent
2231-
2. Use this prompt:
2220+
- **https://github.com/githubnext/agentics/** — Curated, production-ready workflows
2221+
- **https://github.com/github/awesome-copilot** — Community contributions
22322222

2223+
```bash
2224+
# Browse what's available
2225+
# Pick a workflow and install it
2226+
gh aw add githubnext/agentics/<workflow-name>
22332227
```
2234-
create a workflow called "agentics-maintenance" that:
22352228

2236-
1. Runs weekly
2237-
2. Checks if any workflows in our repository were imported from githubnext/agentics
2238-
3. Compares our versions to the latest versions in the remote repository
2239-
4. If updates are available:
2240-
- Creates a branch
2241-
- Updates the workflows
2242-
- Runs tests to ensure compatibility
2243-
- Creates a PR with changelog of what changed
2244-
5. Labels PR as "dependencies" and "workflows"
2229+
Some ideas: `continuous-documentation-updates`, `stale-bot`, or any workflow that solves a problem you've seen on your own projects.
22452230

2246-
This keeps our imported workflows up to date automatically.
2247-
```
2231+
---
2232+
2233+
**🤖 Challenge D: Assign a Sub-Issue to Copilot**
2234+
2235+
In Exercise 7, the `/plan` command created sub-issues for the Ruby adventure. Pick one and let Copilot implement it:
2236+
2237+
1. Open a sub-issue on GitHub
2238+
2. Comment: `@copilot implement this`
2239+
3. Watch Copilot create a branch, write code, and open a PR
2240+
2241+
This closes the full automation loop: **triage → plan → implement → review**.
2242+
2243+
---
2244+
2245+
**🛠️ Challenge E: Build Your Own Workflow from Scratch**
2246+
2247+
Use any method (CLI, cloud agent, repository agent, or manual) to create a workflow that solves a real problem you've encountered. Some inspiration:
2248+
2249+
- A `/implement` command that reads an issue and creates a draft PR with an implementation
2250+
- A workflow that checks for stale branches and opens cleanup PRs
2251+
- A weekly summary of open issues grouped by label and priority
2252+
- A workflow that enforces PR conventions (title format, description template, required labels)
2253+
2254+
---
22482255

2249-
**Save and commit:** `.github/workflows/agentics-maintenance.yml`
2256+
> **💡 Tip:** Whatever you build, remember the patterns from the workshop:
2257+
> - Start with `safe-outputs` to keep human review in the loop
2258+
> - Use `protected-files: fallback-to-issue` for critical files
2259+
> - Test on your workshop repository before bringing it to production
2260+
> - Check the community libraries first — someone may have already built it
22502261

22512262
---
22522263

0 commit comments

Comments
 (0)