🚀 Sprint Agent — VS Code Extension

An AI-powered sprint enforcement agent that lives in your VS Code sidebar. Tracks your sprint workflow, generates PR templates, enforces ZTest requirements, and ensures every story is properly closed.

Installation

Option A: Install from VSIX (Recommended)

1. Open VS Code
2. Press Ctrl+Shift+P → type "Install from VSIX"
3. Select the sprint-agent-1.0.0.vsix file
4. Reload VS Code

Option B: Development Mode

1. Copy this folder to your machine
2. Open it in VS Code
3. Press F5 to launch the Extension Development Host

Features

🗂️ Sprint Dashboard Sidebar

Click the rocket icon 🚀 in the VS Code Activity Bar to open the Sprint Agent panel.

5 tabs covering the full sprint lifecycle:

Progress is saved automatically across VS Code sessions.

📝 Generate PR Template

Command: Sprint Agent: Generate PR Description
Shortcut: Ctrl+Shift+P → search "Sprint Agent: Generate PR"

Generates a complete PR markdown template with:

• Linked story/bug field
• Full PR checklist (unit tests, ZTests, edge cases, screenshots)
• Dev testing details section
• Screenshot table for UI changes
• Reviewer notes

🧪 Generate ZTest Template

Command: Sprint Agent: Generate ZTest Template

Creates a structured ZTest plan markdown file with:

• Positive scenarios table
• Negative scenarios table
• Edge cases table
• Validation scenarios table
• Error handling scenarios table
• Automation data-testid tracking
• QA sign-off section

📋 Story Validator

Command: Sprint Agent: Validate Story Checklist

Opens a popup validator to verify a story is ready before development begins — checks all 14 required items including subtasks, labels, ZTests, and QA review.

✅ End of Sprint Checklist

Command: Sprint Agent: End of Sprint Checklist

A focused checklist for sprint closure with progress bar. Blocks sprint from closing until all 9 items are confirmed.

⚠️ Automatic data-testid Reminder

When you save a .js, .ts, or .tsx file containing interactive elements (button, input, form, etc.) without data-testid, Sprint Agent shows a warning notification automatically.

Keyboard Shortcuts

Command Palette Reference

Open with Ctrl+Shift+P and search "Sprint Agent":

Sprint Rules Enforced

🔴 Blocking (Will not be approved)

• PRs without unit test screenshot
• Incomplete ZTests (not QA-approved)
• Closing tickets without all checklist items

🟡 Required

• ZTests written at sprint start — not end
• Yangyang and Chaitanya in demo sessions
• Feature branch deployed to Dev before demo
• data-testid on all interactive elements
• Reviewer provides comments (not just approval)

📋 Every Story Needs These 4 Subtasks

1. GC Component update
2. Label update
3. Log hours
4. Fix version

Building the VSIX Package

cd sprint-agent-vscode
npm install -g @vscode/vsce
vsce package

This produces sprint-agent-1.0.0.vsix ready for distribution.

Tech Stack

• Pure VS Code Extension API (no external dependencies)
• Webview panels with vanilla JS
• Persistent state via context.globalState
• Git branch detection via child_process

Sprint Agent v1.0.0 — Keep your sprints clean 🚀