Onboarding

First-time setup for a new workstation or a new contributor (human or AI).

Order of operations

1. Self-locate. Read your workstation's primary IPv4. 2nd octet .1 = home, .2 = office. Anything else — ask.
2. Install tooling. Pick the matching script from scripts/setup/:
3. Linux (Debian/Ubuntu): linux-apt-mise.sh
4. Linux (Arch/CachyOS/Manjaro): linux-arch-pacman.sh
5. macOS: macos-brew.sh
6. Windows 11: windows-winget.ps1
7. Windows + WSL2 Ubuntu: windows-wsl2.sh
8. Open in Zed. Project picks up .zed/settings.json on first open and prompts to install the recommended extensions. See scripts/zed/README.md.
9. Read the rules. CLAUDE.md + PRINCIPLES.md.
10. Verify access. network.md has the reachability matrix; workstation.md has the kubectl-access options.
11. Skim the repo map. repo-map.md.

Files

• workstation.md — durable workstation spec, kubectl access paths, troubleshooting.
• network.md — site + VLAN + tunnel + DNS truth.
• repo-map.md — where to find what.
• ../../scripts/setup/ — per-OS setup scripts.
• ../../scripts/zed/ — Zed project setup + recommended extensions.