Skip to content

Add patterns router prompt and wire dispatcher routing#31985

Merged
pelikhan merged 7 commits into
mainfrom
copilot/add-router-instruction-file
May 13, 2026
Merged

Add patterns router prompt and wire dispatcher routing#31985
pelikhan merged 7 commits into
mainfrom
copilot/add-router-instruction-file

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 13, 2026 •
edited
Loading

New Feature

What does this feature do?

This change adds a dedicated .github/aw/patterns.md router prompt that maps users to the full set of documented workflow patterns. It also updates the dispatcher agent so pattern/architecture requests are explicitly routed through this new entry point.

Why is this feature needed?

Pattern selection guidance was distributed across docs but not available as a single router instruction file for agent use. This creates a consistent, low-friction path from user intent to the correct pattern playbook.

Implementation details

  • Added consolidated pattern router

    • Created .github/aw/patterns.md with:
      • intent-based routing rules
      • indexed coverage for all documented patterns in docs/src/content/docs/patterns/
      • guidance for multi-pattern composition and fallback clarification

  • Updated dispatcher linkage

    • Extended .github/agents/agentic-workflows.agent.md to include:
      • a new routing bullet for architecture/pattern-selection requests
      • a dedicated “Workflow Pattern Selection” section pointing to .github/aw/patterns.md

  • Example

    ### Workflow Pattern Selection
**Load when**: The user asks for architecture, strategy, operating model selection, or pattern recommendations for building agentic workflows.

**Reference file**: https://github.com/github/gh-aw/blob/main/.github/aw/patterns.md

Copilot AI and others added 6 commits May 13, 2026 16:42
@pelikhan
Add patterns router prompt and link from dispatcher agent
5d2c34b 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Use relative links in patterns router prompt
91ffde0 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Document relative path assumption in patterns router
ee4ebe8 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Reduce repeated path prefixes in patterns router
01e2ecc 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Normalize reference path style in patterns router
e404b6b 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
@pelikhan
Use explicit core rules path in patterns router
bca5d0d 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Add patterns router prompt and wire it into dispatcher agent Add patterns router prompt and wire dispatcher routing May 13, 2026
Copilot AI requested a review from pelikhan May 13, 2026 16:47
pelikhan
pelikhan reviewed May 13, 2026
View reviewed changes
Copy link
Copy Markdown
Collaborator

@pelikhan pelikhan left a comment

Choose a reason for hiding this comment

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

@copilot include callout in agentic-workflows.agent.md dispatcher

Comment thread .github/aw/patterns.md Outdated

## Pattern Index

Pattern docs base path (relative to this file): `../../docs/src/content/docs/patterns/`
Copy link
Copy Markdown
Collaborator

@pelikhan pelikhan May 13, 2026

Choose a reason for hiding this comment

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

@copilot use github global urls to link to files

Copy link
Copy Markdown
Contributor Author

Copilot AI May 13, 2026

Choose a reason for hiding this comment

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

Updated in e43d8fa: all pattern links in .github/aw/patterns.md now use GitHub global URLs (https://github.com/github/gh-aw/blob/main/...).

@pelikhan
Address PR feedback on pattern routing links and dispatcher callout
e43d8fa 
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copy link
Copy Markdown
Contributor Author

Copilot AI commented May 13, 2026

@copilot include callout in agentic-workflows.agent.md dispatcher

Done in e43d8fa: added a dispatcher callout in .github/agents/agentic-workflows.agent.md and restored the dedicated Workflow Pattern Selection routing section to point to .github/aw/patterns.md.

Copilot AI requested a review from pelikhan May 13, 2026 16:55
@pelikhan pelikhan marked this pull request as ready for review May 13, 2026 17:03
Copilot AI review requested due to automatic review settings May 13, 2026 17:03
@pelikhan pelikhan merged commit ffa62fc into main May 13, 2026
@pelikhan pelikhan deleted the copilot/add-router-instruction-file branch May 13, 2026 17:03
Copilot AI reviewed May 13, 2026
View reviewed changes
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 consolidated workflow-pattern router prompt and wires the main dispatcher agent to route architecture/pattern-selection requests through it.

Changes:

  • Added .github/aw/patterns.md to route user intents to the appropriate documented workflow pattern playbook.
  • Updated .github/agents/agentic-workflows.agent.md to explicitly route architecture/pattern requests to the new patterns router (including a dedicated section + IMPORTANT routing note).
Show a summary per file
File Description
.github/aw/patterns.md New router prompt indexing all documented workflow patterns and providing routing rules/fallback behavior.
.github/agents/agentic-workflows.agent.md Dispatcher update to route pattern/architecture questions to the new patterns router prompt.

Copilot's findings

Tip

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

  • Files reviewed: 2/2 changed files
  • Comments generated: 0

This was referenced May 24, 2026
Merged
Merged
Copilot AI added a commit that referenced this pull request May 26, 2026
@gh-aw-bot
feat: implement SPDD daily work items 2026-05-26
31a37fd 
- [/spdd-sync] Add Appendix B sync comment on poissonNormalApproximationThreshold in
  forecast_montecarlo.go (closes #31985)
- [/spdd-sync] Add TestForecastWorkflow_LambdaConsistencyAcrossOutputFormats in
  forecast_test.go verifying verbose/JSON output use same λ (closes #31984)
- [/spdd-generate] Replace future-state note in frontmatter-hash-specification.md §2 with
  formal deferral note referencing #31983
- [/spdd-generate] Elevate idempotency in mcp-scripts-specification.md §5.7 to normative
  SHOULD with example
- [/spdd-generate] Add T-FZ-L3-001..005 Level 3 compliance test IDs and §10.2.8 group
  definitions to fuzzy-schedule-specification.md §10
- [/spdd-analysis] Confirm fuzzy-schedule-specification.md §12 is complete (not stub);
  add audit note to sync notes
- [/spdd-sync] Add TestModelMultipliersNoPlaceholders (R-REG-007) to
  effective_tokens_test.go + make validate-registry target
- [/spdd-reasons-canvas] Add §7.6 Norms subsection (secret rotation + secret scope) to
  mcp-scripts-specification.md §7 Security Model
- Update forecast-specification.md §13 sync notes to mark #31984 and #31985 resolved
- Update effective-tokens-specification.md sync notes to document R-REG-007 automation

Co-authored-by: gh-aw-bot <259018956+gh-aw-bot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

+1 more reviewer

@pelikhan pelikhan pelikhan approved these changes

Reviewers whose approvals may not affect merge requirements

Assignees

@pelikhan pelikhan

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@pelikhan