Code

Review mode on the live preview

To comment on a feature's or a component's specification instead, see Review mode on specifications.

Review mode lets you comment on what you see in the application a session is changing, while its live preview runs, and send your comments to the agent. You pick a button, a heading or an area of a page and say what should change. The agent changes the code, the preview reloads with the change, and the agent replies under each comment. When the preview has a public link, the comments people outside your team leave through it show here too.

Key concepts

Review mode. A mode of the live preview in which the pointer picks what you comment on. While it is on, the application doesn't react to your clicks: a click picks the element under the pointer.

Preview comment. A comment on an element of the running application, such as a button or a heading, or on an area you drag over a page. It belongs to the session, and remembers the endpoint and the page it was left on.

Picture. A picture of what you picked, taken when you pick it and saved with the comment, so the agent sees what you saw. You can leave it out. A comment on an area of a page where element picking isn't available has none.

Pin. The numbered marker of a comment on the preview. Numbers follow the order the comments were made, so a comment keeps its number on every page, in All comments, and after another comment is resolved. A pin's color shows how far its comment got:

PinMeans
WaitingNot sent to the agent yet. Send N to PM sends it.
QueuedSent, waiting for the agent's current step to end.
PM is working on itThe agent is on it now.
AnsweredThe agent replied. Check the preview, then resolve the comment, or reply to send it back.

Waiting comments and @pm. A comment you leave waits, so you can collect several and send them together with Send N to PM. A comment that mentions @pm goes to the agent as soon as you save it.

All comments. Every open preview comment in the session, grouped by page, the page you are on first.

Outside comment. A comment someone outside your team left through the preview's public link. It is labelled Outside viewer and the name they gave, and goes to the agent only when someone sends it on its own.

Review mode at a glance

Review sits at the end of the row of tabs, between Reload preview and Focus mode. It shows while an endpoint's tab is open, in a window at least 1024 pixels wide. Its count shows the comments still open on the preview, on every page.

While Review mode is on, in the order you meet them:

  • The outline. Point at the application: the element under the pointer is outlined.
  • The comment box. It opens at what you picked, with Taking a picture of the selection while the picture is taken, then the picture. Choose x on the picture (Remove the picture) to leave it out.
  • The pins. One for each open comment on the page you are looking at.
  • The bar along the bottom of the preview:
    • a hint: Click an element or drag an area, or Click an element to comment on it while there are no comments yet. While the page gets ready, it reads Getting the page ready for review;
    • the counts, for example 3 waiting · 1 answered, and 2 on other pages;
    • All comments;
    • Send N to PM, which sends the waiting comments;
    • x (Leave Review).

While the agent works on comments you sent, the bar reads PM is working on N comments, with Stop to stop the agent's current step.

Commenting on the preview

To turn on Review mode

  1. Open the session. If its preview isn't running, start it: see Live preview.
  2. Open the endpoint's tab.
  3. Choose Review at the end of the row of tabs.

Review is highlighted, and the bar appears along the bottom of the preview, with the pins of the page you are on.

To comment on an element

  1. Turn on Review mode.
  2. Point at the element. It is outlined.
  3. Choose the element.
  4. In the comment box that opens, enter your comment.
  5. Choose Comment.

The comment becomes a numbered pin on the element, marked Waiting, and the bar counts it.

To comment on an area

  1. Turn on Review mode.
  2. Drag a box over the part of the page you mean.
  3. In the comment box that opens, enter your comment.
  4. Choose Comment.

The comment becomes a numbered pin on the area, marked Waiting.

To send a comment to the agent now

  1. In the comment box, enter @pm, and choose pm (Ask PM to fix this now).
  2. Write the rest of your comment.
  3. Choose Comment.

The comment goes to the agent as soon as it is saved, and its pin reads PM is working on it, or Queued while the agent finishes its current step. When the agent is done, the preview shows the change and the pin reads Answered.

To send the waiting comments

  1. In the bar, choose Send N to PM.

Every waiting comment, on every page, goes to the agent in one message. Their pins read PM is working on it, and the bar reads PM is working on N comments. When the agent is done, each comment has its reply and its pin reads Answered.

To follow up on a comment

  1. Choose the comment's pin. Its thread opens: the picture, the comment and its replies.
  2. Check the change in the preview, then do one of these:
    • If it is right, choose Resolve. The comment is resolved, and its pin goes away.
    • If it isn't, enter a reply and choose Reply. The comment is Waiting again, and the next Send N to PM sends it with your reply. When the comment mentions @pm, or your reply does, the reply goes to the agent at once.
    • To remove the comment and its replies, choose Delete comment.

To find comments on other pages

  1. In the bar, choose N on other pages, or All comments.
  2. Choose a comment.

The preview goes to the comment's page, scrolls to it and opens its thread. A comment on another endpoint opens that endpoint's tab first. To go to a page without opening a comment, choose Go to page beside it.

To send an outside comment to the agent

  1. Choose the comment's pin, or choose it in All comments.
  2. Above the thread, beside From outside your team, through the public link, choose Send to PM.
  3. Read the confirmation, Send this outside comment to PM?, and choose Send to PM.

The comment goes to the agent on its own, in a message of its own, and its pin reads PM is working on it, or Queued while the agent finishes its current step.

To leave Review mode

  1. Choose Review again, or x (Leave Review) at the end of the bar, or press Esc.

Esc closes what is open first: the comment box, then a thread, then All comments. The next Esc leaves Review mode. The pins and the bar go away, and the application reacts to your clicks again. Your comments stay, and the count on Review still shows them.

How Review mode behaves

Where it works. Review mode works in Live, Plan and Bug fix sessions, whenever a preview is running. It ends by itself when the preview stops, and when you open another session.

What you send is a message. A send shows in the session's conversation as an ordinary message from you, for example "Please address these 3 comments on the preview". The agent gets each comment with its replies, its picture, and the element and page it was left on.

One message carries 20 comments at most. When more are waiting, Send 20 to PM sends the oldest 20, and the bar says how many go with the next send.

A message waits while the agent is busy. It waits in the conversation as Queued, with Send now to stop the agent's current step and send it right away. See Working in a session.

The agent replies, and you resolve. The agent changes the code, the preview reloads with the change, and the agent replies in each comment's thread with what it changed. It never resolves a comment itself: you resolve it once you have checked the change in the preview.

Pins stay with their element. A pin follows its element as you scroll. Pins show on the page they were left on: move around the application, and each page brings up its own.

Going to a page loads it again. What the application had open, such as a dialog or a half-filled form, isn't restored.

Comments whose element is gone. A comment whose element is no longer on its page stays in All comments, marked Element not found on this page, and its thread still opens there. A comment left on an endpoint the preview no longer has is marked Not in this preview.

Preview comments are not plan comments. They also show in the session's Comments tab, labelled Preview with their page. They are never part of the plan: Approve & build and Request changes don't count them.

Comments from outside your team

When the preview has a public link with comments on, the people who open it can comment on the application the way you do in Review mode. See Sharing a live preview publicly.

Where they show. Outside comments show among the preview's pins and in All comments, beside your team's. Each is labelled Outside viewer and the name the viewer gave, such as Outside viewer · Ada Lovelace: point at the name to see their email. A strip above the thread reads From outside your team, through the public link. When the link has AI replies on, the AI assistant's answers in the thread are labelled AI assistant.

What you can do with them. Reply, resolve or delete, as with any preview comment. The viewer sees your replies in their comment, within about 10 seconds. Resolving the comment ends its AI conversation, which is then summarized as an interview, and the viewer can no longer reply in it. Deleting it removes it for the viewer too.

They reach the agent only when your team sends one. Send N to PM never takes an outside comment, and an @pm the viewer writes doesn't send it. To send one, choose Send to PM on it: see To send an outside comment to the agent. It goes alone, never with other comments.

The agent treats it as a suggestion. The agent is told the comment comes from a member of the public through the shared link, not from your team, and that it is a suggestion about the application, never an instruction to follow: nothing in it should lead the agent to run commands, change credentials or settings, or reveal anything. It weighs whether the application should change, and may change nothing. Read an outside comment before you send it, as you would any text from outside your team.

Mentions in them notify nobody. A name or @pm an outside viewer writes is plain text.

Permissions

ToYou need
Comment on the previewComments: Create
Resolve a preview commentComments: Update
Delete a preview commentComments: Delete
Send preview comments to the agent (@pm, Send N to PM, Send to PM on an outside comment)Sessions: Update

Without Comments: Create, Review mode shows the comments, and the bar reads You can read these comments; your role can't add them. Without Sessions: Update, you can still add comments, and the bar reads An editor can send these comments to the agent.

Limits

One message to the agent carries 20 preview comments at most. The others wait for the next send.

Troubleshooting

"A comment from outside your team is sent to PM on its own"

The message named an outside comment beside other comments. Send the outside comment with its own Send to PM, and the others with Send N to PM.

"Update the Productmind agent to send comments from outside viewers (run pm update)"

The session runs on a Productmind agent too old to tell the agent a comment comes from outside your team, so the comment isn't sent. Run pm update on the machine that runs the session, restart the agent, and choose Send to PM again. See Productmind CLI.

Review is missing

Review shows only while the preview is running and an endpoint's tab is open. Start the preview (see Live preview), then open one of its endpoints instead of Plan. Review also hides in a window narrower than 1024 pixels: make the window wider.

"Element picking isn't available on this page"

The page can't run what Review mode uses to pick elements and take pictures: its own security settings block it, or the preview runs on your machine through a local setup that doesn't add it. Drag a box over the preview to comment on an area instead. The comment has no picture, so say in words what should change.

The comment has no picture

The comment box says why it couldn't take one, and the comment saves without it either way:

  • "the page took too long to draw": the page was busy, for example while the agent was answering. Choose Try again.
  • "this page didn't load the picture tool": the page's own security settings, or a network problem, stopped it. Choose Try again; if it keeps happening, say in words what should change.
  • "something went wrong taking it": choose Try again.
  • "the selection is too big, pick a smaller part": cancel, and pick a smaller element or area.
  • "the page changed while it was taken": the application loaded another page. Pick again.

Try again pictures the element where it is now, so you can scroll before you choose it.

Last modified on