Ticket

/ticket - Create GitHub Issue via Interview

Create a well-structured GitHub issue through a guided interview process. Explores the codebase to provide intelligent suggestions, then asks batched questions to gather all required information.

Core Principles

Phase 1: Codebase Exploration

Step 1.1: Parse the Request

From $ARGUMENTS, identify:

**Request Analysis**

**Intent:** [feature/bug/refactor/docs/other]
**Domain:** [area of codebase affected]
**Keywords:** [technical terms for searching]
**Complexity:** [simple/medium/complex]

Step 1.2: Detect Repository

gh repo view --json nameWithOwner,url --jq '"\(.nameWithOwner) - \(.url)"'

Step 1.3: Explore Entry Points

Run parallel searches to find relevant files:

1. Semantic search for the domain/feature area
2. Grep for specific keywords mentioned in the request
3. List directories that match the domain

Step 1.4: Find Reference Implementations

Search for similar patterns in the codebase to identify files to modify and patterns to follow.

Step 1.5: Check Available Labels

gh label list --limit 50 2>/dev/null || echo "LABELS_UNAVAILABLE"

Step 1.6: Assess Complexity

Step 1.7: Present Exploration Summary

Based on "$ARGUMENTS", I found:

**Entry Points:** [N files]
- `path/to/file1` - [why relevant]
- `path/to/file2` - [why relevant]

**Reference Implementations:**
- `path/to/similar` - [pattern to follow]

I'll ask questions in 3 batches to create a well-structured issue.

Phase 2: Batched Interview

Batch 1: Core Understanding

**Batch 1 of 3: Core Understanding**

1. **Summary**: In one sentence, what should this change accomplish and why?

2. **Type**: What kind of change is this?
   - Feature (new capability)
   - Bug fix (broken functionality)
   - Refactor (restructure without behavior change)
   - Docs (documentation only)
   - Other (describe)

3. **Scope Confirmation**: Based on my exploration, I found:

   **Entry Points:**
   - `[file1]` - [why relevant]

   **Reference Implementations:**
   - `[file2]` - [similar pattern to follow]

   Are these correct? Anything to add or remove?

Reply with your answers (numbered 1-3).

STOP. Wait for user response.

Batch 2: Requirements & Acceptance

**Batch 2 of 3: Requirements & Acceptance Criteria**

4. **Requirements**: What specific things must be implemented?
   List 2-5 concrete, implementable items.

5. **Acceptance Criteria**: How do we know when it's done?
   List testable conditions.

6. **Out of Scope**: What should this NOT include?

Reply with your answers (numbered 4-6).

STOP. Wait for user response.

Batch 3: Testing & Context

**Batch 3 of 3: Testing & Context**

7. **Test Scenarios**: Describe 2-4 scenarios to verify the implementation:
   Format: [Action] → [Expected Result]

8. **Dependencies**: Does this depend on or block anything?
   - Requires: [library, API, other work]
   - Blocked by: #[issue] (if any)

9. **Priority**: How urgent is this?
   - P0: Critical/blocking
   - P1: High priority
   - P2: Normal priority
   - P3: Nice to have

10. **Additional Context**: Anything else relevant?

Reply with your answers (numbered 7-10), or "skip" for optional ones.

STOP. Wait for user response.

Phase 3: Issue Generation

Step 3.1: Determine Title

Based on type answer:

• Feature → feat: [concise description]
• Bug fix → fix: [concise description]
• Refactor → refactor: [concise description]
• Docs → docs: [concise description]
• Other → chore: [concise description]

Step 3.2: Construct Issue Body

## Summary

[User's summary - one clear paragraph explaining what and why]

## Requirements

- [ ] [Requirement 1 - concrete, implementable]
- [ ] [Requirement 2]
- [ ] [Requirement 3]

## Acceptance Criteria

- [ ] [Criterion 1 - testable condition]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

## Files & Context

### Entry Points
- `path/to/file1` - [reason for modification]

### Reference Implementations
- `path/to/similar` - [pattern to follow]

## Testing

### Test Scenarios
1. **[Scenario name]**: [Action] → [Expected result]

### Validation Steps
1. [Step to verify requirement]

## Additional Context

### Dependencies
- **Requires:** [dependencies if any]
- **Blocked by:** [blockers if any]

### Out of Scope
- [Exclusion 1]

### Priority
[P0/P1/P2/P3] - [brief justification]

[Any additional context provided by user]

Step 3.3: Preview and Confirm

---
## Issue Preview

**Title:** [type]: [description]
**Labels:** [suggested labels]
**Repository:** [detected repo]

---

[Full issue body]

---

**Options:**
1. **Create** - Create this issue now
2. **Edit** - Modify something before creating
3. **Cancel** - Exit without creating (I'll provide the markdown)

Which option?

STOP. Wait for user response.

Phase 4: Issue Creation

Step 4.1: Map Labels

Use only labels that exist in the repository (from Step 1.5).

Step 4.2: Create Issue

gh issue create \
  --title "[type]: [title]" \
  --body "[constructed body]" \
  --label "[comma-separated labels]"

Step 4.3: Confirmation

✅ **Issue created successfully!**

**Issue:** #[number]
**Title:** [title]
**URL:** [url]
**Labels:** [labels]

---

**Next Steps:**

To plan implementation:
  /issue [number]

To implement directly:
  /dev Implement GitHub issue #[number]: [title]

Error Handling

Provide issue body as markdown for manual creation, and instructions to install/authenticate the CLI.

No relevant files found

Proceed with the interview — the user will specify files manually in their scope confirmation answer.

Sparse user answers

Follow up once per section with what specific detail is missing. Accept "skip" to proceed.