Skip to content

Clarify two-file structure in create/update workflow prompts#12121

Merged
pelikhan merged 3 commits intomainfrom
copilot/update-agentic-workflows-prompts
Jan 27, 2026
Merged

Clarify two-file structure in create/update workflow prompts#12121
pelikhan merged 3 commits intomainfrom
copilot/update-agentic-workflows-prompts

Conversation

Copy link
Contributor

Copilot AI commented Jan 27, 2026

The create and update workflow prompts lacked explicit guidance on the two-file architecture that separates prompt content (editable without recompilation) from configuration (requires recompilation).

Changes

Both prompt files now lead with:

  • Two-file structure overview with clear separation of concerns
  • Decision tree: prompt/behavior changes → agentics/*.md, configuration → workflows/*.md
  • Recompilation requirements explicitly stated for each type of change

create-agentic-workflow.md:

  • Restructured Step 3 into substeps (3.1-3.3) for each file creation
  • Added complete examples showing runtime-import pattern
  • Updated PR description template to explain file separation

update-agentic-workflow.md:

  • Split update patterns into configuration vs. prompt sections
  • Each pattern explicitly states target file and recompilation status
  • Enhanced "Prompt Editing Without Recompilation" with file structure diagram

Pattern

.github/
├── agentics/
│   └── workflow-id.md          # Agent prompt - edit without recompile
└── workflows/
    └── workflow-id.md          # Frontmatter + {{#runtime-import agentics/workflow-id.md}}

Agents now consistently create this structure and understand when recompilation is required.

Original prompt

Review the create and update agentic workflows .md prompt file and make sure:

  • if a change has to be made in the markdown BODY, it should be made in the runtime-import agentics/*.md file.
  • if a change has to be made in the front matter, it should be made in the workflows/*.md agentic workflow file

Always try to edit the agentics/*.md file for prompt updates. The reason is that this allows the user to change the agentic workflow behavior without recompilation.

This task is about editing the prompt files in the .github/aw folder. The goal is not to turn these files into an agentic-workflow. Instead, update the prompts in these files so that when they are used by an agent, the agent creates the correct file structure.


💬 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 27, 2026 22:05
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 prompts for agentic workflows in markdown files Clarify two-file structure in create/update workflow prompts Jan 27, 2026
Copilot AI requested a review from pelikhan January 27, 2026 22:12
@pelikhan
Copy link
Contributor

@copilot merge main and recompile

@pelikhan pelikhan marked this pull request as ready for review January 27, 2026 22:19
@pelikhan pelikhan merged commit d95e9a1 into main Jan 27, 2026
1 check failed
@pelikhan pelikhan deleted the copilot/update-agentic-workflows-prompts branch January 27, 2026 22:20
Copilot AI requested a review from pelikhan January 27, 2026 22:20
Copilot stopped work on behalf of pelikhan due to an error January 27, 2026 22:20
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