The aha: Before: a new hire at Periphery spent their first week piecing together context — what clients they own, what tools they need, what the shared Drive structure means, how to prep for meetings, how the team tracks things. Even existing team members had no consistent setup — some had CLAUDE.md files, some didn't, some had half-broken ones. Now you type
/onboardin Cowork and 20 minutes later you have a personal workspace that Claude reads at the start of every session — knowing who you are, what you work on, what happened in your last meetings, and what tools you have connected.
What you need to know (2 min read)
/onboard is the starting point for everyone on the team. It sets up your personal Claude workspace — a local folder on your machine where your CLAUDE.md (your identity) and memory/ (your running context) live.
After onboarding, every time you open Cowork, Claude automatically knows:
- Who you are and your role
- Which clients you own and your specific role on each
- Your connected tools (Slack, Gmail, Calendar, ClickUp, Fireflies)
- Your recent meetings, action items, and open approvals
- Your preferences (how you like bullet points, which Slack channels to watch, etc.)
It's idempotent — safe to run any time. If you've already been set up, it detects that and runs in audit/refresh mode instead of re-doing everything. If you're new, it runs the full 20-minute flow.
The output: four files in your local Claude folder:
~/Downloads/Claude/ (or wherever you set it up)
├── CLAUDE.md ← who you are, your clients, your preferences
└── memory/
├── MEMORY.md ← this week's meetings, action items, client notes
├── company-context.md ← Periphery Digital overview
└── people.md ← team directory
These live on your machine. They persist between Cowork sessions. Claude reads them automatically at the start of every chat.
How it works
/onboard runs in 5 phases. The whole thing takes about 20 minutes.
Phase 0 — Detect & connect. Claude checks what's already in your workspace (fresh setup or existing CLAUDE.md to audit?), probes your connected tools (Slack, Gmail, Calendar, ClickUp, Fireflies, Google Drive), and confirms your local Claude folder and Drive access mode.
Phase 1 — Identity. Claude asks your name, looks you up in the team directory (_Shared/Templates/onboarding/people.md), pre-fills your role, clients, timezone, and EA assignment (if any). You confirm or correct.
Phase 2 — Memory bootstrap. Claude scans your recent tool activity — the last 14 days of Gmail, 7 days of Slack, last week's Fireflies meetings, your Calendar for the upcoming week, your ClickUp tasks — and compiles it into memory/MEMORY.md organized by meeting, action items, and open approvals per client.
Phase 3 — Plugin confirmation. Confirms which plugins are available to you:
- Periphery Personal (everyone) —
/save,/good-morning,/good-night,/refresh,/weekly-time-audit - Periphery Context (AMs/PMs) —
/setup-client-context,/meeting-prep,/meeting-debrief,/build-brief,/update-context
Non-AM/PM roles see clients as "available if you need it" rather than primary.
Phase 4 — First habit walkthrough. Claude walks you through running /save once, live, on something from the current conversation. You feel the loop — session ends → run /save → context files stay fresh automatically.
Phase 5 — State write. Claude finalizes your CLAUDE.md with state fields (onboarding-status: complete, save-tier: learning, drive-access-mode: <detected>, local-claude-folder: <your-path>) so future sessions know you're set up.
Local-first workflow
Most of your work lives in your local Claude folder. The shared Drive is for sharing finished work with the team — not for live drafts. This is the team's standing preference.
- Personal files (CLAUDE.md, memory/, save state) — always local, never Drive
- Client context files (campaign.md, health.md, performance.md, production.md, brief.md) — local first, sync to Drive when you're ready to share with the team
For PC users who can't connect the Drive: you can use every command in this plugin. Your drive-access-mode gets set to local-only, and when you're ready to share a file with the team, you download it from your local Claude folder and upload it to the shared Drive via your browser. No productivity loss — just a different sync step.
Try it yourself
- Create a local Claude folder on your machine (e.g.,
~/Downloads/Claude/) if you don't have one. Most of your work will live here. - Open Cowork and create/open a project workspace.
- Type:
/onboard - Answer the questions honestly — real name, real role, real local folder path. Don't pretend to be someone else or tell Claude "this is a test." The skill works best with real inputs.
- At the end, you should see four files in your local Claude folder. Open
CLAUDE.mdand verify:
- Your name, role, and clients are correct
- The YAML frontmatter has
onboarding-status: complete local-claude-folderis your REAL path (not/sessions/<id>/mnt/...— that's a bug, ping Alex)drive-access-modeis one of:native,gws-cli,drive-mcp-fallback,local-only, oroffline
- Test persistence: close Cowork, open a fresh chat, ask "what do you know about me?" Claude should read your CLAUDE.md and answer correctly.
Quick reference
| Detail | Info | |
|---|---|---|
| Command | `/onboard [--reset \ | --resume]` |
| Who uses it | Everyone on the team (once per person, idempotent re-runs safe) | |
| Time to run | ~20 minutes (fresh), ~5 minutes (audit/refresh) | |
| Prereq | A local folder on your machine where files can persist between sessions | |
| What it produces | CLAUDE.md, memory/MEMORY.md, memory/company-context.md, memory/people.md | |
| Modes | fresh (new user), audit (incomplete CLAUDE.md), refresh (complete — just check for updates), resume (partial — continue where you stopped) |
Tips
- Do this in a fresh Cowork workspace if you're testing. If you already have a CLAUDE.md,
/onboardwill audit it rather than overwrite. - Honest answers produce better output. If Claude asks about your clients, don't hedge — give it your real client list. The scans are role-aware.
- PC users: pick
local-onlymode when prompted. Don't fight with Drive access if it's not working. You can switch to a different mode later by running/connect-tools. - Files live on your machine, not in Cowork's sandbox. The
/sessions/<id>/mnt/...paths you might see are ephemeral — your files are safe at your real local path. If you see that ephemeral path recorded in your CLAUDE.md, that's a bug — flag it. - Re-run
/onboardany time: your role changes, your client list changes, your preferences change. It's idempotent — it won't overwrite your custom content. - If you get stuck: ask Claude to debug whatever's happening. If you're still stuck, ping Alex or Jonathan.
Related
- what-is-cowork — Background on the Cowork environment
- context-files-explained — The client-side context files you'll manage after onboarding
- local-first-workflow — Why we default to local and sync to Drive only when ready
- good-morning — The first command to run each morning after you're onboarded
- save — The end-of-session habit that keeps everything fresh