{"id":"pm-bug-report-from-support-thread","audience":"product-managers","category":"summarizing","track":"productivity","technique":"format","title":"Turn a long support thread into a clean bug report","free":false,"task":"Engineering needs a bug report from a long back-and-forth with a customer. Write a 'Summary:' line, then exactly 3 numbered steps to reproduce, then an 'Expected:' line and an 'Actual:' line, under 90 words, plain text. Use only what the customer confirmed, and leave out the customer's own guess at the cause and the chitchat.","materialLabel":"Support thread (attached to your prompt automatically)","material":"Support thread - ticket #4471 (Fieldnote mobile app)\n\nCustomer (Joan, Oct 2): Hi!! Love the app, use it every day for my garden club. Problem: when I add a photo to a note, the note disappears.\nAgent (Lee): Sorry about that! Which device and app version?\nJoan: iPhone 14, app version 6.2. Started after the update I think. Probably your servers are overloaded? My nephew says it's a server thing.\nLee: Does it happen with every photo?\nJoan: Only when I take a NEW photo with the camera button inside the note. If I pick an existing photo from my gallery, it's fine.\nLee: When does the note disappear?\nJoan: Right after I tap \"Use Photo\". The app goes back to my notes list and the note is gone. Not in trash either.\nLee: Does it happen with a brand new note or old ones too?\nJoan: Tried both today. Both. Before the update it worked fine.\nLee: Thank you! Logging this for the team.\nJoan: Thanks! Also is there a dark mode coming? My eyes, ha.","rules":[{"type":"numberedItems","count":3},{"type":"maxWords","max":90},{"type":"plainText"}],"mistakes":[{"title":"Asking to 'summarize the ticket'","why":"The AI retells the conversation in order, with bold headings.","fix":"Show the shape: \"Summary:, then 3 numbered steps, then Expected: and Actual:. Plain text.\"","checks":["numberedItems","plainText"]},{"title":"Trusting the AI to count words","why":"AI is bad at counting. Ask for a total word limit and it often lands over it.","fix":"Cap each part instead: \"each line under 15 words.\"","checks":["maxWords"]},{"title":"Vague steps","why":"The AI writes 'add a photo' and misses that only new camera photos fail.","fix":"Add: \"Steps must say the photo is taken with the camera button inside the note.\"","checks":["r0"]},{"title":"Missing the facts engineers need","why":"Device and version get dropped when the AI shortens things.","fix":"Add: \"Include the device and app version, and what happens right after 'Use Photo'.\"","checks":["r1"]},{"title":"Repeating guesses","why":"The customer's server theory sounds like a cause, and the AI includes it.","fix":"Add: \"Only facts the customer confirmed. No guesses about the cause.\"","checks":["r2"]}],"promptHints":[{"label":"Shows the report shape","patterns":["steps to reproduce","expected:?","actual:?"]},{"label":"Sets the number of steps","patterns":["\\b(3|three)\\b.{0,15}step"]},{"label":"Asks for device and version","patterns":["device","version","iphone"]},{"label":"Drops guesses","patterns":["guess","no (speculation|theor)","only.{0,20}(confirmed|facts)","server"]},{"label":"Sets a word limit","patterns":["\\d+\\s*words","word (limit|count)"]}],"hint":"Engineers need steps they can follow and facts they can trust. Show the AI the report shape, what details matter, and that guesses stay out.","rubricLabels":["The 3 steps are: open a note (new or existing), tap the camera button inside the note and take a new photo, tap 'Use Photo'","Expected says the photo is added and the note stays; Actual says the app returns to the notes list and the note is gone (not in trash); the summary or steps mention iPhone 14 and app version 6.2","Leaves out the customer's server-overload guess, the gallery workaround is either omitted or stated as working, and there is no dark mode question, greeting or chitchat"]}