msd-core/commands/gsd/onboard.md

name, description, argument-hint, allowed-tools, requires

name	description	argument-hint	allowed-tools	requires
gsd:onboard	Guide existing codebase onboarding through mapping, doc ingest, and planning setup	[--fast] [--text]	Read Bash Write Glob Grep Agent AskUserQuestion	config new-project map-codebase ingest-docs manager

<runtime_note> Copilot (VS Code): Use vscode_askquestions wherever this workflow calls AskUserQuestion. They are equivalent — vscode_askquestions is the VS Code Copilot implementation of the same interactive question API. </runtime_note>

Guide brownfield onboarding for an existing codebase by routing through the existing GSD primitives in the safe order: codebase map → docs ingest → project initialization → onboarding summary.

Creates or confirms:

• .planning/codebase/ — evidence-backed codebase map from /gsd:map-codebase
• .planning/PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md — project setup from /gsd:new-project or /gsd:ingest-docs
• .planning/onboarding/SUMMARY.md — lightweight index of what was learned and the next command

Non-goals: This command does not execute phases, ship work, or overwrite existing planning artifacts without an explicit gate.

<execution_context> @/.claude/gsd-core/workflows/onboard.md @/.claude/gsd-core/references/ui-brand.md @~/.claude/gsd-core/references/gate-prompts.md </execution_context>

Arguments: $ARGUMENTS

Flags:

• --fast — prefer /gsd:map-codebase --fast for the mapping handoff; the complete map is still required before /gsd:new-project.
• --text — use plain-text numbered lists instead of TUI menus.

Execute the onboard workflow end-to-end. Preserve all safety gates, text-mode fallbacks, idempotency checks, and top-level handoff rules for nested interactive commands.