Skip to content

Simplify campaign issue template and use add-comment for progress updates#9021

Merged
mnkiefer merged 6 commits intomainfrom
copilot/improve-create-campaign-issue
Jan 5, 2026
Merged

Simplify campaign issue template and use add-comment for progress updates#9021
mnkiefer merged 6 commits intomainfrom
copilot/improve-create-campaign-issue

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 5, 2026

The campaign creation flow overwhelmed users with verbose instructions in the issue template and cluttered the issue body with AI instructions. Project URLs were buried in text, making them hard to find.

Changes

Issue Template Reduction

  • Reduced .github/ISSUE_TEMPLATE/start-campaign.yml from 59 to 23 lines (59% reduction)
  • Removed project board setup instructions and "How it works" section
  • Removed additional context field (only campaign goal remains)
  • Made title non-editable: "[New Agentic Campaign]" (generator derives campaign name from goal)
  • Changed label to direct question format: "What should this campaign accomplish?"

Workflow Communication Strategy

  • Replaced update-issue with add-comment safe output in campaign-generator.md
  • Added step-by-step progress comments instead of appending to issue body
  • Project URL now displayed prominently at top of first comment with 📊 emoji
  • Two-stage comment flow: initial status + confirmation after agent assignment
  • Updated workflow trigger to only support "[New Agentic Campaign]" title (no backward compatibility needed since templates haven't been actively used)

Before:

safe-outputs:
  update-issue:
    status:
    body:
    target: "${{ github.event.issue.number }}"

After:

safe-outputs:
  add-comment:
    max: 5
  assign-to-agent:

Comment Structure

Initial comment shows project link prominently:

🤖 **Campaign Creation Started**

📊 **Project Board:** [View Project](<url>)

I'm processing your campaign request. Here's what will happen:
1. ✅ Retrieve project board details
2. 🔄 Analyze campaign requirements
3. 📝 Generate campaign specification
...

Confirmation comment provides clear next steps after agent assignment with expected timelines.

Agent Updates

  • Updated .github/agents/agentic-campaign-designer.agent.md to remove references to additional context field
  • Updated parsing instructions to match new single-field template structure

Impact

  • Issue template cognitive load reduced by 59% (59 → 23 lines)
  • Single required field (campaign goal) - generator derives everything else
  • Clearer title: "[New Agentic Campaign]" better indicates fresh campaign creation
  • Consistent issue titles for better tracking
  • Clean, focused workflow trigger (no legacy support complexity)
  • Project URL visible at top of first comment instead of buried in issue body
  • Real-time progress updates via comments
  • Issue body remains clean without verbose AI instructions
Original prompt

Improve the create campaign from issue experience, by reducing the issue template to a bare minimum. Make use of add-comment to mention what is happening at every stage to keep the user informed. Clear show the link to the project near the top so it is more visible.


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

…ates

- Reduced issue template to bare minimum (just project board notice and campaign goal)
- Removed verbose instructions from issue template
- Updated campaign-generator to use add-comment instead of update-issue
- Added step-by-step progress comments with project URL prominently displayed
- Clear communication at each stage: initial comment, agent assignment, confirmation

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>
@mnkiefer mnkiefer marked this pull request as ready for review January 5, 2026 18:14
Copilot AI changed the title [WIP] Enhance create campaign issue experience Simplify campaign issue template and use add-comment for progress updates Jan 5, 2026
Copilot AI requested a review from mnkiefer January 5, 2026 18:21
@mnkiefer
Copy link
Copy Markdown
Collaborator

mnkiefer commented Jan 5, 2026

@copilot: Should we also remove the additional context field and let the generator choose the name itself? Then the issue template title would just be by default [Agentic Campaign] non-modifiable in the issue.

- Removed additional_context field from issue template (now only campaign_goal)
- Changed title from "[Agentic Campaign] " to "[Agentic Campaign]" (non-editable)
- Updated label from "Campaign Goal" to direct question "What should this campaign accomplish?"
- Updated agentic-campaign-designer agent to remove references to additional_context
- Template now reduced from 35 to 24 lines (further 31% reduction)

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

Copilot AI commented Jan 5, 2026

@copilot: Should we also remove the additional context field and let the generator choose the name itself? Then the issue template title would just be by default [Agentic Campaign] non-modifiable in t...

Done in 43c0217. Removed the additional_context field and made the title non-editable as "[Agentic Campaign]". The template now has just one field (campaign goal) and the generator derives everything else. Template reduced from 35 to 24 lines (59% reduction from original).

Final template:

title: "[Agentic Campaign]"  # Fixed, non-editable
body:
  - Project board notice (1 line)
  - Campaign goal field (1 required field)

The generator now auto-derives the campaign name from the goal, and users only need to describe what they want to accomplish.

@mnkiefer
Copy link
Copy Markdown
Collaborator

mnkiefer commented Jan 5, 2026

@copilot: Change title to [New Agentic Campaign].

- Updated issue template title from "[Agentic Campaign]" to "[New Agentic Campaign]"
- Updated campaign-generator workflow to trigger on new title format
- Recompiled workflow lock file

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

Copilot AI commented Jan 5, 2026

@copilot: Change title to [New Agentic Campaign].

Done in 65bedb4. Changed title to "[New Agentic Campaign]" in the issue template and updated the campaign-generator workflow to trigger on the new title format (while maintaining backward compatibility with "[Campaign]" and "[Agentic Campaign]").

@mnkiefer
Copy link
Copy Markdown
Collaborator

mnkiefer commented Jan 5, 2026

@copilot: No need for backward compatibility since templates haven't been used actively yet.

- Simplified trigger condition to only check for "[New Agentic Campaign]"
- Removed checks for "[Campaign]" and "[Agentic Campaign]" (not needed since templates haven't been actively used)
- Recompiled workflow lock file

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

Copilot AI commented Jan 5, 2026

@copilot: No need for backward compatibility since templates haven't been used actively yet.

Done in cb23611. Removed backward compatibility checks - the workflow now only triggers on "[New Agentic Campaign]" title.

@mnkiefer mnkiefer merged commit d5dd2ef into main Jan 5, 2026
130 checks passed
@mnkiefer mnkiefer deleted the copilot/improve-create-campaign-issue branch January 5, 2026 18:53
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