deepsource-mcp-server: Command for Claude Code

Spec a Feature

You are about to create a feature specification in Gherkin format and turn it into a GitHub issue ready for implementation.

Process

1. Gather Requirements

   • Ask the user for the feature name and description if not provided
   • Understand the business value and user needs
   • Identify scope, non-goals, and risks

2. Write Gherkin Specification Create a comprehensive specification including:

   • Feature name and description
   • Background (if needed)
   • Scenarios using Given/When/Then format
   • Examples with data tables where appropriate
   • Acceptance Criteria
   • Non-Goals (what this feature won't do)
   • Risks & Mitigations
   • Technical Considerations

3. Format as GitHub Issue Structure the issue with:

   • Clear title: feat: [Feature Name]
   • Labels: enhancement, needs-implementation
   • Milestone (if applicable)
   • Complete Gherkin specification in the body
   • Testing requirements

4. Create the Issue Use the gh CLI to create the issue:

   gh issue create --title "feat: [Feature Name]" \
     --body "[Full specification]" \
     --label enhancement \
     --label needs-implementation
   

Template for Issue Body

## Feature: [Feature Name]

### Business Value

[Describe the business value and user benefit]

### User Story

As a [type of user]
I want [goal/desire]
So that [benefit/value]

### Gherkin Specification

```gherkin
Feature: [Feature Name]
  [Feature description explaining the feature's purpose]

  Background:
    Given [common preconditions for all scenarios]

  Scenario: [Happy path scenario]
    Given [initial context]
    When [action/event]
    Then [expected outcome]
    And [additional outcomes]

  Scenario: [Edge case or error scenario]
    Given [initial context]
    When [action/event]
    Then [expected outcome]

  Scenario Outline: [Parameterized scenario if needed]
    Given [context with <parameter>]
    When [action with <parameter>]
    Then [outcome with <expected>]