Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 30, 2026

Campaign documentation lacked a clear definition, decision framework for when to use campaigns vs workflows, and used inconsistent "orchestration" terminology.

Changes

Clarity & Structure

  • Added one-line definition: "Campaigns coordinate multiple autonomous agents working toward a shared goal, with built-in progress tracking via GitHub Projects"
  • Consolidated quickstart from separate page into main campaign index
  • Added decision table with 8 scenarios comparing campaigns vs regular workflows
  • Added comprehensive glossary entries for "Agentic Campaign" with cross-references
  • Deleted docs/src/content/docs/guides/campaigns/getting-started.md - content consolidated into main index
  • Deleted docs/src/content/docs/examples/campaigns.md - content no longer needed after restructure

Terminology

  • Replaced "workflow orchestration" → "agent coordination" across all campaign docs
  • Updated "orchestrator" → "coordinator" in examples and shared rules
  • Rationale: "orchestration" implies rigid workflow sequencing; "coordination" better describes autonomous agent collaboration

Examples

  • Explicitly labeled Dependabot Burner as "the smallest useful campaign" to provide clear entry point

Link Fixes

  • Fixed broken documentation links in cli.md and project-tracking.md that pointed to deleted campaign files
  • Updated all references to point to /gh-aw/guides/campaigns/

Files Modified

  • docs/src/content/docs/guides/campaigns/index.mdx - main improvements
  • docs/src/content/docs/guides/campaigns/getting-started.md - DELETED (consolidated into index)
  • docs/src/content/docs/examples/campaigns.md - DELETED (no longer needed)
  • .github/workflows/shared/campaign.md - terminology updates
  • docs/src/content/docs/reference/safe-outputs.md - terminology update
  • docs/src/content/docs/reference/glossary.md - added comprehensive "Agentic Campaign" entries
  • docs/src/content/docs/setup/cli.md - fixed broken link
  • docs/src/content/docs/examples/project-tracking.md - fixed broken links and updated terminology
Original prompt

Improve campaign docs to:

  • Move Quickstart into getting Start guide
  • Add a one-sentence “Campaigns in one line” definition
  • Draft a “When should this just be a workflow?” decision table
  • Redefine it everywhere as “agent coordination,” not workflow orchestration
  • Explicitly call the Dependabot example “the smallest useful campaign”

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

Copilot AI and others added 2 commits January 30, 2026 10:58
…tion" terminology

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copilot AI changed the title [WIP] Improve campaign documentation and definitions Improve campaign docs: add definition, decision table, agent coordination terminology Jan 30, 2026
Copilot AI requested a review from mnkiefer January 30, 2026 11:01
@mnkiefer
Copy link
Contributor

@copilot Add glossary entry for "Agentic Campaign".

@mnkiefer mnkiefer marked this pull request as ready for review January 30, 2026 11:01
Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Jan 30, 2026

@copilot Add glossary entry for "Agentic Campaign".

Added comprehensive glossary entry for "Agentic Campaign" with the same definition used in the campaign docs: "Workflows that coordinate multiple autonomous agents working toward a shared goal, with built-in progress tracking via GitHub Projects."

Updated both the brief entry (Core Concepts) and the detailed entry (Advanced Features) for consistency. Commit: d6df6c8

Copilot AI changed the title Improve campaign docs: add definition, decision table, agent coordination terminology Improve campaign docs: add definition, decision table, agent coordination terminology, glossary Jan 30, 2026
@mnkiefer mnkiefer changed the title Improve campaign docs: add definition, decision table, agent coordination terminology, glossary chore: reduce campaign docs and add glossary entry Jan 30, 2026
@mnkiefer
Copy link
Contributor

@copilot Remove invalid docs links

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Jan 30, 2026

@copilot Remove invalid docs links

Fixed broken links to deleted campaign documentation files:

  • /gh-aw/guides/campaigns/getting-started//gh-aw/guides/campaigns/ (cli.md)
  • /gh-aw/examples/campaigns//gh-aw/guides/campaigns/ (project-tracking.md, 2 occurrences)

Also updated terminology from "orchestrator" to "coordinator" for consistency. Commit: 71e9e05

Copilot AI requested a review from mnkiefer January 30, 2026 11:36
@mnkiefer mnkiefer merged commit b288595 into main Jan 30, 2026
120 checks passed
@mnkiefer mnkiefer deleted the copilot/improve-campaign-docs branch January 30, 2026 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants