ima-claude 2.9.0

package/plugins/ima-claude/skills/ima-bootstrap/references/theme-integration.md

@@ -0,0 +1,212 @@
+# Theme Integration Reference
+
+How IMA brand integrates with Bootstrap 5.3 via the Picostrap5 child theme.
+
+---
+
+## SCSS Pipeline
+
+The compilation order is critical — variables must be set before Bootstrap reads them.
+
+```
+main.scss
+├── _bootstrap-loader.scss          ← Bootstrap import chain
+│   ├── bootstrap5/functions        ← 1. Bootstrap functions
+│   ├── ninjabootstrap/variables    ← 2. Picostrap parent theme vars
+│   ├── _theme_variables.scss       ← 3. OUR OVERRIDES (loads IMA brand)
+│   │   └── @import ima-brand/sass/brand  ← IMA colors, typography, spacing
+│   ├── bootstrap5/variables        ← 4. Bootstrap defaults (our values take precedence)
+│   ├── bootstrap5/variables-dark   ← 5. Dark mode variables
+│   ├── bootstrap5/maps             ← 6. Sass maps
+│   ├── bootstrap5/mixins           ← 7. Mixins
+│   ├── bootstrap5/root             ← 8. CSS custom properties
+│   ├── bootstrap5/utilities        ← 9. Utility definitions
+│   ├── [all Bootstrap components]  ← 10. Component styles
+│   ├── ninjabootstrap/*            ← 11. Picostrap extensions
+│   └── bootstrap5/utilities/api    ← 12. Generates utility classes
+├── _wp_basic_styles.scss           ← WordPress basics
+├── _picostrap.scss                 ← Parent theme styles
+├── _woocommerce.scss               ← WooCommerce styles
+└── _custom.scss                    ← OUR CUSTOM STYLES (last = highest priority)
+    ├── plugins/ima-login/sass/login
+    ├── plugins/ima-forms/sass/ima-forms
+    ├── base/global-base
+    ├── base/header
+    ├── components/site-components
+    ├── components/forms
+    ├── components/badges
+    └── pages/*                     ← Page-specific styles
+```
+
+## Key Insight: Variable Override Strategy
+
+**`_theme_variables.scss`** loads _before_ Bootstrap's variables file. Since Bootstrap uses `!default`, our values take precedence:
+
+```scss
+// In _theme_variables.scss (loaded BEFORE Bootstrap)
+$primary: $ima-brand-primary !default;  // #040C53
+
+// In bootstrap5/_variables.scss (loaded AFTER)
+$primary: $blue !default;  // This is IGNORED because $primary already exists
+```
+
+This means **every Bootstrap component automatically uses IMA brand values** without any custom CSS.
+
+## What _theme_variables.scss Overrides
+
+### Theme Colors
+```scss
+$primary:   $ima-brand-primary;        // #040C53 Trustworthy Indigo
+$secondary: $ima-brand-secondary;      // #0296A1 Aquatic Pulse
+$success:   $ima-color-success;        // #28A745
+$warning:   $ima-brand-gold;           // #FFCC00 Vital Gold
+$danger:    $ima-brand-red;            // #DD153B Red Ribbon
+$info:      $ima-brand-teal-accessible; // #007BB4 WCAG teal
+$light:     $ima-brand-gray-light;     // #F2F3F5 Clarity Wash
+$dark:      $ima-brand-primary;        // #040C53
+```
+
+### Typography
+```scss
+$font-family-base:      $ima-font-family-secondary;    // Proxima Nova/Open Sans
+$headings-font-family:  $ima-font-family-primary;      // Lato
+$headings-font-weight:  $ima-font-weight-bold;         // 700
+$headings-color:        $ima-brand-primary;            // #040C53
+$body-color:            $ima-brand-black;              // #000000
+$font-size-base:        $ima-font-size-sm;             // 1rem (16px)
+$h1-font-size:          $ima-font-size-xxl;            // 40px
+$h2-font-size:          $ima-font-size-xl;             // 32px
+$h3-font-size:          $ima-font-size-lg;             // 28px
+$h4-font-size:          $ima-font-size-md;             // 20px
+$h5-font-size:          $ima-font-size-base;           // 18px
+```
+
+### Links
+```scss
+$link-color:            $ima-brand-secondary;          // #0296A1 teal
+$link-hover-color:      $ima-brand-accent-teal;        // #00B8B8 brighter
+$link-decoration:       none;
+$link-hover-decoration: underline;
+```
+
+### Buttons
+```scss
+$btn-padding-y:         $ima-button-padding-y;         // 20px
+$btn-padding-x:         $ima-button-padding-x;         // 40px
+$btn-font-size:         $ima-button-font-size;         // 18px
+$btn-font-weight:       $ima-button-font-weight;       // Bold
+$btn-font-family:       $ima-button-font;              // Lato
+$btn-border-radius:     $ima-border-radius-md;         // 10px
+$btn-border-radius-lg:  $ima-border-radius-xl;         // 20px
+$btn-border-radius-sm:  $ima-border-radius-sm;         // 5px
+$btn-box-shadow:        none;
+$btn-active-box-shadow: none;
+```
+
+### Forms
+```scss
+$input-border-color:      $ima-brand-gray;             // #919396
+$input-border-radius:     $ima-form-field-border-radius; // 15px
+$input-padding-y:         $ima-spacing-3;              // 16px
+$input-padding-x:         $ima-spacing-3;              // 16px
+$input-focus-border-color: $ima-brand-secondary;       // #0296A1 teal
+$form-label-color:        $ima-form-label-color;       // #919396
+$form-label-font-size:    $ima-form-label-size;        // 14px
+```
+
+### Cards
+```scss
+$card-border-radius:    $ima-border-radius-md;         // 10px
+$card-box-shadow:       $ima-card-shadow;              // none
+$card-spacer-y:         $ima-spacing-4;                // 24px
+$card-spacer-x:         $ima-spacing-4;                // 24px
+```
+
+### Navbar
+```scss
+$navbar-light-color:        $ima-brand-primary;        // Dark blue links
+$navbar-light-hover-color:  $ima-brand-secondary;      // Teal on hover
+$navbar-light-active-color: $ima-brand-accent-teal;    // Bright teal active
+```
+
+### Global
+```scss
+$border-radius:     $ima-border-radius-md;             // 10px
+$border-radius-sm:  $ima-border-radius-sm;             // 5px
+$border-radius-lg:  $ima-border-radius-lg;             // 15px
+$border-color:      $ima-brand-gray-light;
+$badge-border-radius: $ima-badge-border-radius;        // 5px
+```
+
+---
+
+## Picostrap Extensions (ninjabootstrap)
+
+The theme includes Picostrap's extended Bootstrap utilities:
+- `ninjabootstrap/positioning` — Extra positioning utilities
+- `ninjabootstrap/sizing` — Extended sizing classes
+- `ninjabootstrap/letter-spacing` — Letter spacing utilities
+- `ninjabootstrap/borders` — Extra border utilities
+- `ninjabootstrap/tailwind_grays` — Tailwind-style gray palette
+- `ninjabootstrap/theme_colors_shades` — Shade variants for theme colors
+
+---
+
+## _custom.scss Structure
+
+The custom styles file uses a modular import structure:
+
+```scss
+// Plugin styles
+@import "plugins/ima-login/sass/login";    // Login page styles
+@import "plugins/ima-forms/sass/ima-forms"; // IMA Forms library
+
+// Base
+@import "base/global-base";               // Global typography, links
+@import "base/header";                     // Site header
+
+// Components
+@import "components/site-components";       // Reusable components
+@import "components/forms";                 // Form overrides
+@import "components/badges";                // Badge styles
+
+// Pages
+@import "pages/activation-page";
+@import "pages/listing-single";
+@import "pages/directory-layout";
+@import "pages/listing-cards";
+@import "pages/my-account";
+```
+
+---
+
+## Where to Add New Styles
+
+| Type | Location |
+|------|----------|
+| Bootstrap variable override | `_theme_variables.scss` |
+| New IMA brand variable | `ima-brand/sass/_variables.scss` |
+| New IMA mixin | `ima-brand/sass/_typography.scss` or `_spacing.scss` |
+| Global base styles | `sass/base/global-base.scss` |
+| Reusable component | `sass/components/` (new file + import in _custom.scss) |
+| Page-specific styles | `sass/pages/` (new file + import in _custom.scss) |
+| Plugin styles | Import from plugin's sass directory in _custom.scss |
+
+## How to Recompile
+
+After SCSS changes: **Appearance > Customize > "RECOMPILE SASS"** in WordPress admin.
+
+---
+
+## Legacy Migration Reference
+
+| Old FLCCC Variable | New IMA Variable |
+|---------------------|------------------|
+| `$flccc-blue-dark` (#040C53) | `$ima-brand-primary` (exact match) |
+| `$flccc-blue` (#89CEDB) | `$ima-brand-sky` (#A2CFF0) |
+| `$flccc-blue-darker` (#496978) | `$ima-brand-secondary` (#0296A1) |
+| `$flccc-red` (#C90000) | `$ima-brand-red` (#DD153B) |
+| `$flccc-grey` (#707070) | `$ima-brand-gray` (#919396) |
+| `$flccc-grey-light` (#EDEDED) | `$ima-brand-gray-light` (#F2F3F5) |
+| Montserrat | `$ima-font-family-primary` (Lato) |
+| Open Sans | `$ima-font-family-secondary` (Proxima Nova/Open Sans) |

package/plugins/ima-claude/skills/ima-brand/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: ima-brand
+description: >-
+  IMA Brand Book v4.0 knowledge — identity, voice, logo rules, content guidelines,
+  audience profiles, and visual standards. Use when: writing IMA content, choosing brand voice/tone,
+  applying logo usage rules, selecting brand colors for design decisions, creating social media
+  content, drafting medical disclaimers, or reviewing brand compliance. Triggers on: IMA brand,
+  brand guidelines, brand voice, logo usage, brand colors, content tone, social media guidelines,
+  medical disclaimer, brand identity, IMA imagery, brand values, brand persona, IMA mission,
+  IMA audience. For CSS/SCSS implementation, see ima-bootstrap skill instead.
+---
+
+# IMA Brand Guidelines
+
+Brand Book v4.0 (September 2025) — Independent Medical Alliance.
+
+## Core Principle
+
+**Brand consistency builds trust in healthcare communication.**
+
+Every piece of content, every design decision, every communication should reinforce IMA's position as a trustworthy, patient-centric medical alliance.
+
+## Decision Tree
+
+```
+What type of brand question?
+├── Identity (who we are, mission, values)
+│   → references/brand-identity.md
+├── Audience (who we're talking to, messaging)
+│   → references/brand-identity.md
+├── Voice & Tone (how we sound, copywriting)
+│   → references/brand-identity.md
+├── Colors (palette, usage, accessibility)
+│   → references/visual-system.md
+├── Typography (fonts, hierarchy, weights)
+│   → references/visual-system.md
+├── Logo (usage rules, lockups, clear space)
+│   → references/visual-system.md
+├── Imagery (photography, iconography style)
+│   → references/visual-system.md
+├── Social Media (platforms, sizes, content)
+│   → references/digital-standards.md
+├── Legal (disclaimers, copyright, compliance)
+│   → references/digital-standards.md
+├── Accessibility (WCAG, contrast ratios)
+│   → references/digital-standards.md
+└── CSS/SCSS implementation?
+    → Use ima-bootstrap skill instead
+```
+
+## Quick Reference: Color Palette
+
+| Name | Hex | Usage |
+|------|-----|-------|
+| Trustworthy Indigo | `#00066F` | Primary brand, headers, trust |
+| Aquatic Pulse | `#00B8B8` | CTAs, buttons, links |
+| Accessible Teal | `#007BB4` | Hover states, WCAG compliance |
+| Guidance Sky | `#A2CFF0` | Light accents, backgrounds |
+| Vital Gold | `#FFCC00` | Warnings, attention |
+| Red Ribbon | `#DD153B` | Urgency, errors |
+| Plum Velvet | `#7B024D` | Accent, distinction |
+| Calm Stone | `#919396` | Secondary text, labels |
+| Clarity Wash | `#F2F3F5` | Backgrounds, cards |
+| Accessible Teal | `#007BB4` | High-contrast alternative |
+| Brand Gradient | `150deg, #00066F → #00B8B8` | Hero sections, overlays |
+
+## Quick Reference: Typography
+
+| Element | Font | Weight | Size |
+|---------|------|--------|------|
+| Page headers | Lato | Bold/Black | 40px |
+| Section headers | Lato | Bold | 20px |
+| Body text | Proxima Nova / Open Sans | Regular | 16px |
+| Buttons | Lato | Bold | 18px, uppercase |
+| Form labels | Open Sans | Regular | 14px |
+
+## Quick Reference: Voice & Tone
+
+| Context | Tone | Example |
+|---------|------|---------|
+| Website / General | Professional + Friendly | "We're here to support your health journey" |
+| Medical content | Professional + Informative | "Research suggests..." with citations |
+| Social media | Friendly + Inspirational | "Join thousands who've found better health" |
+| Crisis / Urgent | Supportive + Professional | "If you're experiencing..." with clear next steps |
+| Newsletters | Friendly + Supportive | "Here's what we've been working on for you" |
+| Fundraising | Inspirational + Supportive | "Your support makes independent research possible" |
+
+## Anti-Patterns
+
+| BAD | GOOD | Why |
+|-----|------|-----|
+| "FLCCC" in new content | "IMA" or "Independent Medical Alliance" | Rebranded; FLCCC is legacy |
+| Stretching or recoloring the logo | Use approved lockup variants | Brand integrity |
+| Logo on busy/patterned backgrounds | White, light, dark, or gradient bg only | Readability |
+| Logo below 200px width | Minimum 200px, use IMA lettermark for small sizes | Legibility |
+| Jargon-heavy copy without explanation | Plain language with medical terms defined | Patient accessibility |
+| Fear-based messaging | Solution-oriented, empowering language | Brand persona |
+| Missing medical disclaimer on health content | Include standard disclaimer | Legal compliance |
+| Inconsistent tone across channels | Match tone to context (see Voice table) | Brand consistency |
+| Using non-brand colors for key elements | Brand palette only for primary UI | Visual consistency |
+
+## Cross-References
+
+- **CSS/SCSS implementation** (variables, mixins, components): `ima-bootstrap` skill
+- **SCSS source files**: `~/IMA/dev/ima-brand/sass/` (ima-brand plugin repo)
+- **Brand identity deep dive**: [references/brand-identity.md](references/brand-identity.md)
+- **Visual system details**: [references/visual-system.md](references/visual-system.md)
+- **Digital & legal standards**: [references/digital-standards.md](references/digital-standards.md)

package/plugins/ima-claude/skills/ima-brand/references/brand-identity.md

@@ -0,0 +1,140 @@
+# IMA Brand Identity
+
+Source: IMA Brand Book v4.0, pages 4-10.
+
+---
+
+## About IMA
+
+- **Full name**: Independent Medical Alliance
+- **Formerly**: FLCCC Alliance (rebranded)
+- **Founded**: March 2020
+- **Type**: 501(c)(3) nonprofit organization
+- **Mission**: Empower patients, healthcare providers, and researchers through independent, evidence-based medical knowledge and resources
+- **Vision**: A world where every individual has access to trustworthy, independent medical guidance
+- **Core purpose**: Equip the global community with knowledge and tools for informed healthcare decisions
+
+**Key messaging**: IMA provides independent medical resources — not affiliated with pharmaceutical companies or government entities. This independence is the foundation of trustworthiness.
+
+---
+
+## Brand Values
+
+Seven core values guide all communications:
+
+| Value | Meaning | Content Application |
+|-------|---------|---------------------|
+| **Integrity** | Honest, transparent communication | Never overstate claims, cite sources, acknowledge limitations |
+| **Patient-Centric** | Patients' wellbeing comes first | Lead with patient benefit, use accessible language |
+| **Scientific Rigor** | Evidence-based, peer-reviewed | Reference studies, use precise medical terminology (with definitions) |
+| **Collaboration & Respect** | Work together across disciplines | Inclusive language, acknowledge diverse perspectives |
+| **Innovative Solutions** | Forward-thinking healthcare | Highlight novel approaches while grounding in evidence |
+| **Community & Support** | Build and nurture our community | Welcoming tone, encourage participation and sharing |
+| **Impartiality** | Independent from industry influence | Never endorse specific products, maintain neutral analysis |
+
+---
+
+## Target Audience
+
+### Primary Segments
+
+| Segment | Needs | Messaging Focus |
+|---------|-------|-----------------|
+| **Healthcare professionals** | Evidence-based protocols, clinical tools | Clinical data, peer-reviewed research, practical protocols |
+| **Researchers** | Data, methodology, collaboration | Scientific rigor, research findings, academic partnerships |
+| **Patients & caregivers** | Understandable health information | Plain language, actionable guidance, empowerment |
+| **Policymakers** | Evidence for health policy decisions | Data-driven insights, population health impact |
+| **Donors & supporters** | Impact of contributions | Mission impact stories, transparency, organizational progress |
+
+### Audience Profiles
+
+**Consumer audience** (patients, caregivers, general public):
+- Use plain language, define medical terms on first use
+- Focus on practical, actionable information
+- Empowering and supportive tone
+- Lead with "what this means for you"
+
+**Professional audience** (HCPs, researchers, policymakers):
+- Technical language appropriate but still accessible
+- Lead with evidence and data
+- Include methodology and sources
+- Professional, collegial tone
+
+---
+
+## Brand Persona
+
+Five tones that blend depending on context. No single communication should be purely one tone.
+
+### Professional
+- **When**: Medical content, research publications, healthcare provider communications
+- **How**: Authoritative but approachable, evidence-backed statements, precise language
+- **Example**: "Our protocols are developed through rigorous review of peer-reviewed literature and clinical experience."
+
+### Friendly
+- **When**: Social media, newsletters, community engagement, general website
+- **How**: Warm, approachable, conversational without being casual, inclusive
+- **Example**: "We're glad you're here. Let's explore what works for your health."
+
+### Inspirational
+- **When**: Fundraising, mission communications, impact stories, campaign launches
+- **How**: Uplifting, forward-looking, emphasize collective impact and possibility
+- **Example**: "Together, we're building a future where independent medical guidance is available to everyone."
+
+### Supportive
+- **When**: Patient-facing content, crisis communications, community support
+- **How**: Empathetic, reassuring, non-judgmental, focused on next steps
+- **Example**: "You're not alone in this. Here are resources that may help."
+
+### Informative
+- **When**: Educational content, FAQs, explainers, protocol summaries
+- **How**: Clear, structured, factual, progressive (simple → complex)
+- **Example**: "Vitamin D plays several roles in immune function. Here's what the research shows..."
+
+### Tone Blending by Channel
+
+| Channel | Primary Tone | Secondary Tone |
+|---------|-------------|----------------|
+| Website (general) | Professional | Friendly |
+| Medical protocols | Professional | Informative |
+| Social media | Friendly | Inspirational |
+| Newsletters | Friendly | Supportive |
+| Fundraising | Inspirational | Supportive |
+| Patient resources | Supportive | Informative |
+| Press / media | Professional | Informative |
+| Community forums | Friendly | Supportive |
+
+---
+
+## Copywriting Rules
+
+### Do
+
+- **Clear and concise**: Short sentences, active voice, one idea per paragraph
+- **Positive framing**: Focus on solutions, not just problems
+- **Active voice**: "IMA researchers discovered..." not "It was discovered by..."
+- **Consistent messaging**: Use approved terminology across all channels
+- **Accessible language**: Define medical jargon, use reading level appropriate to audience
+- **Call to action**: Every piece of content should guide the reader to a next step
+- **Cite sources**: Reference studies, link to protocols, provide evidence
+
+### Don't
+
+- **Overuse jargon**: Technical terms without explanation alienate patients
+- **Exaggerate claims**: "Cure" vs "may help manage symptoms" — precision matters
+- **Negative without solutions**: Don't just critique; offer alternatives
+- **Overly formal**: Authoritative ≠ stiff — maintain warmth
+- **Fear-based messaging**: Inform without alarming, empower without frightening
+- **Make medical claims without evidence**: Every health statement needs backing
+- **Use "FLCCC" in new content**: The organization has rebranded to IMA
+
+### Terminology Guide
+
+| Avoid | Prefer | Why |
+|-------|--------|-----|
+| FLCCC | IMA / Independent Medical Alliance | Rebrand |
+| "Cure" / "Treatment" (without context) | "Protocol" / "Approach" / "May help with" | Precision |
+| "You should" (directive) | "You may consider" / "Research suggests" | Patient autonomy |
+| "Alternative medicine" | "Integrative medicine" / "Complementary approaches" | Accurate framing |
+| "Big Pharma" / loaded terms | Name specific organizations or use neutral terms | Credibility |
+| "We believe" | "Evidence shows" / "Research indicates" | Evidence-based |

package/plugins/ima-claude/skills/ima-brand/references/digital-standards.md

@@ -0,0 +1,180 @@
+# IMA Digital Standards
+
+Source: IMA Brand Book v4.0, pages 26-30.
+
+For CSS/SCSS implementation details, see the `ima-bootstrap` skill.
+
+---
+
+## Digital Style Guide
+
+### Web Color Palette
+
+Same brand colors as print, using hex values. Key digital-specific notes:
+
+- **Background**: White (`#FFFFFF`) or Clarity Wash (`#F2F3F5`) for content areas
+- **Text**: Gravel (`#494949`) for body, Trustworthy Indigo (`#00066F`) for headings
+- **Links**: Aquatic Pulse (`#00B8B8`), hover → Accessible Teal (`#007BB4`)
+- **Gradient**: Reserve for hero sections and premium elements, not for small UI
+
+### Typography Hierarchy (Digital)
+
+| Element | Font | Size | Color | WCAG Ratio | Level |
+|---------|------|------|-------|------------|-------|
+| H1 | Lato Black | 40px | `#00066F` | 16.5:1 | AAA |
+| H2 | Lato Bold | 32px | `#00B8B8` | 5.04:1 | AA |
+| H3 | Lato Regular | 28px | `#DD153B` | 4.94:1 | AA |
+| Body | Proxima Nova | 16px | `#494949` | 9:1 | AAA |
+
+### Button Specifications
+
+| Type | Background | Text | Padding | Radius |
+|------|-----------|------|---------|--------|
+| Primary | `#00B8B8` | White | 20px / 40px | 10px |
+| Primary (hover) | `#007BB4` | White | 20px / 40px | 10px |
+| Primary wide | `#00B8B8` | White | 20px / 80px | 10px |
+| Large/digital | `#00B8B8` | White | 20px / 40px | 20px |
+| Outline | Transparent | `#00066F` | 20px / 40px | 10px |
+
+---
+
+## Accessibility (WCAG)
+
+### Contrast Ratios
+
+| Combination | Ratio | Level | Pass |
+|-------------|-------|-------|------|
+| Indigo `#00066F` on White | 16.5:1 | AAA | Yes |
+| Aquatic Pulse `#00B8B8` on White | 3.07:1 | — | Large text only |
+| Red Ribbon `#DD153B` on White | 4.94:1 | AA | Yes |
+| Body text `#494949` on White | 9:1 | AAA | Yes |
+| Accessible Teal `#007BB4` on White | 4.58:1 | AA | Yes |
+
+### Accessibility Requirements
+
+- **Color is not the only indicator**: Always pair color with text, icons, or patterns
+- **Alt text**: All images must have descriptive alt text
+- **Link text**: Descriptive links, not "click here" or "read more" alone
+- **Focus states**: Visible focus indicators on all interactive elements
+- **Font sizes**: Minimum 16px for body text, 14px for labels
+- **Touch targets**: Minimum 44x44px for mobile interactive elements
+- **High-contrast teal**: Use `#007BB4` when Aquatic Pulse (`#00B8B8`) doesn't meet contrast needs
+
+---
+
+## Social Media
+
+### Platforms
+
+| Platform | Primary Content | Tone |
+|----------|----------------|------|
+| **Instagram** | Visual stories, infographics, community highlights | Friendly + Inspirational |
+| **Facebook** | Articles, community engagement, events, fundraising | Friendly + Supportive |
+| **X (Twitter)** | News, quick updates, engagement, threads | Professional + Friendly |
+| **Telegram** | Community updates, direct communication | Supportive + Informative |
+
+### Image Sizes
+
+| Platform | Format | Dimensions |
+|----------|--------|------------|
+| Instagram | Post (square) | 1080 x 1080px |
+| Instagram | Story / Reel | 1080 x 1920px |
+| Instagram | Carousel | 1080 x 1080px per slide |
+| Facebook | Post | 1200 x 630px |
+| Facebook | Cover | 820 x 312px |
+| X (Twitter) | Post | 1200 x 675px |
+| X (Twitter) | Header | 1500 x 500px |
+
+### Content Pillars
+
+1. **Educational**: Health information, protocol summaries, research findings
+2. **Community**: Patient stories, testimonials, support group highlights
+3. **Advocacy**: Policy updates, medical freedom, patient rights
+4. **Behind the scenes**: Team spotlights, research process, organizational updates
+5. **Engagement**: Polls, Q&A, community questions, awareness campaigns
+
+### Social Media Voice
+
+- **Be human**: Conversational but professional, not robotic or corporate
+- **Be responsive**: Engage with comments, answer questions, acknowledge feedback
+- **Be visual**: Lead with compelling images/video, not just text
+- **Be consistent**: Same brand voice across all platforms, adjusted for format
+- **Be timely**: Post when audience is active, respond within 24 hours
+
+---
+
+## Content Guidelines
+
+### Copywriting & Formatting
+
+- **Headlines**: Clear, benefit-focused, under 10 words
+- **Paragraphs**: Short (2-3 sentences max for digital)
+- **Lists**: Use bullets for 3+ items
+- **Links**: Descriptive text, not URLs or "click here"
+- **CTAs**: One primary CTA per page/post, action-oriented ("Learn More", "Join Us", "Donate")
+
+### User-Generated Content (UGC) Rules
+
+- Always get written permission before reposting
+- Credit the original creator
+- Ensure content aligns with brand values
+- Do not use UGC that makes unverified medical claims
+- Moderate comments for harmful or misleading health information
+
+---
+
+## Legal & Compliance
+
+### Medical Disclaimer
+
+The following disclaimer (or equivalent) must appear on all content containing health information:
+
+> The information provided by the Independent Medical Alliance (IMA) is for educational and informational purposes only. It is not intended as a substitute for professional medical advice, diagnosis, or treatment. Always seek the advice of your physician or other qualified health provider with any questions you may have regarding a medical condition. Never disregard professional medical advice or delay in seeking it because of something you have read on this website or in our publications.
+
+### Where to Place Disclaimers
+
+| Content Type | Disclaimer Placement |
+|-------------|---------------------|
+| Website pages (health content) | Footer of the page |
+| Blog posts / articles | End of article, before comments |
+| Social media | Bio/about section + link to full disclaimer |
+| Email newsletters | Footer |
+| Videos | Description/caption + end card |
+| Downloadable resources | First or last page |
+
+### Copyright
+
+- Standard format: `2020-{current year} Independent Medical Alliance. All rights reserved.`
+- All original content is IMA property
+- Proper attribution required when citing external sources
+
+### Sponsored Content Disclosure
+
+- Clearly label all sponsored or partnership content
+- Use "Sponsored", "Partner Content", or "In collaboration with [name]"
+- Disclosure must be visible before user engages with content (not buried)
+- Follow FTC guidelines for influencer/partner disclosures
+
+---
+
+## Approval Workflow
+
+### Content Creation Process
+
+```
+1. Create    → Draft content following brand guidelines
+2. Review    → Brand review for voice, tone, visual consistency
+3. Approve   → Designated approver signs off
+4. Publish   → Schedule/publish via approved tools
+5. Monitor   → Track engagement, respond to comments
+```
+
+### Recommended Tools
+
+| Function | Tool |
+|----------|------|
+| Social scheduling | Hootsuite, Buffer |
+| Content calendar | Notion |
+| Design | Canva (with brand kit), Figma |
+| Analytics | Platform-native analytics |
+| Project management | Jira (see mcp-atlassian skill) |