docs: add terminal demo (gif/mp4/cast) + README

Record an interactive demo showing entry open -> flag browse -> Esc back
to the home screen with no intermediary step, then repeat for another
command. Add a root README that embeds the GIF and links the MP4/cast.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

README.md

@@ -0,0 +1,30 @@
+# super-man
+
+An interactive, fuzzy command + man-page flag browser for the terminal. Search
+260+ commands, drill into any one to fuzzy-search its flags with live
+descriptions, and jump back to the command list instantly.
+
+## Demo
+
+![super-man demo](demo/super-man-demo.gif)
+
+Video (MP4): [`demo/super-man-demo.mp4`](demo/super-man-demo.mp4) ·
+asciinema cast: [`demo/super-man-demo.cast`](demo/super-man-demo.cast)
+
+The clip shows opening an entry (`grep`), browsing its flags, then pressing
+**Esc** to return straight to the home screen — no intermediary step — and
+repeating with `tar`.
+
+## Usage
+
+```bash
+super-man                 # interactive home screen (fzf)
+super-man <command>       # jump straight to a command's flags
+super-man ask "<task>"    # natural-language task lookup
+super-man --list          # list all known commands
+```
+
+`Esc` in the flag browser returns to the command list; `Esc` on the home screen
+exits.
+
+See [`docs/`](docs/) for design notes and the full feature history.