Skip to content

guptasoumya26/SprintSight-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SprintSight AI 🚀

AI-powered Chrome extension that transforms Jira sprint boards into actionable insights

Turn sprint chaos into clarity with intelligent analysis of your team's workload, burnout risks, and actionable recommendations.

Features ✨

🔍 Smart Sprint Analysis - Automatically extracts and analyzes all sprint issues
⚠️ Burnout Detection - Identifies team members at risk of overload
💡 AI Recommendations - Provides specific suggestions to improve sprint outcomes
📊 Beautiful Reports - Clean, visual summaries with emojis and clear sections
📋 PDF Export - Generate shareable reports for stakeholders

Quick Start 🛠️

Installation

  1. Download all project files to a local folder
  2. Open config.js and add your OpenAI API key:
    window.OPENAI_API_KEY = "your-api-key-here";
  3. Go to chrome://extensions/ in Chrome
  4. Enable "Developer mode" (top right toggle)
  5. Click "Load unpacked" and select your project folder

Usage

  1. Navigate to your Jira sprint board 📋
  2. Click the SprintSight AI extension icon 🔥
  3. Hit "Analyze Sprint" and wait for AI magic ✨
  4. Review insights and export PDF if needed 📄

How It Works 🔧

Data Extraction: Content script reads your Jira board using stable DOM selectors and accessibility labels, avoiding fragile CSS selectors that break with UI updates.

AI Analysis: Sends sprint context (timeline, workload, progress) to OpenAI GPT-3.5 with carefully crafted prompts that understand project management principles.

Smart Presentation: Transforms AI responses into visually appealing cards with icons, emojis, and clear sections for immediate understanding.

File Structure 📁

├── manifest.json       # Extension configuration and permissions
├── content.js         # Extracts data from Jira pages
├── popup.html         # User interface layout
├── popup.js          # Main logic and AI integration
├── style.css         # Visual styling and layout
└── config.js         # API key configuration

Key Code Concepts 💡

Robust Data Extraction - Uses data-testid attributes and aria-labels instead of CSS classes:

// Reliable selector that survives UI changes
const cards = document.querySelectorAll('[data-testid="platform-board-kit.ui.card.card"]');

Smart AI Prompting - Provides rich context for better analysis:

const prompt = `Sprint context: ${numTodo} issues in To Do, ends in 3 days...`;

Progressive Loading States - Builds user anticipation:

const messages = ["👀 Seeing the sprint...", "🤖 Crunching numbers..."];

Customization 🎨

Modify Data Fields: Update selectors in content.js for your Jira setup
Enhance AI Prompts: Add team-specific context in popup.js
Style Changes: Adjust colors and layout in style.css
New Features: Extend analysis types or add integrations

Troubleshooting 🔍

No Data Found: Check if your Jira uses different selectors - inspect DOM and update content.js
API Errors: Verify your OpenAI key in config.js and ensure sufficient credits
Loading Issues: Clear extension cache and reload, check console for errors

Security Notes 🔒

⚠️ API Key: Currently stored in plain JavaScript - consider secure alternatives for production
🔐 Data Privacy: Sprint data is sent to OpenAI servers for analysis
🛡️ Permissions: Extension only runs on Atlassian domains with minimal required permissions

What You'll Learn 📚

Building SprintSight teaches you how to create intelligent browser extensions that combine web scraping, AI integration, and great user experience design. The code demonstrates practical patterns for DOM manipulation, API integration, and progressive enhancement that you can apply to your own productivity tools.


Ready to eliminate sprint planning confusion? Install SprintSight AI and let artificial intelligence bring clarity to your Agile workflow! 🎉

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published