skills for everythingsandi-metz-rules
This skill should be used when users request code review, refactoring, or code quality improvements for Ruby codebases. Apply Sandi Metz's four rules for writing maintainable object-oriented code - classes under 100 lines, methods under 5 lines, no more than 4 parameters, and controllers instantiate only one object. Use when users mention "Sandi Metz", "code quality", "refactoring", or when reviewing Ruby code for maintainability.
SKILL.md
| Name | sandi-metz-rules |
| Description | This skill should be used when users request code review, refactoring, or code quality improvements for Ruby codebases. Apply Sandi Metz's four rules for writing maintainable object-oriented code - classes under 100 lines, methods under 5 lines, no more than 4 parameters, and controllers instantiate only one object. Use when users mention "Sandi Metz", "code quality", "refactoring", or when reviewing Ruby code for maintainability. |
Dotfiles
Set up a fresh host with one command for development in the way I like it.
This is intended exclusively for my personal use, though I encourage you to steal the patterns, tools and concepts within.
What It Does
Most dotfiles repos just copy files to your home folder. This one does more. It installs apps, sets system settings, and more.
When you run dotf run it will:
- Bootstrap a minimal environment with Homebrew, Git, and this repository
- Add
dotfto your PATH via~/.local/bin - Run all defined Steps (see
dotf steps)
Commands
| Command | What it does |
|---|---|
dotf run | Set up your Mac. Safe to run many times. |
dotf upgrade | Refresh and upgrade mise tools, Pi extensions, Homebrew packages, and APT packages on Debian/Ubuntu. |
dotf steps | List every setup step with its class name and description. |
dotf help | Show help |
Installation
Clone this repo:
git clone https://github.com/nateberkopec/dotfiles.git ~/.dotfiles
Run the setup:
cd ~/.dotfiles
./bin/dotf run
For verbose output that also streams subprocess output:
DEBUG=true ./bin/dotf run
Philosophies
This is not intended to be run by anyone except me.
Supported platforms:
- MacOS with sudo
- MacOS without sudo
- Ubuntu 22.04
In general, because mise is crossplatform, if we can do it with mise, we should do it with mise.
My system should always be running the latest available Ruby release, so that's what this repo's Ruby version target is too.
dotf run aggressively overwrites existing user state. This repo is the source of truth.
Config should drive data, Steps should drive behavior.
Generated artifacts should not be edited as sources of truth, e.g. we ignore generated Brewfile.
We do not store secrets on the system in plaintext.
As far as OS settings go, I prefer low/no animation and performance.
There is a GTD-style ~/Documents/Inbox, which several Steps interact with.
I'm constantly using LLM agents in YOLO mode on my system, so basically I've installed the equivalent of a North Korean rootkit that's running all the time and my system needs to not leave lying around any sharp objects or passwords. See .gem/credentials as an example of the mitigations I take as a result.
We don't trust agents, we make sure they do the right thing and lock destructive/bad actions behind human authentication (immutable flags, 1password).
How It Works
The setup runs in Steps. Each Step is a Ruby class that does one thing: install packages, set up Fish, sync config files, etc.
Steps can depend on other steps.
Available Steps
Run dotf steps for the current step list, class names, and descriptions. See lib/dotfiles/steps/ for the implementations.
Adding Your Own Steps
See docs/implementing-steps.md to learn how.
Ubuntu 22.04
I'm working on supporting Ubuntu in addition to MacOS. It's in a ~half finished state but should eventually become a full "target" OS.
See docs/ubuntu-22.04.md for Ubuntu setup and GUI test container notes.
Project Layout
bin/ CLI tool
lib/dotfiles/ Core code and steps
files/ Config files to sync to home folder
docs/ Docs for contributors
test/ Test suite