gsd-onboard

SkillDev tools

Guides your agent through onboarding to an existing codebase by mapping it, ingesting docs, and setting up plans.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gsd-onboard skill

About this capability

Guide existing codebase onboarding through mapping, doc ingest, and planning setup

What this skill tells your AI

The instructions your AI receives, as published by open-gsd/gsd-core in skills/gsd-onboard/SKILL.md and read by ahel’s review.

<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>

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>

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.

Signals

GitHub stars
9k
Forks
680
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gsd-onboard
Source
github.com/open-gsd/gsd-core