Align Copilot SDK driver docs with engine.driver

[Copilot]

The docs advertised engine.copilot-sdk-driver, but the workflow parser only reads engine.driver. This change removes that drift so the documented Copilot SDK driver configuration matches the compiler’s actual behavior.

• Reference docs

  • Replaced user-facing engine.copilot-sdk-driver examples and prose with engine.driver in the engine reference.
  • Updated the generated frontmatter reference to show driver instead of the ignored key.

• Behavior documentation

  • Clarified that, for the Copilot engine, setting engine.driver enables engine.copilot-sdk automatically.
  • Updated glossary/internal syntax guidance to describe engine.driver as the canonical field for custom Copilot SDK drivers.

• Code comments

  • Removed a misleading validation comment that claimed engine.copilot-sdk-driver was still accepted for backward compatibility.

engine:
  id: copilot
  driver: .github/drivers/my_driver.ts
  model: gpt-5

[github-actions]

Hey @Copilot 👋 — thanks for cleaning up the drift between the documented engine.copilot-sdk-driver alias and the canonical engine.driver field! Keeping the reference docs, frontmatter reference, glossary, and internal syntax guidance all consistent with what the compiler actually reads is a solid improvement.

One small flag from the checklist:

• No test file changes — pkg/workflow/engine_validation.go was touched (a comment was removed). No behavior changed, so a new test isn't strictly necessary, but it's worth confirming that any existing tests for validateEngineDriver still pass cleanly after the comment removal and that nothing references the old copilot-sdk-driver backward-compat note in test assertions.

If you'd like a quick verification pass, you can assign this to your coding agent:

Verify that the existing tests covering `validateEngineDriver` in `pkg/workflow/engine_validation.go` still pass after the removal of the backward-compatibility comment for `engine.copilot-sdk-driver`. Search the test suite for any assertion or fixture that references `copilot-sdk-driver` and confirm none remain. Run the relevant Go test package and report results.

Generated by ✅ Contribution Check · 302.1 AIC · ⌖ 26.3 AIC · ⊞ 6.3K · ◷

[github-actions]

🤖 PR Triage — Run §28572743533

Field	Value
Category	docs
Risk	🟢 Low
Score	40 / 100
Breakdown	Impact: 15 · Urgency: 10 · Quality: 15
Action	fast_track

Small doc alignment (16+/18−, 5 files). Fixes engine.driver references in docs and syntax — high signal-to-noise, fast to review.

Generated by 🔧 PR Triage Agent · 64.3 AIC · ⌖ 9.84 AIC · ⊞ 1.6K · ◷

[Copilot]

Pull request overview

Aligns the documentation and internal guidance for configuring custom Copilot SDK drivers with the compiler’s canonical engine.driver field (instead of the previously documented engine.copilot-sdk-driver), reducing drift between docs and actual parsing/validation behavior.

Changes:

• Updates Copilot SDK configuration docs to use engine.driver and clarifies that engine.driver on the Copilot engine enables engine.copilot-sdk automatically.
• Updates glossary/syntax guidance to describe engine.driver as the canonical driver field.
• Removes a misleading code comment suggesting engine.copilot-sdk-driver is still accepted.

Show a summary per file

File	Description
pkg/workflow/engine_validation.go	Updates the validation comment to describe only engine.driver.
docs/src/content/docs/reference/glossary.md	Updates Copilot SDK and engine.driver glossary entries to reference engine.driver.
docs/src/content/docs/reference/frontmatter-full.md	Updates the generated frontmatter reference from copilot-sdk-driver to driver.
docs/src/content/docs/reference/engines.md	Updates Copilot SDK support section examples/prose to use engine.driver.
.github/aw/syntax-agentic.md	Updates internal syntax guidance to describe Copilot SDK driver configuration via engine.driver.

Review details

Tip

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

• Files reviewed: 5/5 changed files
• Comments generated: 3
• Review effort level: Low

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.82.2