From f99f1e2f88f70e7e05a25cccef036e7f614aa1db Mon Sep 17 00:00:00 2001
From: Mortdecai <admin@mortdec.ai>
Date: Tue, 15 Sep 2026 18:55:36 -0400
Subject: [PATCH] docs: record hostname + design decisions and rejections

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 DECISIONS.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/DECISIONS.md b/DECISIONS.md
index b674abb..b897533 100644
--- a/DECISIONS.md
+++ b/DECISIONS.md
@@ -5,8 +5,21 @@ Project-specific decisions. For global/cross-cutting decisions, see `~/bin/DECIS
 Format: `YYYY-MM-DD: <decision> — <why>`
 
 ## Architecture
+- 2026-09-15: Hostname `mac` — matches the short-lowercase machine naming (`bebop`, `yoga`); `ssh mac` alias already points at 192.168.0.94.
+- 2026-09-15: Managed as `Brewfile` + idempotent `scripts/setup.sh` run over SSH from steel141 — seth is the console user so `defaults write` + `killall Dock` apply from SSH; GUI-only Tahoe toggles go in `docs/manual-checklist.md`.
+- 2026-09-15: Backup = nightly launchd rsync (`-a --delete`) of `~/Music/Ableton` + `~/Documents` -> `pve173:/tank/backups/mac/`, with a ZFS snapshot cron on pve173 for history — rsync is transparent and Linux-familiar; the snapshot covers the `--delete`-mirrors-a-mistake weakness.
 
 ## Implementation
+- 2026-09-15: Login shell = Homebrew bash 5 (`/opt/homebrew/bin/bash`) — Seth's steel141 shell is bash; Apple ships bash 3.2. zsh stays installed.
+- 2026-09-15: GNU coreutils/findutils/sed/grep/tar on PATH via gnubin (unprefixed) — Linux muscle memory beats BSD-compat; if a Homebrew script trips on GNU sed, fix PATH order in `~/.bash_profile`, don't prefix.
+- 2026-09-15: Window snapping = Rectangle — zero config; AeroSpace is the upgrade if tiling turns out to matter.
+- 2026-09-15: Spotlight indexing stays on, Siri/web suggestions off — Finder search is useful; Live's browser has its own index.
+- 2026-09-15: iCloud account stays, iCloud Drive Desktop&Documents sync OFF — cloud sync mid-save is a DAW project killer.
 
 ## Deferred / Rejected
 <!-- Decisions NOT to do something are just as valuable -- prevents re-proposing rejected ideas -->
+- 2026-09-15: Cmd<->Ctrl global swap REJECTED — Live 12 and every Mac tutorial are Cmd-native; kitty already handles Ctrl+Shift+C/V. Karabiner per-app remaps are the fallback, not a global swap.
+- 2026-09-15: yabai REJECTED — useful features need partial SIP disable. SIP/Gatekeeper/FileVault all stay on.
+- 2026-09-15: Time Machine REJECTED — over SMB it's fragile and whole-disk; rsync + tank-side ZFS snapshot covers the actual need.
+- 2026-09-15: Removing `/System/Applications` apps REJECTED — sealed system volume; hide from Dock instead.
+- 2026-09-15: Samples/projects on the SMB share REJECTED — local disk only; SMB is a copy source. External SSD is the capacity upgrade path.