docs: add flake-init command documentation

Author: svnlto

CLAUDE.md

@@ -20,6 +20,10 @@ nix develop
 
 # Validate flake
 nix flake check
+
+# Scaffold a new project from template
+flake-init              # uses "minimal" template
+flake-init <template>   # uses a specific template
 ```
 
 ## Commit Convention
@@ -57,6 +61,8 @@ common/
   ghostty/                       # Ghostty terminal (macOS only — guarded with mkIf)
   lazygit/                       # Cross-platform via xdg.configFile
   profiles/                      # Optional opt-in modules
+templates/
+  minimal/                       # Default flake template (devShell, direnv, pre-commit)
 systems/
   aarch64-darwin/                # macOS: home.nix, homebrew/, defaults.nix, dock.nix
   aarch64-linux/default.nix      # Linux: minimal HM config for containers

README.md

@@ -44,8 +44,28 @@ hmswitch                 # Apply Home Manager config (Linux)
 nix develop              # Dev shell with nixfmt, statix, deadnix, nil
 nix flake check          # Validate configuration
 nixswitch --show-trace   # Debug build failures
+flake-init               # Scaffold new project (defaults to minimal template)
+flake-init <template>    # Scaffold with a specific template
 ```
 
+### flake-init
+
+Scaffolds a new project directory using Nix flake templates stored in this repo. Uses `nix flake init` under the hood.
+
+```bash
+cd ~/Projects/new-thing
+flake-init          # creates flake.nix, .envrc, .gitignore, .pre-commit-config.yaml
+direnv allow        # activate the devShell
+```
+
+**Available templates:**
+
+| Template | Description |
+|----------|-------------|
+| `minimal` (default) | devShell with pre-commit, direnv, gitignore |
+
+Templates live in `templates/` and are registered as flake outputs.
+
 ## Structure
 
 ```