After making changes, run the relevant step script from steps/ directly to verify it applies cleanly (e.g., ./install zsh). Run ./install for a full idempotent re-run across all steps.
Config files live in config/ and are symlinked into ~/ and ~/.config/ by the install script. Edit them in place in the repo.
DOTFILES_ENV controls home vs work configuration and is auto-detected from hostname in config/zsh/zshenv. Environment-specific Homebrew and Mise configs live in environments/home/ and environments/work/.