docs(voice): add "Leading with value" — lead with the benefit, active voice - #674
Conversation
… voice Extend the Headings rule to body copy: open with the outcome or the problem removed, then name the mechanism (second clause or link-out). Keep copy in active voice, with the reader as the subject. Surfaced while writing the Cloud MCP accessibility-support release entry. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
Pull request overview
Adds a new "Leading with value" subsection to .agents/voice.md, extending the existing Headings guidance to body copy with two rules: lead with benefit over mechanism, and use active voice addressed to the reader.
Changes:
- New
## Leading with valuesection appended after## Headings - Two bulleted rules with concrete examples
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
cypress-design
 |
||||||||||||||||||||||||||||
| Project |
cypress-design
|
| Branch Review |
ryanjwilke/voice-lead-with-value
|
| Run status |
|
| Run duration | 02m 11s |
| Commit |
|
| Committer | Ryan Wilke |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
 |
0
|
 |
0
|
 |
0
|
 |
0
|
 |
2
|
| View all changes introduced in this branch ↗︎ | |
Warning
No Report: Something went wrong and we could not generate a report for the Application Quality products.
cypress-design
|
||||||||||||||||||||||||||||
| Project |
cypress-design
|
| Branch Review |
main
|
| Run status |
|
| Run duration | 02m 23s |
| Commit |
|
| Committer | Ryan Wilke |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
|
|
0
|
|
|
0
|
|
|
0
|
|
|
0
|
|
|
2
|
| View all changes introduced in this branch ↗︎ | |
Warning
No Report: Something went wrong and we could not generate a report for the Application Quality products.
What
New "Leading with value" section in
voice.md, extending the existing Headings rule to body copy:Why
The Headings rule ("action-oriented over category labels") already captures this for headlines; copy reviews keep surfacing the same issue in body copy, where drafts open with the mechanism ("Cloud MCP exposes report data") instead of the payoff. Codifying it gives release/marketing copy a single rule to anchor on.
Surfaced while writing the Cloud MCP accessibility-support release entry on cypress.io.
🤖 Generated with Claude Code
Note
Low Risk
Documentation-only change to internal voice guidelines; no runtime or product behavior impact.
Overview
Adds a Leading with value section to the voice agent guide, extending headline guidance into body and marketing copy.
Copy should open with the reader’s outcome or problem removed, then name the feature or mechanism. Sentences should stay active and second-person (e.g. what your agent does), avoiding passive, mechanism-first leads.
Reviewed by Cursor Bugbot for commit 9bbe097. Bugbot is set up for automated code reviews on this repo. Configure here.