sync: update from private repo (8447335)

docs/getting-started.md

@@ -16,20 +16,38 @@ git clone https://gitea.example.com/your-org/maestro.git
 cd maestro
 npm ci                 # バックエンド依存
 npm --prefix ui ci     # UI 依存
-cp config.yaml.example config.yaml
 ```
 
-## 3. 最小設定
+## 3. 最小設定（対話ウィザード）
 
-`config.yaml` で LLM 接続先とワーカーを設定する。最低限、使用するモデルとエンドポイントを指定すればよい（既定は Ollama `http://localhost:11434/v1`）。各項目の意味は [configuration.md](configuration.md) を参照。
-
-主要な環境変数で上書きも可能:
+`npm run setup` で LLM 接続先を対話的に設定し、最小の `config.yaml` を生成する。
 
 ```bash
-export OLLAMA_BASE_URL=http://localhost:11434/v1
-export OLLAMA_MODEL=qwen2.5:14b
+npm run setup
 ```
 
+- 接続タイプ（`direct` = Ollama/vLLM 等 / `aao_gateway` = 別 MAESTRO Gateway 経由）を選ぶ。
+- LLM endpoint URL（例 `http://localhost:11434/v1`）を入力。接続を確認し、見つかったモデルから選択できる（接続できなくてもモデル名を手入力して続行可能）。
+- `aao_gateway` の場合は API キー（`sk-aao-...`）も入力する（`config.yaml` に保存され、権限は 0600）。
+- 最後に MAESTRO サーバーの listen port（既定 9876）を設定する。
+
+非対話（Docker / CI）:
+
+```bash
+SETUP_LLM_ENDPOINT=http://localhost:11434/v1 SETUP_MODEL=qwen3:14b npm run setup -- --yes
+```
+
+```bash
+# 別 MAESTRO Gateway 経由の場合
+SETUP_CONNECTION_TYPE=aao_gateway \
+  SETUP_LLM_ENDPOINT=http://gateway-host:9876/v1 \
+  SETUP_LLM_API_KEY=sk-aao-... \
+  SETUP_MODEL=qwen3:14b \
+  npm run setup -- --yes
+```
+
+詳細設定（複数ワーカー・tools・auth など）は生成後に `config.yaml` を直接編集するか、起動後の Settings UI で行う。`config.yaml.example` に全項目の説明がある。
+
 ## 4. ビルドと起動
 
 ```bash