---

name: create-issue description: Creates a new GitHub issue with structured user story format, acceptance criteria, and project integration. Use when the user wants to create a ticket, issue, or task for the tradingstrategy-ai/frontend repository.

Create GitHub Issue

Creates a well-structured GitHub issue in tradingstrategy-ai/frontend with sensible defaults.

Defaults

Information Gathering

Prompt the user for:

1. User Story: Who (persona), What (capability), Why (benefit - preferred)
2. Acceptance Criteria: Clear, testable conditions. Use gherkin (Given/When/Then) when it improves clarity.

Optional: Background context, attachments, or default overrides.

Issue Body Format

Copy# Goal

As a [who], I want [what], so that [why].

## Acceptance Criteria

1. [Condition]
2. [Condition]

## Background

[Optional context]

Creating the Issue

Step 1: Determine assignee

Run: scripts/get-assignee.sh

Returns the current GH user if they have write access, empty otherwise.

Step 2: Create the issue

Copygh issue create \
  --repo tradingstrategy-ai/frontend \
  --title "<brief summary from user story>" \
  --body "<formatted markdown body>" \
  --label "priority: P1" \
  --label "size: S" \
  --assignee "<result from step 1, omit flag if empty>"

Parse the issue number from the returned URL for use in subsequent steps.

Step 3: Set issue type

Copy# Get Feature type ID
TYPE_ID=$(scripts/get-issue-type-id.sh Feature)

# Get issue node ID (use issue number from step 2)
ISSUE_NODE_ID=$(scripts/get-issue-node-id.sh <ISSUE_NUMBER>)

# Set the type
scripts/set-issue-type.sh "$ISSUE_NODE_ID" "$TYPE_ID"

Step 4: Add to project

Copyscripts/add-to-project.sh "<ISSUE_URL>" Todo

If prompted about project scope, user should run: gh auth refresh -s project

Step 5: Report results

Confirm: issue URL, assignee, labels, type, project status.

Error Handling

• Project scope missing: prompt gh auth refresh -s project
• Issue type fails: inform user to set manually
• Always preview and confirm before creating