Skip to content

feat(aif-create-issue): add Motivation section to issue template - #82

Open
cheellipadi wants to merge 2 commits into
String-dxd:mainfrom
cheellipadi:feat/add-motivation-section-to-issue-template
Open

feat(aif-create-issue): add Motivation section to issue template#82
cheellipadi wants to merge 2 commits into
String-dxd:mainfrom
cheellipadi:feat/add-motivation-section-to-issue-template

Conversation

@cheellipadi

@cheellipadi cheellipadi commented Jun 25, 2026

Copy link
Copy Markdown

Related to #81

Summary

  • Adds a `## Motivation` section as the first author section in `issue-template.md`
  • Updates SKILL.md Step 1 to prompt for Motivation (item 2, before user story)
  • Updates the author sections summary line to include motivation

Changes

  • `skills/aif-create-issue/issue-template.md`: new `## Motivation` section added before `## User story`
  • `skills/aif-create-issue/SKILL.md`: Motivation added as gather step 2; list renumbered 1-7; author sections description updated

Test plan

  • Scenario 1 (Motivation section appears): issue-template.md now contains `## Motivation` as the first author section -- any issue created from the template will include it
  • Scenario 2 (Developer is prompted): SKILL.md Step 1 now lists Motivation as a required gather item with the same "do not invent, ask" instruction as other required sections

Test Evidence

#83 created using aif-create-issue with changeset from this PR


🤖 Generated with aif-implement-issue

cheellipadi and others added 2 commits June 25, 2026 09:32
Closes String-dxd#81

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ections

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cheellipadi
cheellipadi marked this pull request as ready for review June 25, 2026 03:42
@natashaannn

Copy link
Copy Markdown
Collaborator

To think about this in the larger scheme of issue prioritization - what can we write in 'Motivation' section that helps PMs and engineers quantitatively account for priority of feature?

@ivanfoong
ivanfoong marked this pull request as draft July 15, 2026 07:40
@natashaannn
natashaannn marked this pull request as ready for review July 27, 2026 01:18

@natashaannn natashaannn left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Discussed with cheeyang on Slack thread, need further work and new issues later on to discuss larger theme of prioritisation by PMs and their needs. To merge first and revisit discussion later.

Other questions:

  • how is motivation different from background?

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