Philosophy

The dotfiles are a workstation interface, not just a set of copied config files. Bootstrap gets a host to the starting line; the workflow layer makes the machine predictable after setup.

Principles

• Keep WSL, CachyOS, and native Windows lanes explicit.
• Prefer project-local tooling over global guesses.
• Let one tool own each responsibility unless there is a documented exception.
• Keep Bash boring, Fish rich, and PowerShell native to Windows.
• Keep local-only secrets and host state outside this repository.

See the workflow primer for the detailed operating model.