Skip to content

Add portable agentic-workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, bake in token-efficient design defaults, include designer skill in init output, and add integration auth/GHE guidance#36748

Merged
lpcox merged 14 commits into
mainfrom
copilot/add-workflow-designer-md
Jun 4, 2026

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jun 3, 2026

This PR adds a new pre-authoring skill for users who know the automation goal but not the gh-aw primitives, updates routing so agents can consistently choose it when asked to design a workflow conversationally, incorporates token-efficiency defaults from the issue addendum, and ensures init writes the designer skill into user repositories. It complements existing prompts by sitting before workflow creation and producing a confirmed, generation-ready config.

  • New skill: .github/skills/agentic-workflow-designer/SKILL.md

    • Adds a self-contained, portable interview framework with 8 phases (goal → trigger → scope → data strategy → guardrails → context/network → engine → confirmation).
    • Includes decision heuristics mapping natural language to on:, safe-outputs:, network.allowed, tool choices, and DataOps-oriented steps:.
    • Enforces progressive-disclosure behavior (single-question flow, inference-based skips, smart defaults, ≤5 questions before summary, done-signal detection).
    • Defines structured confirmation format, generation template aligned to create-agentic-workflow.md, and pre-output validation self-check.
    • Integrates token-efficiency guidance:
      • DataOps-by-default prefetch strategy (gh + jq to compact JSON under /tmp/gh-aw/data/)
      • Minimal tool-surface guidance with scoped GitHub toolsets
      • Batch-processing guidance with sub-agent pattern
      • Prompt compactness guidance and explicit use of pre-fetched data paths
    • Adds integration and deployment guidance:
      • Explicitly asks about third-party services and MCP servers during design interviews
      • Requires identifying auth requirements and mapping them to GitHub Actions secrets and workflow env vars
      • Adds a standard “Integration auth setup” output section with least-privilege scope guidance
      • Adds GitHub.com vs GHEC/GHES deployment prompts and guidance (engine.api-target, GHES compatibility)
  • Router updates: skill dispatch now includes design-first path

    • Updates .github/skills/agentic-workflows/SKILL.md to:
      • explicitly include “design” in scope/description text
      • include .github/skills/agentic-workflow-designer/SKILL.md in loaded file list
      • route “design from scratch via interview” tasks to the new designer skill.
    • Mirrors the same routing change in pkg/cli/data/agentic_workflows_skill.md (template source).
  • Init integration for user repositories

    • Adds embedded designer-skill template source: pkg/cli/data/agentic_workflow_designer_skill.md.
    • Updates init flow to create/write .github/skills/agentic-workflow-designer/SKILL.md alongside the dispatcher skill.
    • Updates init command help text to document the additional generated skill file.
  • Fallback/source-of-truth alignment

    • Keeps dispatcher template rendering aligned with fallback AW file behavior while including the designer skill path in generated dispatcher content.
  • Targeted test coverage for dispatcher and init content

    • Extends pkg/cli/copilot_agents_test.go assertions to ensure:
      • generated dispatcher includes agentic-workflow-designer routing
      • generated content includes .github/skills/agentic-workflow-designer/SKILL.md
      • checked-in designer skill stays in sync with embedded template.
    • Extends pkg/cli/init_command_test.go assertions to ensure init/help behavior includes and writes the new designer skill file.

Example of the router mapping:

After loading the matching workflow prompt or skill, follow it directly:
- Design workflows from scratch via interview: `skills/agentic-workflow-designer/SKILL.md`
- Create new workflows: `.github/aw/create-agentic-workflow.md`


✨ PR Review Safe Output Test - Run 26921903213

> [!WARNING]
>

> 💥 THE END] — Illustrated by [Smoke Claude · opus48 5.5M ·

Copilot AI and others added 2 commits June 3, 2026 23:20
…outer

Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Copilot AI changed the title [WIP] Create .github/aw/workflow-designer.md for workflow design Add portable workflow-designer skill and route workflow-design requests through agentic-workflows dispatcher Jun 3, 2026
Copilot finished work on behalf of lpcox June 3, 2026 23:22
Copilot AI requested a review from lpcox June 3, 2026 23:22
@lpcox
Copy link
Copy Markdown
Collaborator

lpcox commented Jun 3, 2026

@copilot re-read the issue and integrate the new addendum about toke efficiency

Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
@lpcox lpcox marked this pull request as ready for review June 3, 2026 23:45
Copilot AI review requested due to automatic review settings June 3, 2026 23:45
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🧠 Matt Pocock Skills Reviewer has completed the skills-based review. ✅

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

Design Decision Gate 🏗️ completed the design decision gate check.

No ADR enforcement needed: PR #36748 does not have the 'implementation' label and has only 6 new lines of code in business logic directories (<=100 threshold). Both enforcement conditions are false.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

🧪 Test Quality Sentinel completed test quality analysis.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 3, 2026

⚠️ PR Code Quality Reviewer failed during code quality review.

Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
@github-actions github-actions Bot mentioned this pull request Jun 3, 2026
Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jun 3, 2026

@copilot re-read the issue and integrate the new addendum about toke efficiency

Addressed in 9be2197.

I re-read issue #36746 and integrated the token-efficiency addendum into .github/aw/workflow-designer.md (Data Strategy phase, DataOps/token-efficiency defaults, data-strategy heuristic table, expanded validation checklist, and added token-optimization/subagents references). I also synced .github/skills/agentic-workflows/SKILL.md to include workflow-designer.md in the loaded file list.

Copilot AI changed the title Add portable workflow-designer skill and route workflow-design requests through agentic-workflows dispatcher Add portable workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, and bake in token-efficient design defaults Jun 3, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new “design-first” pre-authoring prompt (workflow-designer) and updates the agentic-workflows dispatcher (and its embedded/template sources) so requests to design a workflow conversationally route to that prompt before workflow generation.

Changes:

  • Introduces .github/aw/workflow-designer.md, a structured interview flow that turns an automation goal into a confirmed, generation-ready workflow config.
  • Updates the agentic-workflows dispatcher templates + checked-in SKILL to mention workflow “design” and route interview-based design requests to the new prompt.
  • Extends CLI tests and fallback AW file list to ensure dispatcher generation includes the new routing and embedded file list entry.
Show a summary per file
File Description
pkg/cli/data/agentic_workflows_skill.md Updates embedded dispatcher template to include “design” and route design-via-interview to workflow-designer.md.
pkg/cli/data/agentic_workflows_fallback_aw_files.json Adds workflow-designer.md to the embedded fallback AW file list used when remote listing fails.
pkg/cli/copilot_agents_test.go Adds assertions that generated dispatcher content and fallback list include the new designer prompt.
.github/skills/agentic-workflows/SKILL.md Updates checked-in dispatcher to mention “design” and adds the new design routing line.
.github/aw/workflow-designer.md Adds the new design interview prompt, heuristics, confirmation format, and generation template.

Copilot's findings

Tip

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

  • Files reviewed: 5/5 changed files
  • Comments generated: 3

Comment thread .github/skills/agentic-workflows/SKILL.md Outdated
Comment thread .github/skills/agentic-workflow-designer/SKILL.md
Comment thread .github/skills/agentic-workflow-designer/SKILL.md
Copilot finished work on behalf of lpcox June 3, 2026 23:51
lpcox and others added 3 commits June 3, 2026 16:51
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

🚀 Smoke Antigravity MISSION COMPLETE! Antigravity has spoken. ✨

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

📰 BREAKING: Smoke Copilot is now investigating this pull request. Sources say the story is developing...

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Agent Container Tool Check

Tool Status Version
bash 5.2.21
sh available
git 2.54.0
jq 1.7
yq 4.53.2
curl 8.5.0
gh 2.92.0
node 24.16.0
python3 3.13.13
go 1.24.13
java 21.0.11
dotnet 10.0.300

Result: 12/12 tools available ✅

Overall Status: PASS

🔧 Tool validation by Agent Container Smoke Test · sonnet46 399K ·

@github-actions

This comment has been minimized.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Run URL: https://github.com/github/gh-aw/actions/runs/26921903177
Timestamp: Thu Jun 4 2026

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • localhost

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "localhost"

See Network Configuration for more information.

Smoke Gemini — Powered by Gemini ·

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Comment Memory

Cache lights flicker soft
GitHub stars above the logs
Smoke drifts into dawn

Note

This comment is managed by comment memory.

It stores persistent context for this thread in the code block at the top of this comment.
Edit only the text inside the backtick fences; workflow metadata and the footer are regenerated automatically.

Learn more about comment memory

🔮 The oracle has spoken through Smoke Codex · gpt54mini 17.6M ·

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

💥 Smoke Test: Claude — Run 26921903213

Core #1-13: ✅ all pass
PR review #14-19: ✅ all pass · #20 close PR: ⚠️ skipped

Overall: PARTIAL (all executed passed, 1 skipped)

Warning

Firewall blocked 6 domains

The following domains were blocked by the firewall during workflow execution:

  • accounts.google.com
  • android.clients.google.com
  • clients2.google.com
  • contentautofill.googleapis.com
  • safebrowsingohttpgateway.googleapis.com
  • www.google.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "accounts.google.com"
    - "android.clients.google.com"
    - "clients2.google.com"
    - "contentautofill.googleapis.com"
    - "safebrowsingohttpgateway.googleapis.com"
    - "www.google.com"

See Network Configuration for more information.

💥 [THE END] — Illustrated by Smoke Claude · opus48 5.5M ·

Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

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

💥 Automated smoke test review - all systems nominal!

Warning

Firewall blocked 6 domains

The following domains were blocked by the firewall during workflow execution:

  • accounts.google.com
  • android.clients.google.com
  • clients2.google.com
  • contentautofill.googleapis.com
  • safebrowsingohttpgateway.googleapis.com
  • www.google.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "accounts.google.com"
    - "android.clients.google.com"
    - "clients2.google.com"
    - "contentautofill.googleapis.com"
    - "safebrowsingohttpgateway.googleapis.com"
    - "www.google.com"

See Network Configuration for more information.

💥 [THE END] — Illustrated by Smoke Claude · opus48 5.5M

disable-model-invocation: true
---

# Workflow Designer
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.

Nice clear title heading for the skill. 👍


## When to Use This Skill

Use this before `.github/aw/create-agentic-workflow.md` when requirements are unclear or incomplete.
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.

Consider linking to the create-agentic-workflow doc here for discoverability.

@pelikhan
Copy link
Copy Markdown
Collaborator

pelikhan commented Jun 4, 2026

  • The skill should be named "agentic-workflow-designer" to avoid confusion
  • should be added to the init file list and written to the user repo as part of init command

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

Smoke cave report.
PR: Add portable workflow-designer skill.
1✅ 2✅ 3❌ 4✅ 5❌ 6✅ 7✅ 8✅ 9✅ 10✅ 11❌ 12✅ 13✅ 14✅ 15✅ 16✅
Overall: FAIL
Author: @app/copilot-swe-agent
Assignees: @lpcox, @Copilot

Warning

Firewall blocked 6 domains

The following domains were blocked by the firewall during workflow execution:

  • accounts.google.com
  • android.clients.google.com
  • clients2.google.com
  • contentautofill.googleapis.com
  • safebrowsingohttpgateway.googleapis.com
  • www.google.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "accounts.google.com"
    - "android.clients.google.com"
    - "clients2.google.com"
    - "contentautofill.googleapis.com"
    - "safebrowsingohttpgateway.googleapis.com"
    - "www.google.com"

See Network Configuration for more information.

📰 BREAKING: Report filed by Smoke Copilot · gpt54 5.4M ·

@lpcox
Copy link
Copy Markdown
Collaborator

lpcox commented Jun 4, 2026

@copilot address this feedback #36748 (comment)

Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jun 4, 2026

@copilot address this feedback #36748 (comment)

Addressed in ebe29e5.

Updated the skill name to agentic-workflow-designer, switched routing/template/test references to the new path, and added init behavior to write .github/skills/agentic-workflow-designer/SKILL.md to user repos (with init/help/tests updated accordingly).

Copilot AI changed the title Add portable workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, and bake in token-efficient design defaults Add portable agentic-workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, bake in token-efficient design defaults, and include designer skill in init output Jun 4, 2026
Copilot finished work on behalf of lpcox June 4, 2026 01:39
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 4, 2026

@copilot review all comments and address unresolved review feedback.
Please fix the unresolved review threads, starting with the invalid network.allowed mapping and the engine/template mismatch.

Generated by 👨‍🍳 PR Sous Chef · gpt54mini 7.2M ·

@lpcox
Copy link
Copy Markdown
Collaborator

lpcox commented Jun 4, 2026

@copilot as part of the conversation ask if there are any other third-party services or mcp servers that should be part of the workflow, look up what auth tokens those might need and then tell the user which action secrets or environment variables to set. the designer should also help with GHE deployments.

Copilot AI and others added 2 commits June 4, 2026 03:02
Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Co-authored-by: lpcox <15877973+lpcox@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented Jun 4, 2026

@copilot as part of the conversation ask if there are any other third-party services or mcp servers that should be part of the workflow, look up what auth tokens those might need and then tell the use...

Implemented in b207dbc. The agentic-workflow-designer conversation flow now explicitly asks about third-party services/MCP servers, requires auth token lookup, and outputs concrete GitHub Actions secrets + env var setup guidance. It also now asks about GitHub.com vs GHEC/GHES deployment and includes GHE guidance (engine.api-target / GHES compatibility) in confirmation and validation steps.

Copilot AI changed the title Add portable agentic-workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, bake in token-efficient design defaults, and include designer skill in init output Add portable agentic-workflow-designer skill, route workflow-design requests through agentic-workflows dispatcher, bake in token-efficient design defaults, include designer skill in init output, and add integration auth/GHE guidance Jun 4, 2026
Copilot finished work on behalf of lpcox June 4, 2026 03:09
@lpcox lpcox merged commit 272bddf into main Jun 4, 2026
32 of 33 checks passed
@lpcox lpcox deleted the copilot/add-workflow-designer-md branch June 4, 2026 04:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Create .github/aw/workflow-designer.md — portable conversational workflow design skill

4 participants