/insights and /team-onboarding — Workflow Intelligence Commands
/insights analyzes 30 days of your actual Claude Code usage to surface personalized improvement suggestions. /team-onboarding generates a structured ramp-up guide from your config and usage patterns — not generic documentation, but how to work in this codebase with Claude Code specifically.
Quick Reference
- →/insights reads last 30 days of session history — suggestions grounded in actual usage, not generic advice
- →Context limit issues → .claudeignore suggestions; re-explaining project context → CLAUDE.md additions
- →Run /insights monthly as a lightweight retrospective on your Claude Code practice
- →/team-onboarding generates ramp-up guide from local config and usage patterns
- →Output includes: effective CLAUDE.md rules, common task flows, permission profiles, known gotchas
- →Commit /team-onboarding output to the repo alongside CLAUDE.md
- →Not a substitute for session handoff docs — /team-onboarding captures how to work here generally
- →Both commands were released in March 2026
What These Commands Do
Most Claude Code features operate on your codebase. /insights and /team-onboarding operate on your Claude Code usage itself — the accumulated history of how you've worked, what's worked, what's been friction. They extract intelligence from your practice rather than your code.
| Command | Source data | Output | When to run |
|---|---|---|---|
| /insights | Last 30 days of session history | Personalized improvement suggestions calibrated to your usage patterns | Monthly, as a practice retrospective |
| /team-onboarding | Local Claude Code config + usage patterns | Structured ramp-up guide for this codebase with Claude Code | When onboarding a new team member |
Both commands derive their value from specificity. /insights doesn't tell you 'write better CLAUDE.md files' — it tells you 'you've re-explained your authentication architecture in 14 sessions this month, here's what to add to your CLAUDE.md to stop doing that.' /team-onboarding doesn't tell you 'install Claude Code' — it tells you how to use Claude Code effectively in this specific repository.