Use GitHub UI project selection instead of manual URL entry in campaign template

[Copilot]

Campaign issue template required users to manually paste project board URLs, leading to typos and formatting errors. Users now select projects via GitHub's native UI with two clear options: creating the issue directly from the project board (recommended, auto-assigns project) or manually selecting the project before submission.

Changes

Issue template (.github/ISSUE_TEMPLATE/start-campaign.yml)

• Removed project_url input field
• Added two clear options for project assignment:
  • Option A (Recommended): Create issue from project board → project auto-assigned
  • Option B: Create from issues page → manually assign project before submission
• Clear visual hierarchy with important callout to prevent users from missing project assignment

Agent designer (.github/agents/agentic-campaign-designer.agent.md)

• Query project assignments via GitHub API using projectItems
• Aligned field names with template (campaign_goal not campaign_name)
• Added null-safe jq expressions with ? operator and // empty defaults
• Enhanced error messaging when project is not assigned, suggesting project board creation option

Query skill (skills/github-issue-query/)

• Added projectItems to JSON fields
• Included example queries for project board retrieval with null safety

Documentation (docs/src/content/docs/guides/campaigns/getting-started.md)

• Added "Creating the Campaign Issue" section documenting both options
• Emphasized Option A (create from project board) as recommended approach
• Updated validation step to reflect project assignment check
• Added benefit: "Automatic project assignment"

Example

Agent retrieves project URL from issue assignment:

gh issue view $ISSUE_NUMBER --json projectItems \
  --jq '.projectItems.nodes[0]?.project?.url // empty'

Returns: https://github.com/orgs/githubnext/projects/67 or empty string if unassigned.

Benefits

• Reduced errors: No manual URL entry eliminates typos
• Two clear pathways: Recommended approach (project board) ensures automatic assignment; fallback approach (manual) clearly documented
• Better UX: Native GitHub project selector with guidance
• Prevents missed assignments: Clear instructions and recommended workflow reduce chance of forgetting

Original prompt

When generating campaigns from the issue template, have the user add the project board by selecting by selecting it from the issue at the bottom of the template before submission via the UI naturally, not via a field in the input form. This way, the campaign generator is less likely to make mistakes.

---

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

[mnkiefer]

@copilot: The bottom of the issue template already allowed for assigning labels, project, etc. before pressing "Create".

[Copilot]

@copilot: The bottom of the issue template already allowed for assigning labels, project, etc. before pressing "Create".

You're absolutely right! Updated the instructions in commit 9aba1a3 to tell users to assign the project using the selector at the bottom of the issue form before pressing "Create", not after submission. Much clearer and more accurate.

[mnkiefer]

@copilot: Also, should the users be encouraged after creating the project board to open the issue from there directly? Then the project could be appended to the issue naturally. Also, how to avoid users missing to append it when starting from the issues page instead. See docs.

[Copilot]

@copilot: Also, should the users be encouraged after creating the project board to open the issue from there directly? Then the project could be appended to the issue naturally. Also, how to avoid use...

Great suggestions! Updated in commits 1bf0cb8 and ea334b0:

Issue template now shows two options:

• Option A (Recommended): Create issue from project board → project auto-assigned ✅
• Option B: Create from issues page → manually assign project before submission

Documentation updated to reflect this recommended workflow and explain both approaches.

Agent instructions enhanced to provide clearer guidance when project is missing, suggesting the project board creation option.

This addresses both concerns: users are encouraged to create from the project board (naturally assigns project), and those starting from issues page have clear instructions to avoid missing the assignment.