IDE Code Diff Syntax Theme Accessibility Overhaul
Write a design-to-engineering briefing email to frontend leads outlining tokenized syntax highlighting upgrades for code review interfaces.
Use this template when code diffing tools exhibit poor visual contrast or color-blindness collisions. It frames syntax token refactoring into an actionable engineering and design systems sprint.
Role: Lead Design Systems Engineer & Accessibility Specialist specializing in developer environments, IDE themes, and code review interfaces.
Context
- Code Review Tool: {{tool_name}}
- Accessibility Standard: {{wcag_conformance_target}}
- Key Token Conflict: {{syntax_token_conflict}}
- Developer Insights: {{developer_feedback_summary}}
- Design Token Palette: {{color_palette_tokens}}
- Target Release: {{rollout_milestone}}
Task
Draft a comprehensive briefing email to frontend tech leads and engineering managers announcing a structural redesign of syntax highlighting and diff indicators in {{tool_name}} to fulfill {{wcag_conformance_target}} and resolve {{syntax_token_conflict}}.
Method
- Synthesize {{developer_feedback_summary}} to demonstrate how current diff syntax harms readability during code reviews.
- Detail the contrast ratio failures in {{syntax_token_conflict}} across both dark and light theme modes.
- Present the semantic token model powered by {{color_palette_tokens}} that decouples syntax highlighting from diff addition/deletion states.
- Introduce redundant visual signifiers (gutters, line prefixes, textured backgrounds) that remove sole reliance on red/green hue perception.
- Explain how the proposed token mapping integrates cleanly with existing AST-based code tokenizers.
- Outline a zero-regression migration path for custom user-defined themes and legacy plugin overrides.
- Provide testing protocols involving automated contrast linters and screen-magnifier usability sessions.
- Establish milestone deliverables leading up to the targeted {{rollout_milestone}} release.
Constraints
- The output MUST be formatted as a professional engineering alignment email.
- Design token references MUST follow modern design token architecture naming conventions (e.g.,
color.diff.added.surface). - MUST NOT recommend dropping support for legacy dark themes; focus on non-destructive semantic variable mapping.
- Length must remain between 400 and 600 words.
Output format
- Subject: Design System Update: Accessible Syntax Highlighting & Diff Tokenization for {{tool_name}}
- Context & Problem Statement: Feedback synthesis and {{wcag_conformance_target}} compliance gaps (1 concise section)
- Technical Specification: Token Architecture Table/Mapping (3-5 core token mappings with contrast values)
- Implementation & Rollout Roadmap: Phased schedule targeting {{rollout_milestone}}
- Action Items for Frontend Engineers: 2-3 specific technical next steps
Self-review
- Does the email explicitly resolve {{syntax_token_conflict}} using {{color_palette_tokens}}?
- Are the accessibility constraints aligned directly with {{wcag_conformance_target}} criteria?
- Is the engineering guidance concrete enough for immediate frontend sprint estimation?
Explicit role, a named task, and discrete steps the model can follow.
Background, inputs and variables the model needs before it starts.
Hard boundaries — what the model must and must not do.
A named, field-level shape for the response.
Ordered work items that force analysis before an answer.
Length and structure that travel across frontier models.
Signal density — instruction weight without padding.
Documented variables so the scaffold adapts to new inputs.
Quality bar, assumptions and behaviour when inputs are thin.
How much real usage the template has behind it.