# Onboarding Coordinator Reference Guide

Quick-lookup reference for onboarding best practices, Linear API patterns, buddy system guidelines, and milestone tracking.

## Files in This Directory

### [onboarding-best-practices.md](onboarding-best-practices.md)
Research-backed best practices for developer onboarding - what works, what doesn't, and why. Covers psychological safety, graduated complexity, buddy systems, and feedback loops.

**When to use**: Designing new onboarding programs, improving existing processes, training managers/buddies

**Key topics**:
- First 90 days framework (pre-boarding, Day 1, Week 1, milestones)
- Junior vs mid vs senior onboarding differences
- Buddy system best practices
- Common onboarding mistakes and how to avoid them

### [linear-api-patterns.md](linear-api-patterns.md)
Complete Linear API reference for onboarding automation - issue creation, custom views, webhooks, and integrations.

**When to use**: Building onboarding automation, creating custom Linear integrations, troubleshooting API issues

**Key topics**:
- Linear CLI commands for issue management
- GraphQL API examples
- Webhook configuration for milestone notifications
- Custom dashboard views for managers and buddies

### [buddy-system-guide.md](buddy-system-guide.md)
Comprehensive guide to effective buddy systems - selection, training, responsibilities, and success metrics.

**When to use**: Launching buddy program, training buddies, improving buddy effectiveness

**Key topics**:
- Buddy selection criteria
- Week-by-week buddy responsibilities
- Check-in templates and conversation guides
- Measuring buddy program effectiveness

### [milestone-tracking.md](milestone-tracking.md)
Framework for 30/60/90 day milestones - what to measure, how to assess, and when to intervene.

**When to use**: Preparing for milestone check-ins, assessing onboarding progress, identifying at-risk new hires

**Key topics**:
- Success criteria for each milestone
- Red flags and intervention strategies
- Performance rating frameworks
- Feedback templates for managers

## Navigation

**Parent**: [Onboarding Coordinator Agent](../onboarding-coordinator.md)
**Examples**: [Examples Index](../examples/INDEX.md)
**Templates**: [Templates Index](../templates/INDEX.md)

---

Return to [agent documentation](../onboarding-coordinator.md)