# Onboard

> Analyze brownfield codebase and create initial continuity ledger

- Skill: `majiayu000/onboard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/onboard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/onboard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/onboard

---


# Onboard - Project Discovery & Ledger Creation

Analyze a brownfield codebase and create an initial continuity ledger.

## When to Use

- First time working in an existing project
- User says "onboard", "analyze this project", "get familiar with codebase"
- After running `init-project.sh` in a new project

## How to Use

**Spawn the onboard agent:**

Use the Task tool with `subagent_type: "general-purpose"` and this prompt:

```
Onboard me to this project.

Read and follow the instructions in .claude/agents/onboard.md exactly.

1. Check if thoughts/ledgers/ exists (if not, tell me to run init-project.sh)
2. Set RepoPrompt workspace to this project, then explore:
   rp-cli -e "workspace switch \"$CLAUDE_PROJECT_DIR\""
   rp-cli -e 'tree'
   rp-cli -e 'structure .'
   rp-cli -e 'builder "understand the codebase architecture"'
3. If rp-cli not available, fall back to bash (find, ls, etc.)
4. Detect tech stack
5. Ask me about my goals using AskUserQuestion
6. Create a continuity ledger at thoughts/ledgers/CONTINUITY_CLAUDE-<project>.md
```

## Why an Agent?

The onboard process:
- Requires multiple exploration steps (RepoPrompt builder is slow)
- Should not pollute main context with codebase dumps
- Returns a clean summary + creates the ledger

## Output

- Continuity ledger created at `thoughts/ledgers/CONTINUITY_CLAUDE-<name>.md`
- User has clear starting context
- Ready to begin work with full project awareness

## Notes

- This skill is for BROWNFIELD projects (existing code)
- For greenfield, use `/create_plan` instead
- Ledger can be updated anytime with `/continuity_ledger`
- RepoPrompt requires the app running with MCP Server enabled