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 .maestro/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 /maestro:create_plan instead
• Ledger can be updated anytime with /maestro:continuity_ledger
• RepoPrompt requires the app running with MCP Server enabled