Move orchestration and projects guides to .github/aw as agent prompts

[Copilot]

Relocates orchestration and projects patterns to .github/aw/ for use by workflow generation agents. These prompts provide specialized knowledge when agents need to design workflows with delegation or GitHub Projects integration.

Changes

File Relocations:

• Moved .github/workflows/shared/orchestration.md → .github/aw/orchestration.md
• Moved .github/workflows/shared/projects.md → .github/aw/projects.md

Orchestration Enhancements:

• Added "When to Use" guidance (coordinator workflows, worker dispatch, task correlation)
• Expanded correlation ID patterns and their debugging value
• Added common patterns: issue triage → assignment, bulk processing with workers, sequential delegation
• Clarified assign-to-agent vs dispatch-workflow use cases

Projects Integration Content:

• When to use Projects integration (tracking items, automated status updates, periodic summaries)
• Core patterns: update-project, create-project-status-update, create-project
• Prerequisites and authentication requirements (PAT/GitHub App tokens)
• Workflow configuration with frontmatter examples
• Agent output patterns for all safe-output types
• Design guidelines: guardrails, conventions, project management best practices

Agent Integration:

• Updated .github/agents/agentic-workflows.agent.md with "Key Workflow Concepts" section at the bottom
• References both prompts with clear load conditions:
  • Orchestration: when coordinating multiple agents or dispatching workers
  • GitHub Projects Integration: when managing GitHub Projects v2

Example

The dispatcher agent now routes to specialized prompts:

### Orchestration and Delegation

**Load when**: Creating workflows that coordinate multiple agents or dispatch work

**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/orchestration.md

### GitHub Projects Integration

**Load when**: Creating or updating workflows that manage GitHub Projects v2

**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/projects.md

No workflows currently use the old imports: syntax for these files.

Original prompt

Move orchestration.md and observability.md to the .github/aw folder and update the agentic-workflows.agent.md prompt to references them the same it does for other prompt files.
Removing existing prompt that uses imports syntax to import them.

Review those files and ensure they are optimized as agentic prompts for an agent that genetates workflows.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[pelikhan]

@copilot move .github/workflows/shared/project.md as well

[pelikhan]

@copilot remove observability file and reference

[Copilot]

Done in 26d4553. Removed .github/aw/observability.md and removed the observability reference from the "Workflows may optionally include" list in agentic-workflows.agent.md.

[Copilot]

@copilot move .github/workflows/shared/project.md as well

Done in 26d4553. Moved .github/workflows/shared/projects.md to .github/aw/projects.md and optimized it as an agent prompt with clearer structure and sections.

[Copilot]

Pull request overview

This PR rehomes the orchestration and GitHub Projects guidance from shared workflow imports into dedicated .github/aw agent prompts, and wires them into the main agentic workflows agent prompt. The goal is to give workflow‑generation agents richer, dedicated instructions for delegation/orchestration and Projects v2 integration without relying on imports: in workflows.

Changes:

• Remove the shared GitHub Projects and Orchestration markdown guides under .github/workflows/shared/.
• Add new agent-focused guides under .github/aw/projects.md and .github/aw/orchestration.md with expanded “when to use,” configuration, and design‑pattern content.
• Update .github/agents/agentic-workflows.agent.md to advertise these new prompts with clear load conditions and direct links.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
.github/workflows/shared/projects.md	Removes the old shared Projects v2 guidance that was intended to be imported via workflow imports:.
.github/workflows/shared/orchestration.md	Removes the old orchestration/delegation shared guide that was previously imported by workflows.
.github/aw/projects.md	Introduces a self‑contained Projects v2 integration prompt for agents, covering when to use, safe‑output config, agent output patterns, and project management best practices.
.github/aw/orchestration.md	Introduces an orchestration/delegation prompt for agents, including assign‑to‑agent vs dispatch‑workflow, correlation IDs, and common orchestration patterns.
.github/agents/agentic-workflows.agent.md	Adds a “Key Workflow Concepts” section that tells agents when to load the new orchestration and Projects prompts and what they cover, with direct GitHub links.

---

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

[Copilot]

Now that the Projects and Orchestration guides have been moved from .github/workflows/shared/ into .github/aw/, the example in create.md still tells users to import github/gh-aw/.github/workflows/shared/projects.md@vX.Y.Z and .../shared/orchestration.md@vX.Y.Z, and also claims these files exist locally under .github/workflows/shared/. That documentation will become incorrect (and the import paths will 404) once this PR lands, so we should update create.md to reference the new .github/aw/ locations or otherwise adjust that snippet to match the new structure.

Suggested change

	- For safe-outputs documentation, see the `safe-outputs:` section in the main configuration guide
	- For safe-outputs documentation, see the [`safe-outputs` section](https://github.com/github/gh-aw/blob/main/.github/aw/github-agentic-workflows.md#safe-outputs) in the main configuration guide