Skip to content

refactor: move agentic-workflow-designer skill to static instruction file#44658

Merged
pelikhan merged 4 commits into
mainfrom
copilot/refactor-agentic-workflows-design
Jul 10, 2026
Merged

refactor: move agentic-workflow-designer skill to static instruction file#44658
pelikhan merged 4 commits into
mainfrom
copilot/refactor-agentic-workflows-design

Conversation

Copilot AI commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

The agentic-workflow-designer was a separate skill written to every user repo by gh aw init, requiring an embedded Go template and sync logic to keep it up-to-date. The agentic-workflows dispatcher SKILL.md was larger than necessary, embedding designer routing alongside the file list.

Changes

New instruction file

  • .github/skills/agentic-workflows/designer.md — designer interview framework as a plain markdown instruction file (no skill frontmatter), served from github/gh-aw and loaded by the dispatcher on demand

Dispatcher minimized

  • pkg/cli/data/agentic_workflows_skill.md + checked-in SKILL.md — reference changed from skills/agentic-workflow-designer/SKILL.md.github/skills/agentic-workflows/designer.md

init no longer writes the designer skill

  • pkg/cli/copilot_agents.go — removed ensureAgenticWorkflowDesignerSkill, removed //go:embed data/agentic_workflow_designer_skill.md; added deleteAgenticWorkflowDesignerSkillDir to clean up legacy installations on next init
  • pkg/cli/init.go — removed designer write call; added cleanup call
  • pkg/cli/data/agentic_workflow_designer_skill.md — deleted

Deleted

  • .github/skills/agentic-workflow-designer/SKILL.md and directory — replaced by designer.md

Drift audit updated

  • .github/workflows/designer-drift-audit.md — path updated to .github/skills/agentic-workflows/designer.md; recompiled

… agentic-workflows

- Create .github/skills/agentic-workflows/designer.md as a loadable
  instruction file (without skill frontmatter)
- Update agentic-workflows dispatcher to reference the new designer path
  (.github/skills/agentic-workflows/designer.md) instead of the old
  standalone skill (.github/skills/agentic-workflow-designer/SKILL.md)
- Remove ensureAgenticWorkflowDesignerSkill from copilot_agents.go and
  the embedded agentic_workflow_designer_skill.md data file
- Add deleteAgenticWorkflowDesignerSkillDir to clean up legacy
  installations when users run gh aw init
- Remove designer skill generation from init.go; add cleanup call
- Update init_command.go long description
- Update designer-drift-audit.md to reference new path and recompile
- Update tests accordingly

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title refactor: move agentic-workflow-designer skill to instruction file in agentic-workflows refactor: move agentic-workflow-designer skill to static instruction file Jul 10, 2026
Copilot AI requested a review from pelikhan July 10, 2026 05:34
@pelikhan

Copy link
Copy Markdown
Collaborator

@copilot move designer.md to .github/aw/designer.md

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

Copilot AI commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

@copilot move designer.md to .github/aw/designer.md

Done. Moved designer.md to .github/aw/designer.md and updated all references. Since it's now part of the .github/aw/ directory, it's automatically included in the sorted file list in the skill template (removed the hardcoded separate entry), added to the fallback JSON, and regenerated the checked-in SKILL.md.

@pelikhan pelikhan marked this pull request as ready for review July 10, 2026 06:40
Copilot AI review requested due to automatic review settings July 10, 2026 06:40
@pelikhan

Copy link
Copy Markdown
Collaborator

@copilot merge main and recompile

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR refactors the “workflow designer” content from a separately-installed Copilot skill into a plain markdown instruction file that the agentic-workflows dispatcher can load on demand, reducing init-time templating/sync complexity and removing legacy artifacts.

Changes:

  • Stop writing the legacy agentic-workflow-designer skill during gh aw init, and add cleanup to remove existing legacy installs.
  • Update dispatcher skill content (template + checked-in SKILL.md) to route “design” requests to the new designer instruction file.
  • Update drift-audit workflow to track the new designer file path, and update tests accordingly.
Show a summary per file
File Description
pkg/cli/init.go Removes designer-skill creation during init; adds legacy directory cleanup call.
pkg/cli/init_command.go Updates init help text to no longer claim the designer skill is created.
pkg/cli/init_command_test.go Updates init help-text and filesystem assertions to match the new artifact set.
pkg/cli/data/agentic_workflows_skill.md Updates dispatcher template routing to point at the new designer instruction file path.
pkg/cli/data/agentic_workflows_fallback_aw_files.json Adds designer.md to the embedded fallback allowlist for upstream aw files.
pkg/cli/data/agentic_workflow_designer_skill.md Deletes the embedded designer skill template (no longer written to user repos).
pkg/cli/copilot_agents.go Removes designer-skill embed + write logic; adds legacy directory removal helper.
pkg/cli/copilot_agents_test.go Updates assertions to expect routing to .github/aw/designer.md and drops template-sync test.
.github/workflows/designer-drift-audit.md Updates drift audit to inspect .github/aw/designer.md instead of the removed skill file.
.github/workflows/designer-drift-audit.lock.yml Recompiled lock output reflecting the drift audit path change.
.github/skills/agentic-workflows/SKILL.md Updates dispatcher file list and routing to include .github/aw/designer.md.
.github/aw/designer.md Removes skill frontmatter and adjusts content for the new “instruction file” usage.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comments suppressed due to low confidence (1)

.github/aw/designer.md:9

  • This file now lives at .github/aw/designer.md, but the instructions still reference .github/skills/agentic-workflows/designer.md (which doesn’t exist in the repo). This creates a broken/self-contradictory reference for users following the designer flow.
  • Files reviewed: 12/12 changed files
  • Comments generated: 2
  • Review effort level: Low

SKILL=".github/aw/designer.md"
if [ -f "$SKILL" ]; then
{
echo "=== SKILL.md ==="
Comment on lines 74 to 76
After loading the matching workflow prompt or skill, follow it directly:
- Design workflows from scratch via interview: `skills/agentic-workflow-designer/SKILL.md`
- Design workflows from scratch via interview: `.github/aw/designer.md`
- Create new workflows: `.github/aw/create-agentic-workflow.md`
Copilot AI and others added 2 commits July 10, 2026 06:50
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
…tic-workflows-design

# Conflicts:
#	.github/workflows/designer-drift-audit.lock.yml

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

Copilot AI commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

@copilot merge main and recompile

Addressed in 3146d7a — merged main, resolved the generated lockfile conflict, and recompiled the affected artifacts.

@pelikhan pelikhan merged commit a8b0d7d into main Jul 10, 2026
@pelikhan pelikhan deleted the copilot/refactor-agentic-workflows-design branch July 10, 2026 07:03
@github-actions

Copy link
Copy Markdown
Contributor

🎉 This pull request is included in a new release.

Release: v0.82.8

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.

3 participants