runbookify
← All plans
Human Resources / Learning & Development

Mentorship Program Matcher: Pair Mentors and Mentees on Purpose, Not by Luck

Collect mentor and mentee applications, propose matches against your real rules, and let a coordinator approve every pairing before anyone is notified — then track check-ins to the finish line.

IntermediateA weekendBuilds onNext.jsSupabaseResend
What you'll build

A web tool where mentors and mentees apply, AI proposes ranked matches with a plain-English rationale that honors your rules, a coordinator approves each pairing before anyone is notified, kickoff emails go out, check-ins are tracked through the program, and you export a pairings-and-status CSV.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • Your current mentor/mentee application questions and matching rules (a spreadsheet is fine)
  • Claude Code or any AI coding agent

The problem this kills

Your mentorship program lives in a spreadsheet. Applications trickle in through a form, you copy them into tabs, and then you spend a weekend playing matchmaker by eye — squinting at goals and skills, trying to remember who reports to whom so you don't accidentally pair someone with their own manager, and praying you didn't overload one popular mentor with five mentees. Then the program starts, and check-ins quietly stop happening because nobody is tracking them. By month three, half the pairs have gone silent and you have no idea which ones.

The matching itself isn't the hard part — your rules are usually clear: don't pair across a reporting line, balance how many mentees each mentor carries, line up goals with strengths, honor stated preferences where you can. The hard part is doing all of that consistently across dozens of people, keeping a human in charge of the final call, and not losing the thread once the program is running. You do not need to be a developer to build the thing that does it.

What you'll build

A simple internal web tool for your L&D / people-ops team. Mentors and mentees fill in applications (goals, skills, preferences, capacity, availability). The tool proposes matches — ranked, each with a plain-English rationale — that respects your real constraints: it avoids pairing people who share a reporting line, balances mentor load, and honors preferences where it can. As the coordinator, you review and approve each proposed pairing; nothing is final until you say so. On approval, both people get a kickoff email, and the pairing moves into a check-in tracker that follows it through the program. Anyone left without a match shows up on a clear no-match list so they don't fall through the cracks. At any point you can export a CSV of every pairing and its status.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your program — how applications come in today, what your application asks, your exact matching rules and how you weight them, how you know two people share a reporting line, how many mentees a mentor can take, your check-in cadence, and the messy exceptions you handle by hand. It reads a short spec back to you for a thumbs-up, then builds the tool around your program instead of a generic template. From there it walks the agent through the data model, the application forms, the rule-aware matching engine with rationale, the coordinator approval screen, the kickoff notifications, the check-in tracker, and the pairings export. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a real people program needs: login so only your team can run the program, row-level security so each organization only ever sees its own applicants and pairings, a complete audit trail of every proposal, approval, re-match, and exit (who, what, when, and why), a hard human-approval gate so no pairing is announced until the coordinator approves it — and re-matches and exits pass through the same review — and duplicate guards so the same mentee can't end up in two active pairings or apply twice. The whole tool exists to make a careful human decision easy: the AI proposes, the coordinator decides, and only then does anyone get notified.

Who it's for

L&D leads, people-ops coordinators, and program managers who run a mentorship program off a matching spreadsheet and want it to be intentional and managed instead of luck of the draw. If you can describe what makes a good pairing in your organization, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be proposing your first round of real matches this weekend.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.