Repository navigation
Description
Problem
The tutorial's optional share step (stim guide tutorial share) produces a thin pull request: gh pr create --fill builds the body from the commit, and it attaches one screenshot of the result. The reader sees no before state, no device, and nothing about how Stim verified the change. The goal is a pull request the user is pleased with: a one-line summary, a before/after table of the same screen on the same device, a "How it was verified" section (device and runtime, app readiness, build time and cache hit, stim logs --errors), and a Stim link.
appandflow/stim-tutorial#2 adds a matching .github/pull_request_template.md and an AGENTS.md that routes agents to stim guide tutorial, so the substance belongs in the version-matched guide.
Evidence
stim guide tutorial shareon origin/main:--fill, a singlefinish.png, and a fallback that commits the PNG and links it relatively (), which does not render in a pull request body.- Dry run with stim 1.19.0 and gh 2.99.0: before/after captured with
agent-device screenshotin one worktree (before the edit, then after Fast Refresh), andgh pr create --body-file body.md --attach screenshots/before.png --attach screenshots/after.pngrewrote the./screenshots/*.pngreferences inside the table touser-attachmentsURLs without appending duplicates (docs: agent instructions and a before/after PR template stim-tutorial#2). - Facts for the verified section:
stim status --json->ios.name,lastBuilds.ios.durationMs,lastBuilds.ios.cacheHit; readiness from thereadiness app reported readyline ofstim ios.
Cause
The share step predates the template and was written for a single proof image.
Fix idea
In stim guide tutorial: tell the agent to capture a before screenshot of each change before editing, then an after once Fast Refresh applies; rewrite the share step to write the body from the repo template and attach both images with --attach; update the manual share commands. Touch only the screenshot and PR parts.
Activity
janicduplessis commentedon Oct 10, 2026
Claimed: docs/3362-tutorial-share-pr