Comment by crabique

The trick for smooth experience is to treat it like `pacman -Syu`:

  brew update && brew upgrade && brew autoremove && brew cleanup && brew doctor

Running this every few days and fixing everything that it explicitly complains about kept me issue-free for the last 10 years or so.