onboard

# Onboard — Workspace Setup Wizard 互動式 wizard，負責建立或更新 company workspace config，並把 company route 登記到 root `workspace-config.yaml`。 `init` / `/init` / `re-init` 是 deprecated aliases，只作相容入口；新的 skill source、 reference loading 與文件語言都以 `onboard` 為主。 ## Contract `onboard` 只負責 setup orchestration： - 從 `_template/workspace-config.yaml` 建立或編輯 `{company}/workspace-config.yaml`。 - 在 root `workspace-config.yaml` 登記 company routing。 - 從 `_template/rule-examples/` scaffold company-scoped L2 rules。 - 探測 optional integrations，但 optional 系統不可阻塞 onboard 完成。 - 所有偵測值都必須先顯示給使用者確認，再寫入。 不要猜缺漏值。Auto-detection 只能提供 suggestion，必須經使用者確認。每個 optional section 都可 skip；skip 後欄位保持空值，下游 skills graceful degrade。 ## Reference Loading 依使用者選到的路徑只讀需要的 references： | Situation | Load | |---|---| | Any `onboard` run | `onboard-interaction-patterns.md`, `onboard-core-workflow.md`, `workspace-config-reader.md`, `workspace-language-policy.md` | | Existing company / upgrade rerun | `onboard-core-workflow.md` rerun section | | `onboard repair` / readiness check | `onboard-core-workflow.md`, `onboard-post-setup-flow.md`, `workspace-config-reader.md` | | Project repo detection | `onboard-interaction-patterns.md`, `sub-agent-roles.md` | | Dev environment setup | `onboard-runtime-setup-flow.md`, `dependency-consent.md` | | Visual regression setup | `onboard-visual-regression-setup.md`, `visual-regression-config.md` | | Daily learning scanner | `learning-setup-flow.md`, `daily-learning-scan-spec.md` | | Runtime toolcha...