Manager Square (Manager²) — Management Productivity Tool

Manager Square is a comprehensive PySide6 desktop application designed to enhance management productivity through evidence-based practices and intelligent automation.

🚀 Features

Core Management Tools

• 📊 Dashboard - KPIs, burnout risk assessment, and team overview
• 📋 Eisenhower Task Board - Auto-classified task prioritization (Q1-Q4)
• 🎯 OKR Management - Objectives & Key Results with progress tracking
• 👥 1:1 Meetings - Structured templates and notes for team meetings
• 💡 Nudge Center - Evidence-based management practices and reminders
• 🎓 Coach Panel - Radical Candor, delegation, and conversation frameworks
• ⏰ Meeting Optimizer - Cost analysis and hygiene recommendations
• 🤝 Delegation Assistant - Smart owner suggestions based on skills and workload
• ❤️ Team Health Monitor - Weekly pulse surveys and wellness tracking
• 📈 GVA Map - Guaranteed Value Add scoring (0-1) for team members
• 📄 Manager README - Automated generation of management documentation

Advanced Features

• 🚨 Incident Management - Severity tracking and resolution workflows
• 🏆 Rewards System - Performance-based coin tracking and leaderboards
• 🎯 Talent Analytics - Skill assessment and development tracking
• 📊 Org Digest - Automated organizational health reports
• 🔧 Bench Projects - Internal capacity and development initiatives
• 🎲 Big Bets - Strategic initiative tracking with stage progression
• ⚙️ Settings & Configuration - Customizable thresholds and parameters
• 📤 Import/Export - CSV data exchange and markdown report generation

🛠️ Installation

Prerequisites

• Python 3.8 or higher
• pip package manager

Quick Start

# Clone or download the repository
cd mgrsquare

# Install dependencies
pip install -r requirements.txt

# Run the application
python -m managersquare.app

Alternative: Single-File Version

For a standalone experience with all advanced features:

python managersquare_single.py

📁 Project Structure

mgrsquare/
├── managersquare/           # Modular version (recommended)
│   ├── core/               # Core business logic
│   │   ├── models.py       # Data models
│   │   ├── storage.py      # Database operations
│   │   └── insights.py     # Analytics and calculations
│   ├── ui/                 # User interface
│   │   ├── main_window.py  # Main application window
│   │   └── widgets/        # Individual feature widgets
│   ├── data/               # Static data and templates
│   └── app.py              # Application entry point
├── managersquare_single.py # Single-file version with all features
├── requirements.txt        # Python dependencies
└── README.md              # This file

🎯 Getting Started

1. Launch the Application: Run python -m managersquare.app
2. Add Team Members: Use the Dashboard to add your team members
3. Create Tasks: Use the Task Board to add and prioritize work
4. Set OKRs: Define objectives and key results for the quarter
5. Schedule 1:1s: Use the 1:1 module to plan team meetings
6. Apply Nudges: Browse evidence-based management practices
7. Monitor Health: Track team wellness and burnout indicators

🔧 Configuration

The application stores data in ~/.managersquare/manager.db and exports in ~/.managersquare/exports/.

Key Settings (Single-file version)

• Burnout risk thresholds
• Coin reward weights
• MTTR (Mean Time To Resolution) targets
• OKR progress thresholds

📊 Data Management

Import/Export

• CSV Export: Tasks, team members, and OKRs
• Markdown Reports: Manager README, talent picks, org digest
• Database Backup: Full SQLite database export

Backup Recommendations

Regularly export your data using the Import/Export module to prevent data loss.

🎨 Customization

UI Themes

The application uses PySide6's native styling. You can customize colors and fonts through the Settings panel.

Evidence-Based Practices

The Nudge Center includes practices from:

• Amy Edmondson - Psychological Safety
• Kim Scott - Radical Candor
• Atlassian - Team Playbook
• John Doerr - Measure What Matters
• Andy Grove - High Output Management

🐛 Troubleshooting

Common Issues

Application won't start:

# Ensure PySide6 is installed
pip install PySide6

# Check Python version
python --version  # Should be 3.8+

Database errors:

• The app creates ~/.managersquare/ directory automatically
• Delete the directory to reset all data (⚠️ This will delete all your data)

Performance issues:

• Large datasets may slow down the interface
• Use the Import/Export feature to archive old data

🤝 Contributing

This is a management productivity tool focused on evidence-based practices. Contributions that enhance:

• Management frameworks integration
• Data visualization improvements
• Performance optimizations
• User experience enhancements

Are welcome!

📜 License

This project is provided as-is for management productivity enhancement. Use responsibly and in accordance with your organization's policies.

🙏 Acknowledgments

Built with evidence-based management practices from leading management thinkers and frameworks. Special thanks to the PySide6 team for the excellent GUI framework.

---

Manager Square - Managing the manager to manage with power-tools.