Skip to content

README.md

Latest commit

 

History

History
158 lines (119 loc) · 5.53 KB

README.md

File metadata and controls

158 lines (119 loc) · 5.53 KB
Raw

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.