{"id":"pm-admin-release-notes-action","audience":"product-managers","category":"writing-emails","track":"writing","technique":"audience","title":"Write release notes for IT admins, action items first","free":false,"task":"This release includes changes that IT admins at customer companies must act on. Write an email body with a first sentence naming the one action admins must take and its deadline, then at most 3 bullets on the other admin-facing changes, plain text, under 90 words. Leave out end-user features and internal changes, and use the corrected deadline.","materialLabel":"Release notes draft (attached to your prompt automatically)","material":"Release 7.4 - Tallyroom (ships May 6). Draft notes from eng + PM.\n\nAdmin-facing:\n- ACTION REQUIRED: Admins must re-authorize the Google Workspace integration (new permission scopes). If not done, calendar sync stops. Deadline: May 20.\n  UPDATE May 2: deadline extended to June 3 after customer feedback.\n- New: admins can set a default retention period for deleted docs (7, 30 or 90 days). Default stays 30.\n- New: audit log now includes \"file downloaded\" events.\n- Change: SSO session timeout max raised from 12 to 24 hours (admin setting; default unchanged at 8).\n\nEnd-user features (not for admins email):\n- Dark mode for mobile.\n- Emoji reactions on comments.\n\nInternal (don't send):\n- Migrated search to a new cluster.\n- Fixed flaky test suite.\n\nAudience: IT admins. They are busy, skim email, and get annoyed by marketing language.","rules":[{"type":"maxBullets","max":3},{"type":"maxWords","max":90},{"type":"plainText"}],"mistakes":[{"title":"Burying the action","why":"The AI follows the draft order or leads with new features.","fix":"Add: \"First sentence: re-authorize Google Workspace by June 3, or calendar sync stops.\"","checks":["r0"]},{"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: \"first sentence under 25 words, each bullet under 15 words.\"","checks":["maxWords"]},{"title":"Using the old deadline","why":"May 20 appears first, and the update is below it.","fix":"Add: \"Use the extended deadline, June 3.\"","checks":["r0"]},{"title":"Including everything","why":"The AI adds end-user features and internal work, so admins can't find what matters.","fix":"Add: \"At most 3 bullets, admin changes only.\"","checks":["maxBullets","r1","r2"]},{"title":"Marketing tone","why":"Release notes drift into 'We're excited to announce...'.","fix":"Add: \"Plain, factual tone. Plain text, no bold.\"","checks":["r2","plainText"]}],"promptHints":[{"label":"Puts the action first","patterns":["first sentence","action","lead with","start with"]},{"label":"Uses the extended deadline","patterns":["june 3","extend","update"]},{"label":"Admin changes only","patterns":["admin","no end.user","leave out","internal"]},{"label":"Sets the tone","patterns":["no marketing","factual","plain tone","excited"]},{"label":"Sets a word limit","patterns":["\\d+\\s*words","word (limit|count)"]}],"hint":"Admins skim for what they must do. Tell the AI the action and corrected deadline go first, which changes count, and to skip the marketing tone.","rubricLabels":["The first sentence says admins must re-authorize the Google Workspace integration by June 3 (not May 20), and that calendar sync stops if they don't","The bullets cover the other admin changes: deleted-doc retention setting (7, 30 or 90 days, default 30), file downloaded events in the audit log, and SSO session timeout max raised to 24 hours","Leaves out dark mode, emoji reactions and internal changes, and uses no marketing language ('excited', 'game-changing', 'powerful')"]}