Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 30, 2026

Documentation templates were instructing users to split workflows into two files: configuration in .github/workflows/ and prompts in .github/agentics/. This has been simplified to a single-file structure.

Changes

  • create-agentic-workflow.md: Removed "Two-File Structure" section and all references to .github/agentics/ directory
  • update-agentic-workflow.md: Removed separate file editing guidance and runtime-import references
  • Workflow structure: Now documented as single markdown file containing both YAML frontmatter (configuration) and markdown body (agent prompt)
  • Recompilation: All workflow changes now consistently require gh aw compile <workflow-id>

Before

### File 1: `.github/agentics/<workflow-id>.md` (Agent Prompt)
- Edit without recompilation
- Changes take effect immediately

### File 2: `.github/workflows/<workflow-id>.md` (Config + Import)
---
description: Example workflow
---
{{#runtime-import agentics/<workflow-id>.md}}

After

### File: `.github/workflows/<workflow-id>.md`
---
description: Example workflow
---

# Workflow Name

Complete agent prompt and instructions here...

Net reduction: 251 lines removed from documentation templates.

Original prompt

Update to the create-agentic-workflows.md and update-agentic-workflows.md documents.

Remove prompting to place the body of the markdown in a separate file .github/agentics/* and instead just use the current markdown file. Remove any prompting encouraging this behavior.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 2 commits January 30, 2026 00:36
…tion/update docs

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update create-agentic-workflows and update-agentic-workflows markdown Remove two-file workflow structure from documentation templates Jan 30, 2026
Copilot AI requested a review from pelikhan January 30, 2026 00:43
@pelikhan pelikhan marked this pull request as ready for review January 30, 2026 05:45
@pelikhan pelikhan merged commit b8dbb3c into main Jan 30, 2026
74 checks passed
@pelikhan pelikhan deleted the copilot/update-agentic-workflows-docs branch January 30, 2026 06:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants