Brainforge Onboarding Automation

Complete automation suite for onboarding new Brainforge team members.

Quick Start

Option 1: Agent Skill (Recommended)

Just tell the agent:

"Onboard Davis Dunham with email rdavisdunham@gmail.com as AI Engineer in Engineering"

The agent will:

Create Linear project and checklist
Generate execution plan
Provide step-by-step instructions
Track progress

Option 2: Python Script

cd knowledge/operations/onboarding/automation
python onboard_new_hire.py "Davis Dunham" "rdavisdunham@gmail.com" "AI Engineer" "Engineering"

Option 3: Shell Script

cd knowledge/operations/onboarding
./onboard-new-hire.sh "Davis Dunham" "rdavisdunham@gmail.com" "AI Engineer" "Engineering"

Setup (For Full Automation)

Prerequisites

Python 3.8+
Google Workspace Service Account (for email creation)
Slack Admin Token (for Slack invitations)
Linear API Key (for Linear integration)

Installation

cd knowledge/operations/onboarding/automation
pip install -r requirements.txt

Configuration

Create .env file:

# Google Workspace
GOOGLE_SERVICE_ACCOUNT_FILE=/path/to/service-account.json
 
# Slack
SLACK_ADMIN_TOKEN=xoxp-your-admin-token
SLACK_TEAM_ID=T01XXXXXXX
 
# Linear
LINEAR_API_KEY=lin_api_xxxx

Usage

Basic Usage (Documentation Only)

python onboard_new_hire.py "Name" "email@example.com" "Role" "Department"

This generates:

Linear project structure
Execution plan document
Tool checklist
Step-by-step instructions

Full Automation (With API Access)

python onboard_new_hire.py "Name" "email@example.com" "Role" "Department" --create-accounts

This actually creates:

Google Workspace email
Slack invitation
Tool access (where APIs available)

Output Options

# Save results to JSON
python onboard_new_hire.py "Name" "email" "Role" "Dept" -o results.json

Department Tool Mapping

Department	Tools	Slack Channels
AI	1Password, GitHub, Linear, Notion, Clockify, Cursor, ChatGPT	platform, engineering
Engineering	1Password, GitHub, Linear, Notion, Clockify, Cursor, Vercel, Railway	platform, engineering
Data	Fivetran, Portable.io, Snowflake, BigQuery, DBT, Rill, Metabase, Amplitude, GitHub	data-team
Sales/Marketing	HubSpot, Notion, 1Password, Figma, Zoom	sales, marketing
Operations	Linear, Notion, Slack, GitHub, Clockify, 1Password, Figma, Zoom, Ramp, Documenso	operations
Legal	Documenso, Slack, Notion	legal
Finance	Ramp, Clockify, Notion	finance
HR	Notion	hr
PM	Linear, Clockify, GitHub, ChatGPT, FigJam, Cursor	product

API Setup Details

Google Workspace

Go to https://console.cloud.google.com
Create service account
Enable Admin SDK API
Download JSON key
Grant domain-wide delegation
Authorize these scopes:
- https://www.googleapis.com/auth/admin.directory.user

Slack

Go to https://api.slack.com/apps
Create app
Add OAuth scopes:
- admin.users:write
- admin.users:read
Install to workspace
Copy admin token

Linear

Go to https://linear.app/settings/api
Create personal access token
Copy token

Manual Fallback

If automation isn’t available, the script generates detailed manual instructions:

knowledge/operations/onboarding/EXECUTION-PLAN-{name}.md

This includes:

Step-by-step instructions
Direct URLs to admin consoles
Tool-specific actions
Check-in schedule template

Examples

Example 1: AI Engineer

python onboard_new_hire.py \
  "Davis Dunham" \
  "rdavisdunham@gmail.com" \
  "AI Engineer" \
  "Engineering" \
  --create-accounts

Example 2: Data Team

python onboard_new_hire.py \
  "Sarah Chen" \
  "sarah@example.com" \
  "Data Engineer" \
  "Data" \
  --create-accounts \
  -o sarah-onboarding.json

Example 3: Documentation Only

python onboard_new_hire.py \
  "Mike Johnson" \
  "mike@test.com" \
  "Product Manager" \
  "PM"

Troubleshooting

Google Workspace Creation Fails

Check service account has domain-wide delegation
Verify admin SDK is enabled
Check admin@brainforge.ai has permissions

Slack Invitation Fails

Verify admin token has admin.users:write
Check team ID is correct
Ensure user isn’t already in workspace

Tool Access Issues

Check available licenses (Cursor, ChatGPT)
Verify user doesn’t already exist
Use alternative email if needed

Success Criteria

Onboarding is complete when:

✅ Brainforge email created (davis.dunham@brainforge.ai)
✅ Slack guest access granted
✅ All required tools provisioned
✅ Linear project created with checklist
✅ HR database updated
✅ Finance team notified
✅ Team introduction sent
✅ Check-ins scheduled

Support

For issues or questions:

Check execution plan: knowledge/operations/onboarding/EXECUTION-PLAN-{name}.md
Review SOP: knowledge/operations/onboarding/new-team-member-onboarding-sop.md
Ask in operations Slack channel

Brainforge Knowledge

Explorer

README