fix(preview): say that previews need a preview URL and a simulator URL - #285
Open
angeloashmore wants to merge 7 commits into
Open
fix(preview): say that previews need a preview URL and a simulator URL#285angeloashmore wants to merge 7 commits into
angeloashmore wants to merge 7 commits into
Conversation
Agents asked to set up previews for a deployed website added the production preview URL and stopped. The root help did not mention the slice simulator URL, so the agent did not know a second setting exists or that a deploy changes it. The root help has a PREVIEWS section with both commands. The preview row and the set-simulator row name the simulator URL. The set-simulator argument says a website URL is accepted, which the command already appends /slice-simulator to. The production preview eval now sets a local simulator URL in its fixture, the same as prismic init does. The eval measured "set the simulator URL" instead of "update" it, and preview list showed no stale value for the agent to notice. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
The set-simulator command row said "for live previews", and the url argument said "Website or simulator URL". The root help now states both facts, and the set-simulator description already says that the command appends /slice-simulator to a website URL. The two command strings are back to their earlier text. The three evals that this branch affects still pass 5/5 each. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
The PREVIEWS help held the commands, the purpose of the simulator URL, the count of each setting, and the deploy step. The previews docs page holds all of it too, so the same facts lived in two places and could drift apart. The help now names the two settings and sends the reader to the docs. Agents read the page: one of five trials read it when the help was long, and five of five read it now. This makes the CLI depend on the docs page. Merge and deploy prismicio/prismic-docs-v4#3951 before this branch, because the evals workflow reads the docs at prismic.io. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
This reverts commit 4b1bd90.
The preview help called both settings "preview configurations". That name matches neither kind of preview that the docs describe, and it did not say that a repository holds preview URLs and a simulator URL. The command list now names the preview URL and the simulator URL. An EXAMPLES section shows both commands, in the form that other commands in this CLI use. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
The PREVIEWS section started with the two settings. A reader who does not know what a preview is got instructions with no context. One sentence now says what previews do. The rest of the section is unchanged. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
angeloashmore
marked this pull request as ready for review
September 5, 2026 04:06
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Resolves: #273
Description
An agent asked to configure previews for a deployed website sets the production preview URL and stops. Live previews in the Page Builder keep loading from localhost, so writers lose them after a deploy and nobody is told.
Nothing the agent reads says that previews have two settings. It reads
prismic --helpfirst, and the help named one. The help now says what previews are and names both settings. The preview command list names them too, in place of "preview configurations", which matches neither kind of preview.The eval passed 0 of 3 in the last recorded run and 15 of 16 local trials on this branch. The other evals held. The result does not depend on prismicio/prismic-docs-v4#3951.
The eval fixture also starts from a repository that
prismic initconfigured, so the eval measures the update after a deploy and not a first-time setup.Checklist
Preview
How to QA 1
🤖 Generated with Claude Code
https://claude.ai/code/session_01CgKyNmSz1frkfF8TqfL47F
Footnotes
Please use these labels when submitting a review:
⚠️ #issue: Strongly suggest a change.
❓ #ask: Ask a question.
💡 #idea: Suggest an idea.
🎉 #nice: Share a compliment. ↩