add ai feature

specs/008-ai-rename-command/quickstart.md

@@ -0,0 +1,29 @@
+# Quickstart – AI Rename Command
+
+1. **Preview AI suggestions before applying.**
+   ```bash
+   renamer ai --path ./photos --prompt "Hawaii vacation album"
+   ```
+   - Traverses `./photos` (non-recursive by default) and sends the collected basenames to `renameFlow`.
+   - Displays a preview table with original → suggested names and any validation warnings.
+
+2. **Adjust scope or guidance and regenerate.**
+   ```bash
+   renamer ai --path ./photos --recursive --hidden \
+     --prompt "Group by location, keep capture order"
+   ```
+   - `--recursive` includes nested folders; `--hidden` opts in hidden files.
+   - Re-running the command with updated guidance regenerates suggestions without modifying files.
+
+3. **Apply suggestions non-interactively when satisfied.**
+   ```bash
+   renamer ai --path ./photos --prompt "Hawaii vacation" --yes
+   ```
+   - `--yes` skips the interactive confirmation while still logging the preview.
+   - Use `--dry-run` to inspect output programmatically without touching the filesystem.
+
+4. **Undo the most recent AI batch if needed.**
+   ```bash
+   renamer undo
+   ```
+   - Restores original filenames using the ledger entry created by the AI command.