BDD AI Toolkit

A powerful VS Code extension that simplifies Behavior-Driven Development (BDD) testing workflows through AI-driven technology. It supports test case generation, formatting, debugging, and management with seamless Azure DevOps integration.

Key Features

• AI Test Generation: Generate Gherkin format BDD test cases using Copilot
• Test Formatting: Automatically format and create test case overviews
• Test Debugging: Execute and debug Cucumber scenarios
• Azure DevOps Integration: Upload test cases to Azure DevOps test plans
• XMind Integration: Convert mind maps to structured text for requirement analysis

Installation

1. Open Extensions in VS Code
2. Search for "BDD AI Toolkit"
3. Click "Install"
4. Restart VS Code

Tool Usage Guide

Using Tools with Copilot Chat (Agent Mode)

1. AI Test Case Generation

Generate BDD test cases that follow Gherkin syntax.

Using Copilot Chat (Agent Mode):

1. Open VS Code Copilot Chat
2. Select agent mode and Claude 3.7 model
3. Type #testCasePromptGenerator followed by your test requirements
4. Drag reference materials into the chat, which can include:
   • Azure DevOps test plan CSV files
   • Markdown files converted from XMind (can be converted using the XMind Parser tool)

2. Test Case Formatting

Format test cases for better readability and create overviews.

Using Copilot Chat (Agent Mode):

1. Open VS Code Copilot Chat
2. Select agent mode and Claude 3.7 model
3. Type #formatTests followed by your request
4. Drag the .feature file into the chat

3. Cucumber Scenario Debugging

Execute and debug Cucumber scenarios directly in VS Code.

When you open a .feature file, you'll see interactive CodeLens buttons above each Scenario:

1. Automation Status Indicator:

   • Click to view implementation details of the test case
   • Scenarios are also visually marked with automation status (green arrow indicates automated scenarios)

2. Send to Copilot:

   • Click to debug and generate implementation code in Copilot
   • Requires installation of the appropriate MCP (Model Context Protocol)

3. Run:

   • Click to execute the test case implementation directly
   • Requires Python environment configuration (detailed instructions coming soon)

4. Azure DevOps Integration

Upload test cases to Azure DevOps test plans.

Required Configuration:

1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
2. Enter "BDD AI Toolkit: Configure ADO Settings"
3. You'll be prompted to enter:
   • Organization: Your Azure DevOps organization name (e.g., microsoft)
   • Project: Your Azure DevOps project name (e.g., Edge)
   • Personal Access Token (PAT): A token with Test Plan access rights

Alternatively, you can manually configure these in VS Code settings:

"bddAiToolkit.ado.organization": "your-organization",
"bddAiToolkit.ado.project": "your-project",
"bddAiToolkit.ado.personalAccessToken": "your-pat"

Using Copilot Chat (Agent Mode):

1. Open VS Code Copilot Chat
2. Select agent mode and Claude 3.7 model
3. Type #adoTestUploader followed by your upload request
4. Drag the .feature file you want to upload into the chat
5. Provide the following additional information when prompted:
   • Test Plan ID
   • Test Suite ID
   • Release version (optional)
   • Product name (optional)
   • Area Path (optional)

Note: The extension will mark uploaded test cases with their ADO IDs as comments in the feature file.

5. XMind Parser

Convert XMind mind maps to structured text for requirement analysis.

Using Copilot Chat (Agent Mode):

1. Open VS Code Copilot Chat
2. Select agent mode and Claude 3.7 model
3. Type #xmindToText followed by your request
4. Drag the XMind file you want to parse into the chat