Running Effective Standup Meetings for Engineering Teams

// ❌ The dysfunctional standup
interface BadStandup {
  format: 'individual status reports';
  duration: '25-35 minutes';  // Always runs over
  participants: 12;            // Too many people
  attention: 'everyone checks Slack until their turn';
  outcome: 'manager got status updates, team learned nothing';
  blockers: 'mentioned in passing, never followed up';
}
 
// ✅ The effective standup
interface GoodStandup {
  format: 'work-focused synchronization';
  duration: '10-15 minutes';
  participants: '5-7 (one team)';
  attention: 'everyone listens because topics are relevant';
  outcome: 'blockers identified and assigned, dependencies surfaced';
  blockers: 'resolved or escalated before the meeting ends';
}

// Walk-the-board standup format
interface WalkTheBoardStandup {
  // Step 1: Start from the rightmost column (closest to done)
  reviewOrder: 'right-to-left';
  columns: ['Done', 'In Review', 'In Progress', 'Blocked', 'To Do'];
 
  // Step 2: For each item in "In Review" or "Blocked"
  focusQuestions: [
    'What does this need to move forward?',
    'Who is blocking this? Can we resolve it now?',
    'Has this been in review for more than a day? Why?',
  ];
 
  // Step 3: Quick scan of "In Progress"
  inProgressCheck: 'Any surprises? Anything taking longer than expected?';
 
  // Step 4: Skip "To Do" — that's for sprint planning, not standup
  skipToDo: true;
}

// ❌ Person-by-person standup
const personByPerson = [
  'Alice: "Yesterday I worked on the auth refactor. Today I will continue. No blockers."',
  'Bob: "Yesterday I reviewed PRs. Today I will work on the billing API. No blockers."',
  'Carol: "Yesterday I fixed a CSS bug. Today I will start the notification feature. No blockers."',
  // 8 more people say similar things. Meeting takes 30 minutes.
  // Nobody learns anything useful.
];
 
// ✅ Walk-the-board standup
const walkTheBoard = [
  'Facilitator: "BILLING-42 has been in review for 2 days. Bob, who is reviewing?"',
  'Bob: "I am — I had a question about the error handling. Let me finish today."',
  'Facilitator: "AUTH-15 is blocked. Alice, what do you need?"',
  'Alice: "I need the new API key from the platform team. Carol, can you ask them?"',
  'Carol: "I will ping them right after standup."',
  'Facilitator: "Everything else looks on track. Done in 8 minutes."',
  // Blockers identified and assigned. Everyone moves forward.
];

// Time-boxing rules
const standupRules = {
  maxDuration: 15,  // minutes, hard stop
  
  // Use a visible timer — not optional
  timer: 'visible to everyone',
  
  // If a discussion needs more than 2 minutes, take it offline
  deepDiveThreshold: '2 minutes',
  parkingLot: 'Note the topic, schedule a follow-up immediately',
  
  // The facilitator's job
  facilitator: {
    keepsMeetingMoving: true,
    cutLongDiscussions: '"Let us take this offline — Alice and Bob, stay after standup"',
    tracksFollowUps: true,
    rotatesWeekly: true,  // Everyone takes a turn facilitating
  },
};
 
// Parking lot pattern for deep discussions
interface ParkingLot {
  topic: string;
  participants: string[];  // Only the people who need to be there
  scheduledTime: string;   // Immediately after standup or later that day
}
 
// Example parking lot items from a standup
const parkingLotItems: ParkingLot[] = [
  {
    topic: 'Database migration strategy for BILLING-42',
    participants: ['Alice', 'Bob'],
    scheduledTime: 'Right after standup',
  },
  {
    topic: 'Should we switch to the new auth provider?',
    participants: ['Alice', 'Carol', 'Tech Lead'],
    scheduledTime: '2:00 PM',
  },
];

// Async standup format — posted in a dedicated Slack channel
interface AsyncStandupPost {
  // Focus on what matters to the team, not status reporting
  sections: {
    needsHelp: string;           // "I'm stuck on X, need Y from Z"
    willFinish: string;          // "I will ship PR #123 today"
    fyi: string;                 // "The staging deploy pipeline is broken"
  };
  
  // NOT included (these are anti-patterns for async):
  excluded: [
    'what I did yesterday',       // Nobody cares — it's in git log
    'detailed status updates',    // Use your project management tool
  ];
}
 
// Example async standup messages
const asyncExamples = [
  {
    author: 'Alice',
    needsHelp: 'Blocked on BILLING-42: need Bob to approve my PR',
    willFinish: 'Will finish the notification preferences API',
    fyi: '',
  },
  {
    author: 'Bob',
    needsHelp: '',
    willFinish: 'Reviewing Alice\'s PR and shipping SEARCH-19',
    fyi: 'Heads up: the search index rebuild will run tonight at 2 AM UTC',
  },
];

// ❌ Async standup that's just a status dump
const badAsync = `
  **Yesterday:** Worked on billing API. Fixed some bugs. Had meetings.
  **Today:** Continue billing API. More meetings.
  **Blockers:** None.
`;
// Zero useful information. Could be generated by a bot.
 
// ✅ Async standup that drives action
const goodAsync = `
  **Needs help:** BILLING-42 PR is ready — @bob can you review today?
  The migration script needs your database expertise.
  
  **Shipping today:** Notification preferences API (PR #456)
  
  **FYI:** Found a race condition in the payment webhook handler.
  Filed INCIDENT-89. Not urgent but should fix this sprint.
`;
// Clear asks, deadlines, and actionable information.

interface StandupMetrics {
  // Time metrics
  averageDuration: number;          // Target: < 15 minutes
  percentOverTime: number;          // Target: < 10%
  
  // Effectiveness metrics
  blockersIdentified: number;       // Per week
  blockersResolvedSameDay: number;  // Target: > 80%
  averageTimeInBlocked: number;     // Days — should decrease
  
  // Engagement metrics
  attendanceRate: number;           // Should be high if useful
  topicsTakenOffline: number;       // Shows discipline in time-boxing
  
  // Qualitative
  teamSentiment: 'useful' | 'tolerable' | 'waste-of-time';
}
 
function assessStandupHealth(metrics: StandupMetrics): string {
  if (metrics.averageDuration > 20) return 'Too long — enforce time-boxing';
  if (metrics.blockersResolvedSameDay < 0.5) return 'Blockers not being resolved — improve follow-through';
  if (metrics.teamSentiment === 'waste-of-time') return 'Rethink format — try walk-the-board or async';
  return 'Healthy';
}