onboard · chriswiles — Claude Code command: task preparation
onboard — a command that prepares an agent to work on a project. It explores the codebase, asks clarifying questions, and records context for the next session.
no license ★ 6,091 updated 2026-01-06
.claude/commands/onboard.mdWhat onboard does
The command triggers extended thinking and guides the agent through project exploration before starting work. The agent studies code structure, understands architecture, asks questions when needed, and writes everything to .claude/tasks/[TASK_ID]/onboarding.md. This file then speeds up context recovery in future sessions.
Available in Claude Code and other platforms via configuration files. The agent is expected to spend as much time preparing as needed—thoroughness matters more than rushing through the overview.
What it helps with
- restore task context in a new session without re-analyzing code
- prepare an agent to work on an unfamiliar project
- document architecture and requirements before coding starts
- catch gaps in understanding the task before implementation begins
Example prompts for the agent
- Run
/onboardto prepare yourself for this task - Before you start, explore the project with
/onboard - Set up the task context:
/onboard
How to install onboard
Manually: put the files in place
.claude/commands/onboard.mdCall it with /onboard. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/onboard.mdCall it with /prompts:onboard. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/onboard.prompt.mdManually: put the files in place
.gemini/commands/onboard.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about onboard
How do I install onboard in Claude Code?
Create .claude/commands/onboard.md at the project root with the command content. Claude Code automatically loads commands from .claude/commands/.
What does onboard do?
It directs the agent to study the codebase, understand architecture, and write findings to .claude/tasks/[TASK_ID]/onboarding.md. This record helps the agent recall context and structure in later sessions.
Where does onboard save results?
In .claude/tasks/[TASK_ID]/onboarding.md inside your project. Use this file when restoring context in a new session.
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →onboard by other authors comes first.