onboard

• First time working in an existing project
• User says "onboard", "analyze this project", "get familiar with codebase"

Spawn the onboard agent:

Use the Task tool with subagent_type: "onboard" and this prompt:

```

Onboard me to this project at $CLAUDE_PROJECT_DIR.

1. Create required directories if they don't exist:

mkdir -p thoughts/shared/handoffs/ .claude

1. Explore the codebase using available tools:

- Try: tldr tree . && tldr structure .

- Fallback: find . -type f -name ".py" -o -name ".ts" -o -name "*.js" | head -50

1. Detect tech stack (look for package.json, requirements.txt, Cargo.toml, go.mod, etc.)

1. Ask the user about their goals using AskUserQuestion

1. Create a YAML handoff at thoughts/shared/handoffs//onboard-.yaml:

---

date:

type: onboard

status: active

---

goal:

now: Start working on

tech_stack: [list of detected technologies]

key_files:

- path:

purpose:

architecture:

next:

-

```

The onboard process:

• Requires multiple exploration steps
• Should not pollute main context with codebase dumps
• Returns a clean summary + creates the handoff

• Directories created: thoughts/shared/handoffs//, .claude/
• YAML handoff created (loaded automatically on session start)
• User has clear starting context
• Ready to begin work with full project awareness

• This skill is for BROWNFIELD projects (existing code)
• For greenfield, use /create_plan instead
• Handoff can be updated anytime with /create_handoff