spb/ultra-sharp-agent-skills Public

1<!--2Author: Simon-Pierre Boucher3Contact: contact@spboucher.ai4-->56# Examples — Release Notes House Style78## Contents9- Bullet-level pairs (do / never)10- Breaking-change placement11- Complete before/after release1213## Bullet-level pairs (do / never)1415**Pair 1 — benefit first**16- ✅ "Dashboards now refresh automatically every 30 seconds — no more manual reloads."17- ❌ "Implemented WebSocket-based polling refactor for dashboard state (JIRA-4521)."1819**Pair 2 — plain language**20- ✅ "Fixed a bug where exported CSVs dropped the last row."21- ❌ "Resolved an edge-case regression in the serialization pipeline impacting terminal record emission."2223**Pair 3 — noise cut**24- ✅ (entry omitted entirely)25- ❌ "Bumped lodash from 4.17.20 to 4.17.21."2627**Pair 4 — no filler**28- ✅ "Fixed three crashes on startup affecting Windows users with non-Latin usernames."29- ❌ "Various bug fixes and performance improvements."3031## Breaking-change placement3233✅ Correct — top of the notes, before any heading:3435```markdown36## Acme CLI 3.0.0 — 2026-08-013738> **Breaking:** `acme deploy` now requires `--env`. Add `--env production` to existing scripts.3940This release focuses on safer deployments.4142### Added43- ...44```4546❌ Wrong — buried as a bullet:4748```markdown49### Improved50- Deploy command now requires an environment flag (breaking).51```5253## Complete before/after release5455**Input (engineer's commit list):**5657```58- feat: add SSO via SAML (ENG-201)59- perf: rewrite query planner, p95 latency 840ms -> 210ms60- fix: null pointer when profile avatar missing61- chore: upgrade CI runners to ubuntu-24.0462- refactor: extract billing module63- feat!: remove legacy /v1/auth endpoint64```6566**❌ Never ship this (implementation-first, noise included, breaking buried):**6768```markdown69## 2.8.070- Added SAML SSO support (ENG-201)71- Rewrote query planner72- Fixed NPE on missing avatar73- Upgraded CI to ubuntu-24.0474- Extracted billing module75- Removed /v1/auth (breaking)76```7778**✅ House style:**7980```markdown81## Acme 2.8.0 — 2026-08-058283> **Breaking:** The legacy `/v1/auth` endpoint is removed. Switch integrations to `/v2/auth` before upgrading.8485Faster searches and single sign-on headline this release.8687### Added88- Sign in with your company account: SAML single sign-on is now available on all Team plans.8990### Improved91- Search is dramatically faster — most queries now return in about 0.2 seconds instead of nearly a second.9293### Fixed94- Fixed a crash when opening a profile that has no avatar.95```9697Note: the CI upgrade and billing refactor are correctly absent (no user impact).98