{"id":"ind-sup-kb-article-thermostat","audience":"customer-support","category":"explaining","technique":"format","title":"Turn an engineer's Slack ramble into a help-center article","free":false,"task":"An engineer explained in Slack how customers reconnect their thermostat to new Wi-Fi, and you need a help-center article from it. Write a title phrased as a question, then exactly 6 numbered steps, each one sentence that starts with a verb, under 120 words total, plain text. Use the engineer's corrected timing and none of the internal jargon. Write a prompt that gets you exactly that.","materialLabel":"The Slack thread (attached to your prompt automatically)","material":"#support-escalations - Slack export (Calder Home, fictional)\n\nMarcus (Firmware): ok so for the Calder T3 when people change routers it won't find the new network. They have to do a soft AP re-provision. Basically:\nMarcus: pull the faceplate off (it just pops off, no screws), there's a tiny button on the back left\nMarcus: hold it 5 sec till the ring blinks blue - that puts it in AP mode\nMarcus: then on their phone open the Calder app, tap Devices, tap the T3, tap \"Change Wi-Fi\"\nMarcus: app will find the thermostat's own network, it's called CALDER-XXXX, connect to that\nMarcus: then they pick their new home network and type the password. Takes like a minute, ring goes solid green when it's done\nMarcus: then snap the faceplate back on\nMarcus: oh wait correction, it's 10 seconds not 5. 5 sec just reboots it. My bad\nJen (Support): can I tell customers the schedule is saved?\nMarcus: yes schedule + temps are stored on device, nothing lost\nJen: and the 2.4GHz thing?\nMarcus: T3 only works on 2.4GHz networks, not 5GHz. Most routers do both, they should pick the one without \"5G\" in the name\nJen: perfect, also who's bringing bagels friday\nMarcus: not me lol","rules":[{"type":"numberedItems","count":6},{"type":"maxWords","max":120},{"type":"plainText"}],"mistakes":[{"title":"Not giving the article a shape","why":"The AI writes an intro paragraph, a Prerequisites section and sub-steps, so step counts drift.","fix":"Be exact: \"A question title, then exactly 6 numbered steps, one sentence each, starting with a verb.\"","checks":["numberedItems","r0"]},{"title":"Trusting the AI to count words","why":"AI is bad at counting. Ask for \"under 120 words\" and it often lands well over.","fix":"Cap each part instead: \"each step under 16 words, title under 10 words.\"","checks":["maxWords"]},{"title":"Missing the correction","why":"The thread says 5 seconds first and fixes it later; the AI often keeps the first number.","fix":"Add: \"Hold the button 10 seconds (the engineer corrected 5).\"","checks":["r1"]},{"title":"Keeping engineer talk","why":"The AI repeats terms like \"soft AP\" and \"re-provision\" that customers don't know.","fix":"Add: \"Customers read this. No jargon like soft AP, AP mode or re-provision.\"","checks":["r2"]},{"title":"Ignoring where it will be pasted","why":"AI loves bold and headings, which show up as stray ** and # symbols in the help-center editor.","fix":"Name the place and the format: \"For the help-center editor. Plain text, no bold or headings.\"","checks":["plainText"]}],"promptHints":[{"label":"Sets the number of steps","patterns":["\\b(6|six)\\b.{0,20}steps?","steps?.{0,15}\\b(6|six)\\b"]},{"label":"Asks for a question title","patterns":["question","title"]},{"label":"Uses the corrected timing","patterns":["10 sec","ten sec","correct"]},{"label":"Bans jargon","patterns":["jargon","soft ap","plain (words|language)","everyday","customer"]},{"label":"Sets a word limit","patterns":["\\d+\\s*words","word (limit|count)"]}],"hint":"A help article is for customers, not engineers. Tell the AI the exact shape, which timing is right, and which insider terms to drop.","rubricLabels":["The first line is a title phrased as a question (ends with a question mark), and each of the 6 steps is one sentence beginning with a verb (like Remove, Hold, Open, Tap, Choose, Snap)","Says to hold the button for 10 seconds (never 5) until the ring blinks blue","Uses everyday words with none of the internal jargon ('soft AP', 're-provision', 'AP mode', 'firmware'), and if it mentions the network choice, says to pick the 2.4GHz one or the name without 5G"]}