メニュー
Use when setting up a new developer workstation for the Maestro project, when a developer reports missing tools or broken auth, or when onboarding someone to Maestro development
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Deep codebase analysis — architecture health, test coverage gaps, tech debt, and actionable findings
Run pre-commit checks (fmt, clippy, test) then stage, commit, and push with a conventional message
Review staged or recent changes for correctness, style, and Rust conventions before committing
Use when SSHing into remote machines, looking up credentials, renaming Tailscale devices, or accessing services on the tailnet. Symptoms - SSH auth failures, too many authentication failures, command not found tailscale, need to find credentials for remote machines.
Use when mixing Tokio async code with synchronous blocking I/O libraries (tar, flate2, zip, csv), or when seeing "cannot block the current thread from within the async context" panics, or needing to stream async bytes into a sync reader.
Structured BAML schema edit → validate → test loop for the devloop project. Use when editing any *.baml file in crates/baml/baml_src/ — covers version parity gotchas, uvx invocation, regeneration workflow, and the analyze verify step.
| name | maestro-dev-setup |
| description | Use when setting up a new developer workstation for the Maestro project, when a developer reports missing tools or broken auth, or when onboarding someone to Maestro development |
Systematic setup of a macOS workstation for Maestro development. Check everything first, install in parallel, configure auth, verify.
--install to auto-install missing tools.Run the prereqs checker or check manually:
./tools/check-prereqs.sh # Check status
./tools/check-prereqs.sh --install # Check and install missing
Manual check table:
| Tool | Check | Install (Homebrew) |
|---|---|---|
| Rust | rustc --version | rustup.rs |
| Docker | docker --version | brew install colima docker |
| kubectl | kubectl version --client | brew install kubectl |
| gcloud | gcloud --version | brew install --cask google-cloud-sdk |
| Helm | helm version --short | brew install helm |
| gh | gh --version | brew install gh |
| Node.js | node --version | brew install node |
| jq | jq --version | brew install jq |
| cargo-nextest | cargo nextest --version | cargo install cargo-nextest --locked |
Install anything missing from the table above. Run independent installs in parallel (brew installs, cargo installs).
After installing gcloud, add to ~/.zshrc:
export PATH="/opt/homebrew/share/google-cloud-sdk/bin:$PATH"
Use the setup script or run manually:
./tools/setup-gke-auth.sh
Or manually:
gcloud auth login
gcloud components install gke-gcloud-auth-plugin --quiet
gcloud container clusters get-credentials main-0 --region us-east1 --project toptal-maestro
Verify: kubectl config current-context should return gke_toptal-maestro_us-east1_main-0
export MAESTRO_API_URL="https://api.maestro-staging.toptal.net"
maestro auth login
colima start
cd <repo-root> # /path/to/maestro
make dev-setup # installs cargo-watch
make install-hooks
make build # builds both API and CLI
maestro --version
maestro auth status
Single block to confirm everything works:
rustc --version && docker --version && kubectl config current-context && \
helm version --short && gh --version && node --version && \
cargo nextest --version && maestro --version && maestro auth status
See references/macos-gotchas.md for detailed explanations.
| Issue | Fix |
|---|---|
npm aliased to bun | Real npm at /opt/homebrew/bin/npm. Use full path or remove alias. |
| Docker socket not found | Start Colima: colima start |
| kubectl "current-context is not set" | Run step 3 (gcloud get-credentials) |
| gcloud not found after install | Add PATH to ~/.zshrc (step 2) and source it |
| Colima shell function warnings | Cosmetic — docker still works through the wrapper |
maestro auth expired | Re-run maestro auth login with correct MAESTRO_API_URL |