gsd-onboard

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

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

/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. </objective>

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

<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. </context>

<process> 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. </process>

<runtime_note> Copilot (VS Code)： 在本工作流调用

AskUserQuestion

的任何位置，都可以使用

vscode_askquestions

。二者功能等价——

vscode_askquestions

是VS Code Copilot对同一交互式问题API的实现。 </runtime_note>

<objective> 通过按安全顺序调用现有GSD原语，引导遗留代码库（brownfield）的上手流程：代码库映射 → 文档导入 → 项目初始化 → 上手总结。

创建或确认以下内容：

```
.planning/codebase/
```
— 来自
```
/gsd-map-codebase
```
的、有证据支撑的代码库映射

.planning/PROJECT.md

REQUIREMENTS.md

ROADMAP.md

STATE.md

— 来自

/gsd-new-project

或

/gsd-ingest-docs

的项目设置文档

```
.planning/onboarding/SUMMARY.md
```
— 记录已学内容和下一步命令的轻量级索引

非目标： 本命令不会执行阶段任务、交付工作，也不会在未经过明确确认的情况下覆盖现有规划工件。 </objective>

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

<context> 参数：$ARGUMENTS

标志：

```
--fast
```
— 在映射交接时优先使用
```
/gsd-map-codebase --fast
```
；但在执行
```
/gsd-new-project
```
前仍需完成完整映射。
```
--text
```
— 使用纯文本编号列表替代TUI菜单。 </context>

<process> 端到端执行上手工作流。保留所有安全确认环节、文本模式回退方案、幂等性检查，以及嵌套交互式命令的顶级交接规则。 </process>