{"id":"mkt-style-guide-rewrite","audience":"marketing","category":"social-content","technique":"tone","title":"Rewrite an engineer's draft in your brand's voice","free":false,"task":"An engineer wrote the in-app message for Orbitly's new Status Digest feature, and it reads like a press release. Rewrite it in Orbitly's voice from the style guide, as an in-app message under 45 words in plain text. Open with what the reader gets (fewer status meetings), talk to the reader as \"you\", and use at least one contraction. Use the current customer number, and don't mention the internal code name. Write a prompt that gets that message.","materialLabel":"Draft and style guide (attached to your prompt automatically)","material":"DRAFT (from Leo, engineering):\n\nWe are thrilled to announce that Project Atlas is now live! Orbitly is excited to leverage cutting-edge AI to deliver a seamless, robust status reporting experience for users. Status Digest utilizes your existing tasks to automatically generate a weekly summary of what was completed, what is blocked, and what is next, which can then be shared with stakeholders. Trusted by over 10,000 companies worldwide, Orbitly continues to empower users to unlock synergy across teams! Click here to learn more.\n\n---\nORBITLY STYLE GUIDE (short version)\n\nWho we sound like: a calm teammate who's good at their job.\n- Say \"teams\" or \"you\", never \"users\".\n- Short sentences. One idea per sentence.\n- Contractions are good (you'll, it's, we've).\n- No exclamation marks in product copy.\n- Banned words: leverage, seamless, robust, utilize, synergy, empower, unlock, cutting-edge, thrilled, excited.\n- Lead with what the reader gets, not what we built.\n- Buttons and links say what happens: \"See your digest\", not \"Click here\".\n\n---\nNote from Priya (brand), Nov 1:\nPlease stop using \"10,000 companies\". That was a 2024 projection and we never hit it. The approved line is \"more than 8,000 teams\". Also, Atlas is the internal code name. Customers only ever see \"Status Digest\".\n\nFeature facts: Status Digest builds a weekly summary from your tasks: what's done, what's blocked, what's next. You can share it with one click. It's on all paid plans.","rules":[{"type":"maxWords","max":45},{"type":"plainText"}],"mistakes":[{"title":"Saying \"make it sound better\"","why":"The AI polishes the draft but keeps its corporate words and its excitement, because you didn't point it at the rules.","fix":"Add: \"Follow the style guide: no banned words, never 'users', no exclamation marks.\"","checks":["r0"]},{"title":"Keeping the draft's order","why":"AI rewrites sentence by sentence, so the message still opens with what Orbitly built, not what the reader gets.","fix":"Add: \"Open with the reader's benefit: fewer status meetings. Talk to them as 'you' and use contractions.\"","checks":["r1"]},{"title":"Carrying over stale facts","why":"The draft's 10,000 figure and the code name look official, so the AI keeps them.","fix":"Add: \"Use Priya's Nov 1 note: more than 8,000 teams. Never say Atlas.\"","checks":["r2"]},{"title":"Trusting the AI to count words","why":"AI is bad at counting. Ask for \"under 45 words\" and it often lands well over.","fix":"Cap each part: \"3 sentences, each under 12 words.\"","checks":["maxWords"]},{"title":"Forgetting where it's shown","why":"AI bolds the feature name, and the in-app message box shows the asterisks.","fix":"Add: \"Plain text, no bold.\"","checks":["plainText"]}],"promptHints":[{"label":"Points to the style guide","patterns":["style guide","banned","brand voice","voice"]},{"label":"Says how to open","patterns":["open(s)? with","start(s)? with","lead(s)? with","first sentence","benefit"]},{"label":"Uses the current facts","patterns":["8,?000","priya","atlas","code name"]},{"label":"Sets a word limit","patterns":["\\d+\\s*words","word (limit|count)"]},{"label":"Asks for plain text","patterns":["plain","no bold","no markdown"]}],"hint":"The AI won't apply a style guide just because it's on the page, and it won't drop facts that look official. Point it at the voice rules, say how to open, flag the outdated number, and set the length.","rubricLabels":["Follows the style guide's word rules: none of the banned words (leverage, seamless, robust, utilize, synergy, empower, unlock, cutting-edge, thrilled, excited), never says 'users', and has no exclamation marks","The first sentence is about what the reader gets (such as fewer status meetings or not having to write status updates), the message addresses the reader as 'you', and it contains at least one contraction (such as you'll, it's, don't)","Never mentions 'Project Atlas' or 'Atlas', and if it gives a customer count it says 'more than 8,000 teams', never 10,000 or 'companies'"]}