THE OPPORTUNITY
新人缺的通常不是更多文件，而是不知道現在卡在哪一層。
環境建不起來可能來自 CLI、runtime、VPN、憑證、IAM、repository 或資料依賴。靜態 checklist 無法判斷實際狀態，也無法根據不同 team 與角色調整路徑。
DayOne 以 environment doctor 驗證真實狀態，再由 RelayOps 解釋架構與流程，最後用一個安全的 first-MR journey 讓新人走過完整 delivery loop。
SYSTEM BLUEPRINT
從身分與環境，到第一個可 review 變更
依角色、team、repository 與學習目標建立 journey
檢查 CLI、runtime、VPN、權限、憑證與 dependencies
用 service map、request flow 與 ownership 建立系統心智模型
在 sandbox 演練 branch、test、debug、MR 與 rollout
引導完成真實但低風險的 first MR
把 setup failure 與問答缺口轉成平台 backlog
DESIGN PRINCIPLES
Onboarding 不應依賴某位資深工程師剛好有空。
同一套平台，不同角色的路徑
依 team、OS、repository 與權限生成 journey，但保留組織定義的 golden path。
每一步都要有成功證據
不是叫新人『確認有安裝』，而是執行唯讀診斷並指出缺少的依賴與修復方式。
不要求貼上 token 或憑證
權限與 secret 只驗證存在性和 scope；敏感值永遠不進 prompt、log 或教學紀錄。
每個卡點都是平台訊號
重複問題自動聚類，轉成文件、template、bootstrap script 或 owner backlog。
VALIDATION PLAN
把『上手了』改成可以量化與持續改善的結果。
Time to first successful local run
Time to first reviewable merge request
Senior engineer interruption count
Documentation and permission gaps discovered
這些是開發與試點階段的驗收指標；正式案例只會在可重現測試與實際使用資料 支持後更新。
WHAT I WILL BUILD
我會把 developer portal、環境診斷與知識代理組成一條 onboarding control loop。
- role-based journey engine 與 golden path catalog
- cross-platform environment doctor 與 permission probes
- RelayOps knowledge grounding 與 architecture walkthrough
- sandbox practice repository 與 first-MR workflow
- onboarding analytics、gap detection 與 platform backlog
KNOWLEDGE LAYER