Add "Use Shared Agentic Workflows" subsection to create.md

[Copilot]

The documentation lacked discovery paths for shared workflow components like orchestration and monitoring patterns. Users had no clear entry point to learn about composition via imports or the helper files available after installation.

Changes

create.md

• Added "Use Shared Agentic Workflows" subsection under Step 2 (following the existing pattern of other subsections like "Create New Workflow", "Update Existing Workflow", etc.)
• Documented orchestration pattern (dispatch-workflow, assign-to-agent)
• Documented monitoring pattern (update-project, create-project-status-update)
• Included discovery instructions for .github/workflows/shared/
• Added "Available After Installation" documentation for:
  • Workflow prompt files in .github/aw/ (create, update, debug, upgrade, create-shared)
  • Agent files in .github/agents/ (dispatcher agent)
  • Explanation of how these files guide AI assistants in workflow development
• Fixed code examples with proper quoting for consistency

Structure

The "Use Shared Agentic Workflows" subsection follows the same pattern as other Step 2 subsections with:

• Load when: Describes when to use this section
• Use cases: Example user requests
• Content: Comprehensive documentation on shared components

Example

Users can now compose workflows from shared components:

---
imports:
  - shared/orchestration.md
  - shared/projects.md
safe-outputs:
  dispatch-workflow:
    workflows: [worker-a, worker-b]
    max: 10
  update-project:
    project: "https://github.com/orgs/myorg/projects/123"
    max: 10
---

Orchestration delegates to specialized workers. Monitoring tracks progress in GitHub Projects. Both patterns were already implemented in .github/workflows/shared/ but undiscoverable.

The subsection is now easily referenceable by create workflow, update workflow, and other workflow-related prompts that follow the create.md dispatch pattern.

Original prompt

Could the documentation and create.md benefit from a section called "reusable components" (like orchestration and monitoring)?

---

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

[mnkiefer]

@copilot only focus on create.md and remove other changes. We want the prompt to be available of shared imports so that it can use the in create workflow, update workflow, etc.

[Copilot]

@copilot only focus on create.md and remove other changes. We want the prompt to be available of shared imports so that it can use the in create workflow, update workflow, etc.

Done. Removed changes to packaging-imports.md. Now only create.md has the reusable components section (commit a772aec).

The reusable components documentation is now available in create.md where it can be referenced by create workflow, update workflow, and other workflow prompts.

[mnkiefer]

@copilot Check if there are other shareable workflows or instructions that are available to the user after install/create in a fresh repo.

[Copilot]

Pull request overview

This PR enhances the create.md documentation by adding a comprehensive "Reusable Components" section that helps users discover and utilize shared workflow components. The documentation was previously missing clear guidance on how to compose workflows using imports.

Changes:

• Added a new "Reusable Components" section with subsections covering common patterns (orchestration, monitoring, reporting), discovery instructions, import usage, and links to related guides
• Positioned the section between Step 2 (workflow creation) and Step 3 (review), providing contextual information at the right point in the workflow creation process
• Included practical YAML examples demonstrating how to import and configure shared components

Comments suppressed due to low confidence (1)

create.md:152

• The project URL should be enclosed in quotes for consistency with examples throughout the codebase. The shared/projects.md file and actual workflow examples consistently use quotes around project URLs.

    project: https://github.com/orgs/myorg/projects/123
    max: 1

---

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

[Copilot]

The project URL should be enclosed in quotes for consistency with examples throughout the codebase. The shared/projects.md file and actual workflow examples consistently use quotes around project URLs.

[Copilot]

Fixed in commit 373ae7a. Project URLs now have quotes.

[Copilot]

The value for the name field should be enclosed in quotes for consistency with the reference documentation in shared/orchestration.md, which shows name: "copilot".

[Copilot]

Fixed in commit 373ae7a. Changed to name: "copilot" with quotes.

[Copilot]

@copilot Check if there are other shareable workflows or instructions that are available to the user after install/create in a fresh repo.

Added "Available After Installation" section documenting the workflow prompt files and agent files created by gh aw init (commit 8954b8d).

The section now covers:

• Workflow prompt files in .github/aw/ (create, update, debug, upgrade, create-shared)
• Agent files in .github/agents/ (dispatcher agent)
• Explanation that these files guide AI assistants in workflow development

Combined with the existing documentation on .github/workflows/shared/ components, this provides a complete picture of shareable resources available after installation.

[mnkiefer]

@copilot No separate section, this goes against the main pattern of create.md. But maybe a section on "Use Shared Agentic Workflows" that other sectioms can see when creating/updating a workflow?

[Copilot]

@copilot No separate section, this goes against the main pattern of create.md. But maybe a section on "Use Shared Agentic Workflows" that other sectioms can see when creating/updating a workflow?

Restructured in commit 373ae7a. Removed the separate "Reusable Components" section and created "Use Shared Agentic Workflows" as a subsection under Step 2, following the same pattern as "Create New Workflow", "Update Existing Workflow", etc.

The subsection includes:

• "Load when" and "Use cases" sections consistent with other subsections
• All the orchestration, monitoring, and shared component documentation
• Can now be referenced by other sections when creating/updating workflows

[mnkiefer]

• Closing in favor of chore: enhance workflow creation instructions for imports #13702