refactor: use michaotic username throughout, add cli/kitty/zsh configs and docs

README.md

@@ -2,14 +2,31 @@
 
 Nix configurations for iscg infra hosts.
 
-Hosts and naming scheme: see [garden.md](./garden.md).
+## hosts
 
-## rebuild
+- **poppy** - MacBook Air M1 (nix-darwin)
+- **muscari** - NixOS server with k3s
+- **rosemary** - backup VM (planned)
+
+See `docs/` for detailed documentation.
+
+## quick rebuild
 
 ```bash
 # poppy (macOS)
 darwin-rebuild switch --flake .#poppy
 
-# muscari, rosemary (NixOS)
-sudo nixos-rebuild switch --flake .#<host>
-```
+# muscari (NixOS)
+sudo nixos-rebuild switch --flake .#muscari
+```
+
+## documentation
+
+- [docs/structure.md](docs/structure.md) - how the config is organized
+- [docs/poppy.md](docs/poppy.md) - MacBook specific
+- [docs/muscari.md](docs/muscari.md) - server + k3s
+- [docs/shell.md](docs/shell.md) - zsh, prompt, aliases
+- [docs/terminal.md](docs/terminal.md) - kitty + themes
+- [docs/cheatsheet.md](docs/cheatsheet.md) - quick commands
+
+See also [garden.md](garden.md) for host naming scheme.