Add Pelis Agent Factory documentation to create-agentic-workflow templates by Copilot · Pull Request #10495 · github/gh-aw

Copilot · 2026-01-17T21:21:30Z

Summary of Changes

Astro Configuration

Added customSets configuration to starlight-llms-txt plugin in docs/astro.config.mjs
Label: "create-agentic-workflows"
Configured to generate llms-create-agentic-workflows.txt from meet-the-workflows blog entries (blog/*meet-the-workflows*)
The generated file will be available at: https://githubnext.github.io/gh-aw/llms-create-agentic-workflows.txt

Template Updates

Added concise "Learning from Reference Materials" section to fetch the llms.txt file
Removed deprecated create-agentic-workflow.agent.md template file
Marked pkg/cli/templates/create-agentic-workflow.md as compiler-generated in .gitattributes

Files modified:

docs/astro.config.mjs - Added customSets for blog llms.txt generation
pkg/cli/templates/create-agentic-workflow.md
.github/aw/create-agentic-workflow.md
.gitattributes - Added entry for create-agentic-workflow.md
Deleted pkg/cli/templates/create-agentic-workflow.agent.md (deprecated)

Original prompt

Update the release of gh-aw's create-agentic-workflow agent markdown template to include knowledge from pelis agent factory blog series.

You can include the following in the template instruction:

Step 1.1: Crawl the Pelis Agent Factory Documentation Site
IMPORTANT: You must thoroughly crawl and read the Pelis Agent Factory documentation site to understand the common patterns and best practices for agentic workflows.

Start from the main blog post and explore ALL linked pages:

Start at: https://githubnext.github.io/gh-aw/blog/2026-01-12-welcome-to-pelis-agent-factory/
Use web-fetch to retrieve each page
Follow ALL internal links to other pages on the site
Read the documentation sections, guides, and examples
Pay special attention to:
Workflow patterns and templates
Best practices for agentic automation
Common use cases and implementations
Integration patterns with GitHub
Safe outputs and permissions models
Caching and state management
Step 1.2: Explore the Agentics Repository
Clone knowledge from the agentics repository to understand reference implementations:

Repository: https://github.com/githubnext/agentics
Use the GitHub tools to explore the repository structure
Read key workflow files and configurations
Understand the patterns used in that repository
Note any interesting automation patterns that could apply here

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

…teps to create-agentic-workflow templates Co-authored-by: Mossaka <5447827+Mossaka@users.noreply.github.com>

pelikhan · 2026-01-17T21:42:47Z

@copilot configure Astro llmstxt package to compile a llmstxt file for the blog entries and link to the generated url

…d update templates to use it Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-17T21:55:02Z

@copilot configure Astro llmstxt package to compile a llmstxt file for the blog entries and link to the generated url

Configured starlight-llms-txt with a custom set for the blog entries in docs/astro.config.mjs. The plugin will generate llms-pelis-agent-factory-blog-series.txt from all blog content (blog/**).

Updated the templates to reference the generated URL: https://githubnext.github.io/gh-aw/llms-pelis-agent-factory-blog-series.txt

Commit: c691f10

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:

delucis.github.io
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)

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

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

pelikhan · 2026-01-17T22:26:15Z

@copilot pkg/cli/templates/create-agentic-workflow.agent.md should not exist. it looks deprecated

pelikhan · 2026-01-17T22:27:10Z

+- Safe outputs and permissions models
+- Caching and state management
+
+**Alternative: Browse the blog directly:**


@copilot remove alternative section

Removed the alternative browsing section from both template files.

Commit: 2a6db0b

pelikhan · 2026-01-17T22:28:32Z

+					customSets: [
+						{
+							label: "Peli's Agent Factory Blog Series",
+							paths: ['blog/**'],


@copilot the file names have "meet-the-workflows" in the filename

Updated the paths to blog/**/meet-the-workflows* to specifically target the meet-the-workflows files.

Commit: 2a6db0b

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2026-01-17T22:31:17Z

@copilot pkg/cli/templates/create-agentic-workflow.agent.md should not exist. it looks deprecated

Removed the deprecated pkg/cli/templates/create-agentic-workflow.agent.md file.

Commit: 27d39d9

… meet-the-workflows files Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-01-17T22:50:39Z

+					],
+					customSets: [
+						{
+							label: "Peli's Agent Factory Blog Series",


@copilot rename label "create-agentic-workflows"

Renamed the label to "create-agentic-workflows" and updated the template URLs to use llms-create-agentic-workflows.txt.

Commit: c771334

…te URLs Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-01-17T23:05:14Z

+					customSets: [
+						{
+							label: "create-agentic-workflows",
+							paths: ['blog/**/meet-the-workflows*'],


@copilot double check that this path is correct

The blog files are directly in blog/ without subdirectories, so I updated the path from blog/**/meet-the-workflows* to blog/*meet-the-workflows*.

Commit: f314b3f

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-01-17T23:29:13Z

+- Safe outputs and permissions models
+- Caching and state management
+
+### Step 1.2: Explore the Agentics Repository


Remove this step. @copilot

Removed Step 1.2 (Explore Agentics Repository) from both template files and renamed "Step 1.1" to just "Read the Pelis Agent Factory Documentation".

Commit: 036361b

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2026-01-17T23:43:50Z

  - `gh aw compile --strict` → compile with strict mode validation (recommended for production)
  - `gh aw compile --purge` → remove stale lock files

+## Learning from Reference Materials


review updates and optimize them for agentic consumption. Shorter cleaner. @copilot

Optimized the section to be shorter and cleaner:

## Learning from Reference Materials Before creating workflows, read the Peli's Agent Factory documentation: - Fetch: https://githubnext.github.io/gh-aw/llms-create-agentic-workflows.txt This llms.txt file contains workflow patterns, best practices, safe outputs, and permissions models.

Commit: 1ddd26e

…ption Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Initial plan

037a293

Copilot AI assigned Copilot and Mossaka Jan 17, 2026

Copilot started work on behalf of Mossaka January 17, 2026 21:30 View session

Add Pelis Agent Factory documentation and agentics repo exploration s…

76881be

…teps to create-agentic-workflow templates Co-authored-by: Mossaka <5447827+Mossaka@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Update gh-aw agent markdown template with pelis blog insights~~ Add Pelis Agent Factory documentation crawl and agentics repo exploration to create-agentic-workflow templates Jan 17, 2026

Copilot AI requested a review from Mossaka January 17, 2026 21:47

Copilot finished work on behalf of Mossaka January 17, 2026 21:47

Copilot started work on behalf of pelikhan January 17, 2026 21:47 View session

Configure starlight-llms-txt to generate llms.txt for blog entries an…

c691f10

…d update templates to use it Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~Add Pelis Agent Factory documentation crawl and agentics repo exploration to create-agentic-workflow templates~~ Add Pelis Agent Factory documentation and agentics repo exploration to create-agentic-workflow templates Jan 17, 2026

Copilot AI requested a review from pelikhan January 17, 2026 21:56

Copilot finished work on behalf of pelikhan January 17, 2026 21:56

Copilot started work on behalf of pelikhan January 17, 2026 22:26 View session

pelikhan reviewed Jan 17, 2026

View reviewed changes

Remove deprecated create-agentic-workflow.agent.md template file

27d39d9

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan January 17, 2026 22:32

Copilot finished work on behalf of pelikhan January 17, 2026 22:32

Copilot started work on behalf of pelikhan January 17, 2026 22:33 View session

Remove alternative browsing section and update llms.txt path to match…

2a6db0b

… meet-the-workflows files Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan January 17, 2026 22:38

pelikhan reviewed Jan 17, 2026

View reviewed changes

Copilot started work on behalf of pelikhan January 17, 2026 22:51 View session

pelikhan reviewed Jan 17, 2026

View reviewed changes

Comment thread pkg/cli/templates/create-agentic-workflow.md

Rename customSets label to create-agentic-workflows and update templa…

c771334

…te URLs Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan January 17, 2026 22:55

Copilot finished work on behalf of pelikhan January 17, 2026 22:56

Copilot started work on behalf of pelikhan January 17, 2026 22:56 View session

Mark create-agentic-workflow.md as compiler-generated in .gitattributes

9364455

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan January 17, 2026 23:00

pelikhan reviewed Jan 17, 2026

View reviewed changes

Copilot started work on behalf of pelikhan January 17, 2026 23:05 View session

Fix llms.txt path to use blog/*meet-the-workflows* (no subdirectories)

f314b3f

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan January 17, 2026 23:10

Copilot AI requested a review from pelikhan January 17, 2026 23:10

pelikhan reviewed Jan 17, 2026

View reviewed changes

Copilot started work on behalf of pelikhan January 17, 2026 23:29 View session

Remove Step 1.2 (Explore Agentics Repository) from templates

036361b

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~Add Pelis Agent Factory documentation and agentics repo exploration to create-agentic-workflow templates~~ Add Pelis Agent Factory documentation to create-agentic-workflow templates Jan 17, 2026

Copilot AI requested a review from pelikhan January 17, 2026 23:35

Copilot finished work on behalf of pelikhan January 17, 2026 23:35

pelikhan reviewed Jan 17, 2026

View reviewed changes

Copilot started work on behalf of pelikhan January 17, 2026 23:44 View session

Optimize Learning from Reference Materials section for agentic consum…

1ddd26e

…ption Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan January 17, 2026 23:49

Copilot finished work on behalf of pelikhan January 17, 2026 23:49

pelikhan marked this pull request as ready for review January 18, 2026 00:16

pelikhan merged commit bfbea6b into main Jan 18, 2026
36 checks passed

pelikhan deleted the copilot/update-agent-workflow-template branch January 18, 2026 00:16

This was referenced Jan 18, 2026

Smoke Test: Claude - 21103555364 #10507

Closed

Add issue grouping support to create-issue safe-output #10497

Merged

Smoke Test: Copilot - 21103555360 #10509

Closed

Smoke Test: Claude - 21103800685 #10512

Closed

Uh oh!

Conversation

Copilot AI commented Jan 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary of Changes

Astro Configuration

Template Updates

Uh oh!

pelikhan commented Jan 17, 2026

Uh oh!

Copilot AI commented Jan 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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

Uh oh!

pelikhan commented Jan 17, 2026

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Jan 17, 2026

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

pelikhan Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Jan 17, 2026 •

edited

Loading

Copilot AI commented Jan 17, 2026 •

edited

Loading