Detect team burnout with Groq AI analysis of GitHub activity for wellness reports

Team Wellness - AI Burnout Detector Agent devex github 🎯 Demo sample report github action code alternative How it works 🎯 Overview A comprehensive n8n workflow that analyzes developer workload patterns from GitHub repositories to detect potential software engineering team burnout risks and provide actionable team wellness recommendations. This workflow automatically monitors team activity patterns, analyzes them using AI, and provides professional wellness reports with actionable recommendations which will automate GitHub issue creation and do email notifications for critical alerts. ✨ Features - Automated Data Collection: Fetches commits, pull requests, and workflow data from GitHub - Pattern Analysis: Identifies late-night work, weekend activity, and workload distribution - AI-Powered Analysis: Uses Groq's LLM for professional burnout risk assessment - Automated Actions: Creates GitHub issues and sends email alerts based on criticality - Professional Guardrails: Ensures objective, evidence-based analysis with privacy protection - Scheduled Monitoring: Weekly automated wellness checks 🏗️ Architecture 1. Data Collection Layer - GitHub Commits API: Fetches commit history and timing data - GitHub Pull Requests API: Analyzes collaboration patterns - GitHub Workflows API: Monitors CI/CD pipeline health 2. Pattern Analysis Engine - Work Pattern Signals: Late-night commits, weekend activity - Developer Activity: Individual contribution analysis - Workflow Health: Pipeline success/failure rates - Collaboration Metrics: PR review patterns and merge frequency 3. AI Analysis Layer - Professional Guardrails: Objective, evidence-based assessments - Risk Assessment: Burnout risk classification (Low/Medium/High) - Health Scoring: Team wellness score (0-100) - Recommendation Engine: Actionable suggestions for improvement 📊 Sample Output 🚀 Quick Start Prerequisites - n8n instance (cloud or self-hosted) - GitHub repository with API access - Groq API key - Gmail account (optional, for email notifications) Setup Instructions 1. Import Workflow 2. Configure Credentials - GitHub API: Create a personal access token with repo access - Groq API: Get your API key from Groq Console - Gmail OAuth2: Set up OAuth2 credentials for email notifications 3. Update Configuration 4. Test Workflow - Run the workflow manually to verify all connections - Check that data is being fetched correctly - Verify AI analysis is working 5. Schedule Automation - Enable the schedule trigger for weekly reports - Set up monitoring for critical alerts 🔧 Configuration Configuration Node Settings - repoowner: GitHub username or organization - reponame: Repository name - period: Analysis period in days (default: 7) - emailreport: Email address for critical alerts AI Model Settings - Model: openai/gpt-oss-120b (Groq) - Temperature: 0.3 (for consistent analysis) - Max Tokens: 2000 - Safety Settings: Professional content filtering 📈 Metrics Analyzed Repository-Level Metrics - Total commits count - Pull requests opened/closed - Workflow runs and success rate - Failed workflow percentage Work Pattern Signals - Late-night commits (10PM-6AM) - Weekend commits (Saturday-Sunday) - Work intensity patterns - Collaboration bottlenecks Developer-Level Activity - Individual commit counts - Late-night activity per developer - Weekend activity per developer - Workload distribution fairness 🛡️ Privacy & Ethics Professional Guardrails - Never makes personal judgments about individual developers - Only analyzes observable patterns in code activity data - Always provides evidence-based reasoning for assessments - Never suggests disciplinary actions or performance reviews - Focuses on systemic issues and team-level recommendations - Respects privacy and confidentiality of team members Data Protection - No personal information is stored or transmitted - Analysis is based solely on public repository data and public data - All recommendations are constructive and team-focused - Confidence scores indicate analysis reliability - There is added redaction prompt. Note that LLM is not deterministic and usually, you will need to refine your own prompt to enhance difference level of criticality of privacy you need censored or displayed. In some cases ,you will need the engineer account names to help identify f2f conversation. 🔄 Workflow Nodes Core Nodes 1. Schedule Trigger: Weekly automation (configurable) 2. Config: Repository and email configuration 3. Github Get Commits: Fetches commit history 4. Github Get Workflows: Retrieves workflow runs 5. Get Prs: Pulls pull request data 6. Analyze Patterns Developer: JavaScript pattern analysis 7. AI Agent: Groq-powered analysis with guardrails 8. Update Github Issue: Creates wellness tracking issues 9. Send a message in Gmail: Email notifications Data Flow 🚨 Alert Levels (Optional and Prompt configurable) Critical Alerts (Health Score < 90) - GitHub Issue: Automatic issue creation with detailed analysis - Email Notification: Immediate alert to team leads - Slack Integration: Critical team notifications Warning Alerts (Health Score 90-95) - GitHub Issue: Tracking issue for monitoring - Slack Notification: Team awareness message Normal Reports (Health Score > 95) - Weekly Report: Comprehensive team health summary - Slack Summary: Positive reinforcement message 🔧 Troubleshooting Common Issues 1. GitHub API Rate Limits - Solution: Use authenticated requests, implement rate limiting - Check: API token permissions and repository access 2. AI Analysis Failures - Solution: Verify Groq API key, check model availability - Check: Input data format and prompt structure 3. Email Notifications Not Sending - Solution: Verify Gmail OAuth2 setup, check email permissions - Check: SMTP settings and authentication 4. Workflow Execution Errors - Solution: Check node connections, verify data flow - Check: Error logs and execution history 🤝 Contributing Development Setup 1. Fork the repository link above demo part 2. Create a feature branch 3. Make your changes 4. Test thoroughly 5. Submit a pull request Testing - Test with different repository types - Verify AI analysis accuracy - Check alert threshold sensitivity - Validate email and GitHub integrations 📄 License This project is licensed under the MIT License 🙏 Acknowledgments - Groq: For providing the AI analysis capabilities - GitHub: For the comprehensive API ecosystem - n8n: For the powerful workflow automation platform - Community: For feedback and contributions 📞 Support Getting Help - Issues: Create a GitHub issue for bugs or feature requests - Discussions: Use GitHub Discussions for questions - Documentation: Check the comprehensive setup guides Contact - Email:aiix.space.noreply@gmail.com - LinkedIn: SeanLon --- ⚠️ Important: This tool is designed for team wellness monitoring and should be used responsibly. Always respect team privacy and use the insights constructively to improve team health and productivity.