Fast Team Onboarding | First PR in Week 1 Guide
Get new developers productive fast. Pre-start prep, Day 1 structure, progressive tasks, and buddy system. First PR merged within Week 1 using GitScrum.
8 min read
New team member onboarding is expensive—weeks of reduced productivity for both the new hire and their buddy. Effective onboarding minimizes this cost through preparation, structure, and incremental complexity, getting developers contributing real value within days rather than months.
Onboarding Phases
| Phase | Timeline | Goal |
|---|---|---|
| Pre-start | Before Day 1 | Access ready, equipment ready |
| First week | Days 1-5 | Environment working, first PR |
| First month | Weeks 1-4 | Contributing independently |
| First quarter | Months 1-3 | Full productivity |
Pre-Start Preparation
Before Day 1
PRE-ONBOARDING CHECKLIST
════════════════════════
ACCOUNTS & ACCESS:
─────────────────────────────────────
□ GitHub/GitLab account added to org
□ GitScrum access provisioned
□ Slack/Teams added to channels
□ Email/calendar setup
□ VPN credentials created
□ SSO configured
□ Development tool licenses
□ Cloud console access (if needed)
EQUIPMENT:
─────────────────────────────────────
□ Laptop ordered and configured
□ Development tools pre-installed
□ Repository access verified
□ Can clone and run project locally
□ IDE configured with team settings
DOCUMENTATION:
─────────────────────────────────────
□ Onboarding guide ready
□ Architecture docs up to date
□ Development setup guide tested
□ First tasks identified
□ Mentor assigned
TEAM PREPARATION:
─────────────────────────────────────
□ Team notified of start date
□ Mentor/buddy confirmed
□ Calendar invites for key meetings
□ Welcome message drafted
□ First day schedule set
Day 1
Welcome and Setup
DAY 1 STRUCTURE
═══════════════
MORNING:
─────────────────────────────────────
09:00 Welcome meeting with manager
├── Team overview
├── Role expectations
├── 30/60/90 day goals
└── Q&A
10:00 IT/Accounts verification
├── Confirm all access works
├── Fix any issues immediately
└── Install any missing tools
11:00 Meet the team
├── Brief introductions
├── Who does what
└── Office tour (if in-person)
AFTERNOON:
─────────────────────────────────────
13:00 Development environment setup
├── Clone repositories
├── Run setup scripts
├── Verify build works
├── Run tests locally
└── Goal: "Hello World" running
15:00 First task introduction
├── Small, well-defined task
├── Non-critical path
├── Clear success criteria
└── Buddy available for questions
16:30 Day 1 debrief with buddy
├── Questions so far?
├── Blockers?
├── Tomorrow's plan
└── Check in on mental state
DAY 1 GOAL:
├── All access working
├── Development environment running
├── First task started
└── Feeling welcomed, not overwhelmed
First Week
Week 1 Program
WEEK 1 SCHEDULE
═══════════════
DAY 2: CODEBASE ORIENTATION
─────────────────────────────────────
Morning:
├── Architecture walkthrough (2 hrs)
│ ├── High-level system design
│ ├── Key services/components
│ ├── Data flow
│ └── Why decisions were made
│
├── Codebase tour (1 hr)
│ ├── Repository structure
│ ├── Key files/modules
│ ├── Where things live
│ └── Naming conventions
Afternoon:
├── Continue first task
├── Pair programming session (optional)
└── Questions with buddy
DAY 3: PROCESSES
─────────────────────────────────────
├── Development workflow
│ ├── Branching strategy
│ ├── PR process
│ ├── Code review expectations
│ └── CI/CD pipeline
│
├── Agile ceremonies
│ ├── Sprint rhythm
│ ├── Standup format
│ ├── Retro process
│ └── GitScrum usage
DAY 4-5: FIRST CONTRIBUTION
─────────────────────────────────────
├── Complete first task
├── Submit first PR
├── Code review received
├── Iterate on feedback
├── First merge! 🎉
└── Celebrate small win
WEEK 1 GOAL:
├── First PR merged
├── Understands basic architecture
├── Knows team processes
├── Has asked lots of questions
└── Buddy relationship established
First Month
Progressive Complexity
WEEK 2-4: BUILDING COMPETENCE
═════════════════════════════
WEEK 2: SMALL FEATURES
─────────────────────────────────────
├── 2-3 small, independent tasks
├── Different areas of codebase
├── Building breadth of exposure
├── Still with buddy support
└── Attending all ceremonies
WEEK 3: MEDIUM FEATURES
─────────────────────────────────────
├── Slightly larger scope
├── Some design decisions
├── Cross-component work
├── More independent
└── Fewer buddy check-ins
WEEK 4: REGULAR WORK
─────────────────────────────────────
├── Taking regular sprint work
├── Participating in planning
├── Doing code reviews
├── Answering own questions
└── Helping next new hire (if applicable)
30-DAY CHECK-IN:
─────────────────────────────────────
Manager meeting:
├── How's it going? (honest feedback)
├── What's unclear still?
├── What's working well?
├── What could improve?
├── Update 60-day goals if needed
└── Address any concerns early
Starter Tasks
Good First Tasks
IDEAL FIRST TASKS
═════════════════
CHARACTERISTICS:
─────────────────────────────────────
✓ Well-defined scope
✓ Non-critical path
✓ Immediate feedback possible
✓ Touches real codebase
✓ Completable in 1-2 days
✓ Has clear success criteria
✓ Related to team's work
EXAMPLES:
─────────────────────────────────────
1. BUG FIXES
├── Simple, isolated bug
├── Clear reproduction steps
├── Touches one file/module
└── Learn debugging process
2. DOCUMENTATION
├── Update outdated README
├── Add missing comments
├── Improve setup instructions
└── Learn codebase through docs
3. SMALL FEATURES
├── Add form field
├── New API endpoint (simple)
├── UI tweak
└── Learn development workflow
4. TESTS
├── Add missing test case
├── Improve coverage for module
├── Fix flaky test
└── Learn testing approach
5. REFACTORING
├── Rename confusing variable
├── Extract helper function
├── Apply team conventions
└── Learn code standards
Task in GitScrum
GITSCRUM ONBOARDING SETUP
═════════════════════════
LABEL: onboarding-friendly
─────────────────────────────────────
Mark suitable tasks in backlog:
├── Label: "onboarding-friendly"
├── Well-written description
├── Acceptance criteria clear
├── Estimated (1-3 points)
└── Not time-critical
ASSIGNEE:
─────────────────────────────────────
When assigning to new hire:
├── Assign task
├── Add mentor as watcher
├── Set reasonable due date
├── Link to relevant docs
└── Add context in comments
TRACKING:
─────────────────────────────────────
Track onboarding tasks:
├── Time from assign to complete
├── Number of iterations
├── Questions asked
├── Blockers encountered
└── Use for process improvement
Documentation
Essential Docs
ONBOARDING DOCUMENTATION
════════════════════════
SETUP GUIDE:
─────────────────────────────────────
Title: "Getting Started"
Contents:
├── Prerequisites (tools, accounts)
├── Clone repository
├── Install dependencies
├── Environment variables
├── Run locally
├── Run tests
├── Common issues & solutions
└── Troubleshooting FAQ
Format:
├── Step-by-step
├── Copy-paste commands
├── Screenshots where helpful
├── Tested with each new hire
└── Updated when broken
ARCHITECTURE OVERVIEW:
─────────────────────────────────────
Title: "System Architecture"
Contents:
├── High-level diagram
├── Component descriptions
├── Data flow
├── Key technologies
├── Why decisions were made
├── Historical context
└── Future direction
TEAM GUIDE:
─────────────────────────────────────
Title: "How We Work"
Contents:
├── Team members & roles
├── Sprint rhythm
├── Communication norms
├── Code review process
├── On-call rotation
├── Decision-making process
└── Escalation paths
Buddy System
Mentor Assignment
EFFECTIVE BUDDY PROGRAM
═══════════════════════
BUDDY SELECTION:
─────────────────────────────────────
Good buddy:
├── 6+ months on team
├── Patient and available
├── Technically competent
├── Good communicator
├── Not overwhelmed with work
└── Wants to mentor
Not just: Senior person who's busy
BUDDY RESPONSIBILITIES:
─────────────────────────────────────
Week 1:
├── Daily check-ins (30 min)
├── Available for questions
├── Pair programming sessions
├── Introduce to people
└── Answer "dumb" questions
Week 2-4:
├── 2-3 check-ins per week
├── Code review mentor
├── Help navigate organization
├── Celebrate wins
└── Flag concerns to manager
Ongoing:
├── Weekly coffee/chat
├── Career discussions
├── Long-term relationship
└── 6-month check-in
BUDDY SUPPORT:
─────────────────────────────────────
Recognize buddy effort:
├── Reduce buddy's sprint work
├── Count mentoring as contribution
├── Thank publicly
├── Factor into performance
└── It's real work, treat it as such
Measuring Success
Onboarding Metrics
ONBOARDING METRICS
══════════════════
TIME TO FIRST PR:
─────────────────────────────────────
Target: Day 3-5
Measure: Days from start to first PR
Good: Under 5 days
Concern: Over 2 weeks
TIME TO PRODUCTIVITY:
─────────────────────────────────────
Target: Week 4-6
Measure: When taking regular sprint work
Good: Under 6 weeks
Concern: Over 3 months
NEW HIRE SATISFACTION:
─────────────────────────────────────
Survey at 30, 60, 90 days:
├── Onboarding experience (1-5)
├── Feel productive (1-5)
├── Understand architecture (1-5)
├── Know who to ask (1-5)
└── Would improve... (open)
MENTOR TIME:
─────────────────────────────────────
Track buddy hours spent:
├── Week 1: 8-10 hours expected
├── Week 2: 4-6 hours
├── Week 3-4: 2-4 hours
└── Use for planning
90-DAY RETENTION:
─────────────────────────────────────
Track if new hires stay:
├── 100%: Great onboarding
├── < 80%: Investigate issues
└── Early departure = red flag
Best Practices
For Onboarding
Anti-Patterns
ONBOARDING MISTAKES:
✗ No access on Day 1
✗ "Read the code" as onboarding
✗ No buddy/mentor assigned
✗ First task too hard
✗ Overwhelming with information
✗ No check-ins
✗ Expecting instant productivity
✗ Outdated documentation