Pup - the AI's own browser

@@ -73,3 +73,45 @@ the wiki repo, not adom-desktop. Generic AD capabilities (a new lifecycle verb, above) → adom-desktop, but don't re-absorb the bridge.  ---++---++## ALSO: the bridge-authoring docs are stale — please update them (affects EVERY new bridge author)++A new user asking "make me an adom-desktop bridge for <X>" gets pointed at: the **`adom-desktop-bridges`**+Bridge SDK guide (#1 discovery hit), the **`adom-desktop-bridge-author`** skill, and the repo's+**`skills/BRIDGE_SDK.md`** (source). The RUNTIME guidance (bridge.json, verbs, health chip, rich hints,+lifecycle) is good + current. But the PUBLISH/PACKAGING guidance is outdated — and in one place WRONG.+These are AD-core-owned (we won't touch them, same as you don't touch pup), so please fix all three:++1. **WRONG — "zip/bin under `/files`".** `BRIDGE_SDK.md` "Publish + iterate" (and the `adom-desktop-bridges`+   page) tell authors the bridge zip goes on the page's `/files`. It does NOT — `/files` strips/rejects+   binaries. The zip is a **RELEASE asset** (`adom-wiki release create` + `release upload`); the manifest's+   `url` points at the release download URL with a matching `sha256`/`size`. (This is what fusion/kicad/pup+   actually do; following the doc as written produces a 404 manifest.)++2. **MISSING — the 3-artifact model.** A bridge page ships THREE things and the docs only really explain one:+   (a) the **release zip** = the runtime AD streams into bridges-cache; (b) the **pkg tarball**+   (`adom-wiki pkg publish`) = the container-side Claude/Codex skills (how the consumer skill reaches a+   container — completely absent today); (c) the optional **bundled seed** for AD-bundled bridges.++3. **MISSING — skill packaging + dev/user separation.** (a) the pkg `files` allowlist + the `skills/**`+   glob trap (a bare `"skills"` entry ships ZERO skill files); (b) keep the tarball LEAN — NO zip, NO+   `src/`, NO hero PNGs (`tar tzf` to confirm; it was 16 MB before guards); (c) **the wiki indexes EVERY+   `SKILL.md` in the repo** as an installable, Skills-tab-listed skill (`skill_count`) — so DEV/PUBLISH+   skills must be **source-only**, named NOT `SKILL.md` (e.g. `dev-skills/*.md`), or every user installs them.++4. **MISSING — `.codex/skills`.** `install.sh` should deploy the user skill to BOTH `~/.claude/skills` and+   `~/.codex/skills` (Codex is a real second agent skills home now).++5. **MISSING — discovery triggers.** Lead `discovery_triggers` with everyday USER phrases (not dev jargon)+   so "open my app in <X>" surfaces the page; the discover snippet is auto-generated from+   `discovery_triggers` + `discovery_pitch` (no separate upload step).++6. **STALE URL — the retired wiki host.** Both the `adom-desktop-bridges` page AND the+   `adom-desktop-bridge-author` skill still cite **`wiki-ufypy5dpx93o.adom.cloud`** (retired). The only host+   is `wiki.adom.inc`. Grep + scrub (incl. the `page.json` `readme` body).++**Easiest path:** lift the content from the pup bridge's now-canonical publish playbook —+`wiki.adom.inc/adom/adom-desktop-puppeteer-bridge` → `dev-skills/pup-bridge-publish.md` (it carries all six+points above, battle-tested) — and generalize the pup-specifics into the SDK guide.