Tie hero headline display size to word count, not just line count - #33
Merged
Conversation
Real skill output ("Flexion," a telehealth product) produced an
8-word headline that rendered across 5-6 lines of full-size display
type, dominating the hero and crowding the supporting visual. The
headline was within the stated 6-12 word budget, so the word-count
rule alone didn't catch it: nothing scaled the type down as length
grew, so a longer headline at the same size just took up more
vertical space instead of reading as intentionally sized.
references/hero-guidelines.md:
- Default attention budget: split the 6-12 word range into two
size bands. 6-8 words gets the full display size; 9-12 words steps
down roughly one clamp tier (about 15-20% smaller across the whole
range), not the same size wrapped across more lines. If a headline
needs both the long end of the word budget and the full display
size, that's a signal to cut the headline, not let the type absorb
the overflow.
- Responsive acceptance checks: added a concrete, checkable condition
— at the top of the size range the headline should fit in 2-3
lines; wrapping into 5+ lines at full size means step the size down
or shorten the headline, not accept it as a width constraint.
Closes #28
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this changes
Real skill output ("Flexion," a telehealth product) produced an 8-word hero headline that rendered across 5-6 lines of full-size display type, dominating the hero and crowding the supporting visual next to it. The headline was inside the stated 6-12 word budget, so the word-count rule alone didn't catch this — nothing scaled the type down as the headline got longer, so an 8-word headline at full size simply takes up more vertical space than a 6-word one.
references/hero-guidelines.md:clamp()range), not the same size left to wrap across more lines. If a headline needs both the long end of the word budget and the full display size, that's a signal to cut the headline.Closes #28
Test plan