# onboarding-planner

New-hire onboarding, employee ramp-up and first-90-days planning capability pack for managers, HR, people-ops and team leads: generate a structured 30/60/90-day onboarding plan (plan) for any role...


New-hire onboarding & first-90-days pack. Role-aware templates for managers, HR and team leads, with
an optional AI layer that tailors output to a specific role/team/company when a model is reachable
(and falls back to the deterministic template otherwise).

**Guidance templates, not HR or legal advice.**

## Tools

| Tool | Args | Does |
|---|---|---|
| `plan` | `{role, level?, name?, team?, options?}` | 30/60/90-day plan with learn → contribute → own phases. `options.remote` remote-first; `options.tailor` requests AI tailoring. |
| `checklist` | `{role, name?, phase?, options?}` | Preboarding + week-1 checklist. `phase`: `preboarding` \| `week1` \| `all`. `options.remote` swaps in ship-hardware steps. |
| `milestones` | `{role, startDate?, options?}` | Ramp milestones (day 1 → 90) with success criteria; real target dates when `startDate` (ISO) is given. |
| `buddyPlan` | `{role, name?, options?}` | Buddy/mentor program: cadence, touchpoints, responsibilities, success signals. |
| `resourcesList` | `{role, team?, options?}` | Curated docs/tools/people/learning list; `options.tailor` adds AI suggestions. |
| `listRoles` | `{}` | Roles with dedicated templates + aliases. |

Roles: software engineer, designer, product manager, sales, marketing, support, data scientist,
manager, plus a generic default. Unknown roles resolve to the generic template.

## Example

```js
import pack from './index.js';
pack.adapters.plan({ role: 'software engineer', name: 'Ada', team: 'Platform', level: 'senior' });
// { mode:'heuristic', role:'Software Engineer', phases:[{window:'Days 1-30',theme:'Learn & assess',goals:[…]}, …] }

pack.adapters.milestones({ role: 'designer', startDate: '2026-08-01' });
// milestones with targetDate on each, fullyProductiveBy:'2026-10-29'
```

## DRY boundaries

- **`datetime`** owns raw date arithmetic; **`cron`** owns recurring-cadence parsing. This pack composes
  people-ops onboarding *templates* (plans, checklists, milestones, buddy programs) none of those own.
- Self-contained: only cross-pack import is `../_shared/llm.js`.

## Hybrid intelligence

All cores are pure templates that run offline. `plan` and `resourcesList` accept `options.tailor:true`
to request LLM tailoring; with no model reachable they return the template with `mode:'heuristic'`. A
down model never throws.


---
Source: shared/engines/adapters/domain/onboarding-planner/README.md
Canonical: https://docs.leumas.tech/p/adapters/domain/onboarding-planner