Skip to content

nordicsushi/Efficient-communication-at-workplace

Repository files navigation

Meeting Mind Flow πŸŽ€πŸ’­

A comprehensive guide to effective communication in tech company meetings. This project provides structured speaking flows and natural expressions to help you communicate confidently and professionally in various meeting scenarios.

πŸ“‹ Overview

Meeting Mind Flow is a practical resource for software engineers and tech professionals who want to improve their communication skills in workplace meetings. It provides:

  • Visual flowcharts showing the natural progression of communication in different meeting types
  • Ready-to-use expressions for each step of the conversation
  • Natural, conversational language that sounds professional yet approachable
  • Customizable outputs tailored to your specific job role, years of experience (YoE), job responsibilities and company context

The automated script allows you to generate personalized communication guides that match your unique professional profile, making the content more relevant and actionable for your specific situation.

🎯 What's Inside

Meeting Types Covered

  1. Daily Stand-up Meeting (Attendee)
  2. Weekly Stand-up Meeting (Attendee)
  3. Knowledge Sharing Meeting (Facilitator/Chair)
  4. Technical Meeting / Code Review (Presenter/Communicator)

πŸš€ How to Run

This project includes automated scripts to generate customized communication guides for multiple job roles and meeting types.

Prerequisites

  • Python 3.10 or higher
  • uv package manager (or pip)
  • GitHub Copilot CLI (for AI-assisted task completion)

Quick Start

  1. Clone the repository:

    git clone <repository-url>
    cd Efficient-communication-at-workplace
  2. Install dependencies:

    make install
  3. Run the automation script:

    make run

Available Make Commands

  • make install - Set up Python environment and install dependencies
  • make run - Execute the batch processing workflow for all predefined roles

Behind the Scenes

  1. Environment Setup (make install):

    • Creates a Python virtual environment (.venv)
    • Installs required dependencies from requirements.txt
  2. Batch Processing (make run):

    • Loads job roles from data/role_meeting_type.json
    • For each role, generates a customized coordinator.md
    • Runs GitHub Copilot CLI with claude-sonnet-4.5 model
    • Automatically completes communication guide tasks

Manual Usage

If you prefer to run components separately:

# Set up environment
make install

# Generate coordinator for a specific role
python render_prompts.py --job "DevOps Engineer" --yoe 4 --company "Netflix" --jr "Manage CI/CD pipelines and infrastructure"

# View the generated file
cat coordinator.md

πŸ“– How to Use the Resources

For Visual Learners

  1. Open examples/task-stage-1-output.md to view the Mermaid flowcharts
  2. Follow the flow diagram for your meeting type
  3. Use the color-coded nodes to understand decision points and actions

For Expression Reference

  1. Open examples/task-stage-2-output.md to browse ready-to-use expressions
  2. Find your meeting type and specific speaking step
  3. Choose an expression that fits your situation and personal style

πŸ’‘ Key Features

Natural & Conversational

All expressions are designed to sound like real tech professionals speaking, not corporate robots:

  • Uses contractions and natural fillers
  • Includes thought processes ("I think...", "Maybe...")
  • Balances professionalism with approachability

Versatile Options

Each speaking step includes 5 different expressions, giving you:

  • Flexibility to match your personal style
  • Options for different contexts and moods
  • Variety to avoid sounding repetitive

πŸ“Š Example: Daily Stand-up Meeting

Here's a complete example showing both the communication flow and ready-to-use expressions for a daily stand-up meeting.

Flow Diagram

graph TD
    A[Join Meeting] --> B[Listen to Moderator]
    B --> C[Wait for Turn]
    C --> D[Greet Team]
    D --> E[Share Yesterday's Progress]
    E --> F[Share Today's Plan]
    F --> G[Mention Blockers if Any]
    G --> H[Listen to Other Teammates]
    H --> I{Need to Follow Up?}
    I -->|Yes| J[Ask Clarifying Questions]
    I -->|No| K[Take Notes]
    J --> K
    K --> L{All Team Members Done?}
    L -->|No| H
    L -->|Yes| M[Thank Team and Sign Off]
    M --> N[End Meeting]
    
    style D fill:#4A90E2,stroke:#2E5C8A,color:#fff
    style E fill:#4A90E2,stroke:#2E5C8A,color:#fff
    style F fill:#4A90E2,stroke:#2E5C8A,color:#fff
    style G fill:#4A90E2,stroke:#2E5C8A,color:#fff
    style J fill:#4A90E2,stroke:#2E5C8A,color:#fff
    style M fill:#4A90E2,stroke:#2E5C8A,color:#fff
Loading

Sample Expressions

Case 1: Daily Stand-up Meeting (Attendee Role)

Greet Team
  1. "Hey everyone, good morning!"
  2. "Morning team!"
  3. "Hey folks, hope everyone's doing well today."
  4. "Good morning all!"
  5. "Hey team, thanks for joining."
Share Yesterday's Progress
  1. "So yesterday I wrapped up the CI/CD pipeline migration for the staging environment. Got everything tested and deployed."
  2. "Yesterday was pretty productive - I finished up the monitoring dashboard refactoring and deployed it to production."
  3. "I spent most of yesterday debugging the deployment issues we had with the Kubernetes cluster. Got that sorted out and everything's running smoothly now."
  4. "Yesterday I knocked out the ticket for automating the backup scripts. Also did a quick review on Sarah's PR for the infrastructure changes."
  5. "I made good progress on the Terraform modules yesterday. Got through about 70% of the refactoring work."
Share Today's Plan
  1. "Today I'm planning to start on the load balancer configuration for the new microservice and hopefully get that done by end of day."
  2. "For today, I'll be focusing on the security audit follow-ups. Want to get those critical findings addressed first."
  3. "I'm going to continue with the database migration prep work today, and I also have that meeting with the security team this afternoon."
  4. "Today's all about getting the monitoring alerts fine-tuned. I've been getting too many false positives, so want to clean that up."
  5. "I'll be working on the Docker image optimization today. Also want to pair with Mike on the networking issue if he has time."
Mention Blockers if Any
  1. "No blockers on my end."
  2. "Everything's good here, no blockers."
  3. "I do have one blocker actually - I'm waiting on the security team to approve those firewall rule changes before I can proceed with the deployment."
  4. "Just a heads up, I'm a bit blocked on the API integration. Need access to the production credentials, so if someone from the platform team could help me out with that, that'd be great."
  5. "All good here, though I might need some input from the architecture team later this week on the scaling strategy."
Ask Clarifying Questions
  1. "Hey Sarah, just a quick question on what you mentioned - are you saying the issue is happening in all environments or just production?"
  2. "Mike, when you say you're refactoring the auth service, does that impact the endpoints we're currently using, or is it all backward compatible?"
  3. "Quick follow-up on that - do we need to coordinate our deployments, or can I go ahead with mine independently?"
  4. "Just to clarify, is that something we need to prioritize this week, or can it wait until next sprint?"
  5. "That sounds interesting - could you drop a link to that doc in the chat? I'd like to take a look."
Thank Team and Sign Off
  1. "Alright, sounds good everyone. Thanks, and have a great day!"
  2. "Cool, thanks team. Catch you all later!"
  3. "Perfect, appreciate the updates everyone. Have a good one!"
  4. "Great, thanks all. See you tomorrow!"
  5. "Awesome, thanks everyone. Let me know if you need anything from me."

πŸ’‘ Tip: Mix and match expressions to find your natural speaking style. The goal is to sound professional yet conversational!

For more meeting types and complete expression lists, check out the examples/ folder.

πŸŽ“ Communication Tips

  1. Be Concise: Respect everyone's time
  2. Be Prepared: Know what you want to say before speaking
  3. Be Clear: Use simple language, avoid unnecessary jargon
  4. Be Engaged: Listen actively to others
  5. Be Positive: Maintain a constructive tone
  6. Follow Up: Always close the loop on action items

πŸ“ Use Cases

This resource is perfect for:

  • βœ… New engineers joining a tech company
  • βœ… Non-native English speakers improving workplace communication
  • βœ… Anyone who feels nervous speaking in meetings
  • βœ… Team leads facilitating meetings
  • βœ… Engineers presenting technical solutions
  • βœ… Anyone wanting to sound more natural and confident

🀝 Contributing

Contributions are welcome! If you have:

  • Additional meeting types to cover
  • Better expressions or phrases
  • Real-world examples that worked well
  • Improvements to the flows

Feel free to open an issue or submit a pull request.

πŸ™ Acknowledgments

  • Inspired by real meeting transcripts from tech professionals
  • Designed for the global tech community
  • Built to help engineers communicate with confidence

πŸ“¬ Contact

Have questions or suggestions? Feel free to open an issue on GitHub.


Remember: The goal isn't to memorize scripts, but to internalize natural communication patterns. Use these as guides, adapt them to your style, and with practice, confident communication will become second nature! πŸš€


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published