Signal/docs/signal-brand-extension-v1.md
2026-05-12 05:10:00 -04:00

168 lines
8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Signal CGM — Brand Extension v1
**Date:** April 2026
**Parent system:** `sttil-brand-system-v1.md`
**Status:** Active
---
## 1. Inheritance from STTIL Solutions
Signal CGM is a product expression of the STTIL Solutions brand. It inherits:
- Full teal scale (teal-950 → teal-50)
- Full tangerine scale as accent
- Plus Jakarta Sans / Inter / JetBrains Mono type stack
- All semantic status colors
- All spacing, radius, and shadow tokens
- "Never loud, always clear" visual principle
**What shifts for Signal CGM:**
- Clinical precision takes priority over narrative warmth
- Data density is higher — tables and status indicators are the primary surface
- Urgency communication is more explicit (regulatory deadlines, expiry countdowns)
- Dark mode is the operational default (dashboard use)
- Tangerine appears at the PA Required badge and highest-priority row — the two highest-stakes signals in the UI
---
## 2. Tone Shift
| STTIL Solutions | Signal CGM |
|----------------|-----------|
| Warm, narrative, brand story | Precise, operational, clinical |
| Speaks to the vision | Speaks to the daily task |
| "Built for people bearing real operational weight" | "PT-00142 · 4 days left · PA Required" |
| Earns trust through specificity | Earns trust through accuracy |
Signal CGM copy should read like a knowledgeable billing colleague, not a software vendor.
---
## 3. Dashboard / UI Palette
### Dark Mode (Operational Default)
| Element | Token | Hex |
|---------|-------|-----|
| Page background | `teal-950` | `#041A1A` |
| Card / panel | `teal-900` | `#072E2E` |
| Elevated surface / table header | `teal-800` | `#0A4444` |
| Heading text | `warm-white` | `#FFFAF6` |
| Primary body text | `text-primary-dark` | `#F0F4F4` |
| Secondary text | `teal-300` | `#5BBBBB` |
| Muted / metadata text | `muted-dark` | `#5A8080` |
| Border | `teal-700` | `#0F5E5E` |
| Row divider | `teal-700 at 45%` | `rgba(15,94,94,0.45)` |
| Primary brand / interactive | `teal-400` | `#2EA3A3` |
| Tangerine accent (borders/glows) | `tangerine-400` | `#F07840` |
| Tangerine text (gold) | `tangerine-300` | `#FFB070` |
| Tangerine glow shadow | `shadow.tangerine-glow-dark` | see tokens |
| Priority row wash | `sparkle.priority-row-bg-dark` | `rgba(224,104,48,0.09)` |
### Light Mode (Review / Export / Presentation)
| Element | Token | Hex |
|---------|-------|-----|
| Page background | `neutral-50` | `#F4F9F9` |
| Card / panel | `neutral-0` | `#FFFFFF` |
| Elevated surface | `neutral-100` | `#E5EEEE` |
| Heading text | `text-heading-light` | `#0A3030` |
| Primary body text | `text-primary-light` | `#1C2E2E` |
| Secondary text | `neutral-500` | `#5A7E7E` |
| Muted | `neutral-400` | `#7A9E9E` |
| Border | `neutral-200` | `#C8D8D8` |
| Primary brand | `teal-600` | `#147A7A` |
| Tangerine accent | `tangerine-500` | `#E06028` |
| Priority row wash | `sparkle.priority-row-bg-light` | `rgba(224,96,40,0.05)` |
---
## 4. CTA / Button Colors
| Button | Dark Mode | Light Mode | Usage |
|--------|-----------|------------|-------|
| Primary action | `teal-400` fill, `warm-white` label | `teal-600` fill, white label | "Initiate Outreach," "Export CSV" |
| High-urgency action | `transparent`, `tangerine-400` border, `tangerine-300` label | `transparent`, `tangerine-500` border, `tangerine-500` label | "Initiate PA →" — one per view |
| Ghost / secondary | `transparent`, `teal-700` border, `teal-300` label | `transparent`, `neutral-200` border, `neutral-500` label | "View," "Follow Up" |
| Destructive | `error-500` at 15% fill, `#FF7070` label | `error-100` fill, `error-600` label | "Mark Denied," "Archive" |
**Rule:** The tangerine CTA (PA action) appears at most once per screen. It is the most urgent action visible.
---
## 5. Status / Alert Colors — Healthcare Workflow
| Status | Icon | Light Badge | Dark Badge | When to Use |
|--------|------|-------------|------------|-------------|
| Active | ✓ | `success-100` bg / `success-600` text | `rgba(26,122,78,0.16)` / `#4AE899` | Coverage current, no action needed |
| Expiring Soon | ⚠ | `warning-100` / `warning-600` | `rgba(168,90,24,0.16)` / `#F0B464` | 3059 days remaining |
| Critical Expiry | ⚠ | `error-100` / `error-600` | `rgba(200,48,48,0.16)` / `#FF7070` | < 30 days remaining |
| PA Required | | `tangerine-100` / `tangerine-700` | `rgba(240,120,64,0.18)` / `#FFB070` | PA must be initiated |
| PA Pending | | `purple-100` / `purple-500` | `rgba(122,94,160,0.16)` / `#C0A8E0` | PA submitted, awaiting affirmation |
| Denied | | `error-100` / `error-600` | `rgba(200,48,48,0.22)` / `#FF7070` | Claim denied appeal path |
| Info | | `info-100` / `info-500` | `rgba(26,106,154,0.16)` / `#64B0D8` | Notes, system messages |
**Non-negotiable:** Every badge must use icon + label. Never color alone as the sole status indicator.
---
## 6. Worklist Table Conventions
- **Patient ID column:** JetBrains Mono, `font-weight: 700`. On priority row, color shifts to `tangerine-300` (#FFB070 dark) or `tangerine-700` (#903A14 light).
- **Priority Score:** JetBrains Mono, 16px, `font-weight: 500`. High (≥75): tangerine-text. Mid (4074): text-secondary. Low (<40): text-muted.
- **Days Left:** JetBrains Mono. Critical (<30): error red. Warning (3059): tangerine-text. OK (60+): text-primary.
- **Top priority row:** One `priority-row-bg` wash + `★ TOP PRIORITY` micro-label in tangerine-text. Only one per view.
- **Tangerine CTA:** Only on the top priority row's action button.
- **Table header:** `teal-800` background, uppercase `text-muted` labels at `font-size: 10.5px`, `letter-spacing: 0.06em`.
---
## 7. Pitch Deck Usage (Supplier-Facing)
**Slide structure:**
- Title / section slides: `teal-900` background, `warm-white` headline, `teal-300` sub-label
- Content slides: `neutral-0` background, `teal-700` section headers
- Data charts: `teal-500` primary series, `tangerine-400` for the key comparison metric
- Call-out boxes: `tangerine-100` background, `tangerine-700` text, `tangerine-500` left border (4px)
- The two-curve workload graph (appeals / proactive outreach flat) is the hero visual
**Supplier-facing language:**
- Lead with the denial rate: "3545% first-pass denial rate for CGM claims"
- Show the crossover point: "Month 4 proactive outreach volume replaces appeals volume"
- No AI language. No "platform." Call it a worklist tool.
---
## 8. LinkedIn / Social Posts
**Format — Signal CGM announcement post:**
- Carousel: 5 slides (hook problem data product shot outcome CTA)
- Cover slide: `teal-900` background, `warm-white` headline in Plus Jakarta Sans 700, one tangerine data point
- Data slides: `neutral-0` background, teal headers, JetBrains Mono for percentages
- One tangerine accent per slide never two
- CTA slide: `teal-600` background, white text, simple ask
**Tone:** Specific, grounded, no hype. Use actual regulatory dates and denial rates.
---
## 9. Billing Company-Facing vs. Supplier-Facing Materials
| Dimension | Supplier-Facing | Billing Company-Facing |
|-----------|----------------|----------------------|
| Primary pain | "My staff is buried in appeals" | "Our clients have high denial rates costing us rework" |
| Value frame | Prevent denials before they happen | Offer clients a differentiated CGM compliance tool |
| Regulatory hook | CMS competitive bidding deadline, PA affirmation rate | Same but also enrollment moratorium / compliance risk |
| Product language | "Signal CGM worklist" | "Signal CGM white-label ready" (future Phase 2) |
| Visual tone | Warm, operational, data-dense | Colder, more corporate, teal-900 dominant |
| CTA | "Try it with your next CSV import" | "Schedule a 30-minute walkthrough" |
---
## 10. PHI Note on All Materials
All Signal CGM marketing materials must include, at minimum in footer or fine print:
> "Signal CGM does not store patient names, dates of birth, or contact information. Only patient_id (your internal MRN or account number) is used as the crosswalk key."
This is a trust signal, not a legal disclaimer. Put it where a billing manager will see it.