How to review a Capsule ======================= Someone sent you a Capsule link — most likely a private preview of something an AI agent built (a page, a prototype, a report). This file explains what the link is and how to leave the kind of feedback that the publisher's agent can actually act on. If you're the publisher (the person whose agent created the artefact), read how-to-publish.txt instead. 1. What the link is ------------------- A Capsule share URL looks like: https://capsule.brinkbyte.com/s/ If your link has a ?ct=… piece on the end, that's the *comment token* — it means the publisher wants pinpoint feedback from you. The link itself is the only credential needed; treat it like a read-only key, don't post it publicly. You don't need an account. You don't need to install anything. Just open the link in a normal browser. 2. Leaving a comment -------------------- When the link has a comment token, every visible element on the page is clickable. Hover anywhere on the rendered artefact and you'll see the element highlight; click it and a small "Add a comment" dialog opens. The dialog captures three things: - Your comment (required) - Your name - Your email (required — so the publisher knows who left feedback) Each comment is anchored to the exact element you clicked. The publisher sees both the comment body and a snapshot of what you clicked on, so there's no "I think they meant the header on the second section" guesswork. Read-only previews (links without ?ct=) don't have comment mode. If the link doesn't react to clicks, that's why — ask the publisher to share the comment URL instead. 3. Threads, replies, and acceptance ----------------------------------- Comments are threaded. If the publisher replies, their reply shows up under your original. You can leave a follow-up on the same thread by clicking the reply icon on any comment. Each thread has a status that travels with it: OPEN — fresh feedback, nothing's happened yet IN_REVIEW — the publisher has acknowledged it ADDRESSED — the publisher has shipped an iteration that claims to address this comment ACCEPTED — you (the reviewer) marked it resolved When a comment is in ADDRESSED, you'll see an "Accept" / "Push back" pair on the thread leader. Hit Accept if the new version handles what you raised, or leave a follow-up explaining what's still off. 4. Iteration: same link, new content ------------------------------------ Capsule's pitch is "same link through every revision". When the publisher's agent re-publishes a new version, the URL you're already looking at quietly updates — refresh and you'll see the new artefact. Your comments stay anchored to the original elements; if the publisher's iteration removed or moved an element, the comment becomes "unanchored" and shows up at the top of the thread list. If a publisher hasn't iterated, the link still shows the original. There is no version history visible to reviewers — only the current live version, plus the comments you've left across the cycle. 5. Privacy + what the publisher can see --------------------------------------- The publisher can see: - Your name (as you entered it) - Your email (as you entered it) - The comments you've left + the elements they're anchored to - The fact that you opened the link, and roughly when The publisher cannot see: - Your IP address (Capsule strips it; only a per-day hash is kept for rate-limiting failed unlock attempts on password-protected links) - Anything about your machine, browser, or other tabs Capsule itself doesn't sell or share comment data. Storage is Australian East — see brinkbyte.com/privacy for the long version. 6. Help ------- If a link doesn't open, has expired, or asks for a password you don't have, contact the person who sent it — link state is controlled by the publisher, not by Capsule support. For anything else: alec@brinkbyte.com.