Adom Hydrogen (platform base)

@@ -0,0 +1,81 @@+---+name: hydrogen-annotate+version: 1.0.0+description: >+  Annotate in Hydrogen Desktop: the pencil in the Title Bar (left of the bell) that lets the+  human draw on the whole Hydrogen window (a red circle, an arrow, a box, a text note, or a+  plain snip) and puts the marked-up area on the clipboard as a PNG, ready to paste into an AI+  thread. Covers the tools, Auto versus Multi capture, the keys, what the AI can do (POST+  /annotate opens the overlay for the human; the AI itself takes screenshots with+  POST /screenshot, not with annotate), and how to read what the user pasted. Trigger words:+  annotate, annotation, draw on the screen, red circle, circle it, mark it up, markup,+  pencil icon, pencil in the title bar, snip, snip a region, paste a screenshot into the chat,+  /annotate, annotate overlay, arrow on the screenshot, box on the screenshot.+---++# Annotate: draw on the screen, paste it into your AI thread++The pencil in Hydrogen's **Title Bar**, left of the bell and right of the CPU/RAM meter, is+**Annotate**. It puts a drawing canvas over the whole Hydrogen window (the editor, the wiki,+every panel; they are all under the same canvas), with the same toolbar pup uses. The human+draws, and the area around the drawing is captured and written to the clipboard as a PNG.+The point is the next step: paste it into an AI thread and say "this one".++## What the human sees++| Tool | What it does |+|---|---|+| Pen | Draw freehand. With Auto on, the capture fires the moment the mouse is released. |+| Arrow | Drag from tail to tip; the arrowhead lands where the mouse is released. |+| Box | Frame a region with a rectangle, corner to corner. |+| Text | Click where the note starts, type, press Enter. |+| Snip | Capture exactly a region, like Win+Shift+S: drag a marquee, it is copied on release, no strokes. |++Colours: red, blue, yellow on the bar, more one click deeper. Two capture modes:++- **Auto** (default): one shot. Draw one thing, lift the mouse, and it is captured, copied,+  and annotate mode closes. This is the "red circle" case.+- **Multi**: compose. Draw several shapes; nothing is captured until Done. The colour+  advances after each shape so every shape is distinct.++The capture is the composited window with the drawing on it, cropped tight around everything+drawn. A toast confirms it: "Captured 640×320, on your clipboard. Paste it into an AI thread."++Keys: **Enter** = Done (capture and close), **Esc** = leave without capturing, **Ctrl+Z** = undo+the last shape. Undo and Clear are on the bar too.++## What the AI does with it++**You do not need annotate to see the screen.** To look at Hydrogen yourself, take a+screenshot: `POST /screenshot` on the control API (the `hydrogen-self-screenshot` skill), or+`adom-bridge desktop_screenshot_window`. Annotate exists for the **human** to point at+something.++When the user pastes an annotated PNG into your thread, treat the drawing as the pointer: the+circled, boxed or arrowed thing is what they mean, and a text note is their comment. Read the+image before answering.++You can open the overlay for the human when that is the fastest way to get an answer ("circle+the part you mean"):++```bash+adom-bridge --target <desktop> hd_api '{"method":"POST","path":"/annotate","body":{"tool":"pen","mode":"auto"}}'+```++`tool` is pen | arrow | box | text | snip (default pen), `mode` is auto | multi (default auto),+`close: true` dismisses the overlay. The response says whether the window took it+(`ok`). Then say what you want them to mark and wait; the result lands on **their**+clipboard, not in your context, so ask them to paste it. Do not open the overlay while they are+typing or during a demo recording without saying so first; it covers the whole window until Esc.++## Where it lives++- The pencil: `src/lib/components/editor/EditorNav.svelte` (button next to the meters).+- The overlay and toolbar: `src/lib/components/AnnotateOverlay.svelte`, driven by+  `src/lib/stores/annotate.ts` (`startAnnotate(tool, mode)`, `closeAnnotate()`).+- The route: `POST /annotate` in `src-tauri/crates/hydrogen-control/src/lib.rs`.+- The capture itself is `POST /screenshot` with `target=full`, cropped in the overlay.++Related: `hydrogen-self-screenshot` (the AI's own screenshots), `hydrogen-captions` (text+overlays the AI puts on screen for narration; not for marking things up), `hydrogen-pup`+(pup's annotate, the same toolbar in the browser window).