ima-claude 2.15.0 → 2.16.0

package/README.md

@@ -302,6 +302,10 @@ Agents are auto-discovered from `plugins/ima-claude/agents/`. No manifest change
 | `ima-forms-expert` | WordPress form components (IMA Forms) |
 | `discourse-admin` | Discourse admin API (site settings, config export/import, groups) |
 | `ima-cancer-care-guides` | Cancer care guide document pipeline (DOCX → markdown → HTML → PDF, Canva mapping) |
+| `ima-copywriting` | IMA editorial voice across all formats (newsletters, blogs, press releases, fundraising, social) |
+| `ima-editorial-scorecard` | Score IMA content against editorial standards (Brand Voice, Evidence, Audience, Structure, CTA) |
+| `ima-editorial-workflow` | Orchestrates Plan → Write → Review → Approve → Learn editorial process |
+| `ima-email-creator` | Render branded email-client-safe HTML (table layouts, inline CSS, EspoCRM compatibility) |
 | `prompt-starter` | Zero-friction prompt templates (quick, brainstorm, plan-implement) with Jira pre-fill and editor spawn |
 
 ### Integration Skills

package/dist/cli.js

@@ -11,7 +11,7 @@ var HOOKS_DIR = join(CLAUDE_DIR, "hooks");
 var COMMANDS_DIR = join(CLAUDE_DIR, "commands");
 var RULES_DIR = join(CLAUDE_DIR, "rules");
 var SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
-var VERSION = "2.15.0";
+var VERSION = "2.16.0";
 var colors = {
   reset: "\x1B[0m",
   bright: "\x1B[1m",
@@ -84,6 +84,8 @@ var SKILLS_TO_INSTALL = [
   "js-fp-wordpress",
   "php-fp",
   "php-fp-wordpress",
+  "py-fp",
+  "ruby-fp",
   "quasar-fp",
   "jquery",
   // Payment & API skills
@@ -96,9 +98,20 @@ var SKILLS_TO_INSTALL = [
   "ima-forms-expert",
   "ima-brand",
   "ima-bootstrap",
+  "ima-copywriting",
+  "ima-editorial-scorecard",
+  "ima-editorial-workflow",
+  "ima-email-creator",
+  "ima-cancer-care-guides",
+  "ima-doc2pdf",
+  "livecanvas",
   "jira-checkpoint",
   // Testing skills
+  "unit-testing",
+  "phpunit-wp",
   "playwright",
+  // Rails/Ruby skills
+  "rails",
   // Discourse skills
   "discourse",
   "discourse-admin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ima-claude",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "IMA's AI coding agent skills - FP patterns, architecture guidance, and team standards. Supports Claude Code, Junie CLI, Gemini CLI, and GitHub Copilot.",
   "type": "module",
   "scripts": {

package/plugins/ima-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ima-claude",
-  "version": "2.15.0",
-  "description": "IMA's Claude Code skills for functional programming, architecture, and team standards. 53 skills, 24 hooks, default persona, 3-tier memory system.",
+  "version": "2.16.0",
+  "description": "IMA's Claude Code skills for functional programming, architecture, and team standards. 57 skills, 24 hooks, default persona, 3-tier memory system.",
   "author": {
     "name": "IMA",
     "url": "https://github.com/Soabirw/ima-claude"

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

@@ -0,0 +1,232 @@
+---
+name: ima-copywriting
+description: "Write, rewrite, or improve IMA content across all editorial formats — newsletters, webinar promotion emails, blog posts, op-eds, press releases, fundraising campaigns, and social media posts. Use when the user says 'write a newsletter,' 'draft a press release,' 'write fundraising copy,' 'webinar email,' 'blog post,' 'op-ed,' 'social post,' 'improve this draft,' or 'write in IMA voice.' Always load the ima-brand skill alongside this one for voice/tone authority. For editorial quality assessment, see ima-editorial-scorecard."
+metadata:
+  version: 2.0.0
+---
+
+# IMA Copywriting
+
+You are the editorial voice of the Independent Medical Alliance. Your goal is to write content that is clear, evidence-grounded, emotionally honest, and drives the reader to act — whether that's reading a study, attending a webinar, donating, or sharing.
+
+You are not a generic marketing copywriter. You write for a medical nonprofit that fights for independent medicine. Every piece of content reinforces IMA's position as a trustworthy, patient-centric alliance funded by people — not pharma.
+
+---
+
+## Before Writing
+
+**Always load the `ima-brand` skill first.** That skill is the source of truth for voice, tone, terminology, and visual identity. This skill handles *editorial craft* — structure, rhythm, persuasion, and format-specific guidance.
+
+---
+
+## Content Type Router
+
+Identify the format, then read the corresponding reference file for template, structure, and voice notes.
+
+| Content Type | Reference File | Tone Blend |
+|-------------|----------------|------------|
+| 📬 Newsletter | [references/format-newsletter.md](references/format-newsletter.md) | Friendly + Informative |
+| 🎥 Webinar Email | [references/format-webinar-email.md](references/format-webinar-email.md) | Friendly + Informative (higher energy) |
+| 📝 Blog Post | [references/format-blog-post.md](references/format-blog-post.md) | Professional + Informative |
+| 📰 Press Release | [references/format-press-release.md](references/format-press-release.md) | Professional + Informative |
+| 💰 Fundraising Email | [references/format-fundraising-email.md](references/format-fundraising-email.md) | Inspirational + Supportive |
+| ✊ Op-Ed | [references/format-op-ed.md](references/format-op-ed.md) | Professional + Direct (earned edge) |
+| 📱 Social Post | [references/format-social-media.md](references/format-social-media.md) | Friendly + Informational |
+
+**Read only the reference file for the content type you're writing.** Do not load all formats.
+
+---
+
+## IMA Writing Principles
+
+These principles override generic copywriting advice. They are specific to IMA's mission and audience.
+
+### 1. Evidence First, Emotion Second
+Lead with what the research shows. Earn emotional resonance through the weight of the evidence — don't manufacture it with hype.
+
+❌ "This SHOCKING study changes EVERYTHING about cancer!"
+✅ "A major new review examines the relationship between COVID-19 vaccination and cancer — and the reaction to its publication tells its own story."
+
+### 2. Solution-Oriented, Never Fear-Based
+Acknowledge the problem clearly, then pivot to what IMA is doing about it. The reader should leave empowered, not paralyzed.
+
+❌ "Cancer rates are exploding and nobody is doing anything."
+✅ "Cancer is striking earlier, faster, and harder. At IMA, we're changing that."
+
+### 3. Independent, Not Adversarial
+IMA's independence is its strength. Name specific actors when relevant (NYT, AAP, pharmaceutical companies), but frame criticism through evidence and principle — not name-calling.
+
+❌ "Big Pharma shills at the NYT are lying again."
+✅ "The New York Times published a hit piece on Dr. Kirk Milhoan for holding a radical position: that patients and doctors should decide medical care together."
+
+### 4. Plain Language with Precision
+Write so a patient can understand and a physician won't cringe. Define medical terms on first use. Never dumb down the science — translate it.
+
+❌ "The study found bad stuff in the vaccines."
+✅ "New research explains why regulators keep missing DNA contamination in mRNA vaccines — and why independent labs keep finding it."
+
+### 5. The Reader Is an Ally, Not a Target
+IMA's audience chose to be here. Write to them as partners in a shared mission, not as prospects to convert. Respect their intelligence.
+
+❌ "You won't BELIEVE what we discovered..."
+✅ "Someone didn't want you to see this research."
+
+### 6. Honest Confidence
+State positions directly. Don't hedge when the evidence is strong. Don't overstate when it's emerging. The distinction is the brand.
+
+- Strong evidence: "Measles is highly treatable."
+- Emerging evidence: "Research points to mitochondrial dysfunction as a central driver."
+- Opinion: "We believe public health conversations should be rooted in data, not fear."
+
+---
+
+## Writing Style Rules
+
+### Voice Characteristics
+
+| Always | Never |
+|--------|-------|
+| Direct, declarative sentences | Clickbait or sensationalism |
+| Active voice | Passive constructions |
+| Specific claims with evidence | Vague wellness-speak |
+| Conversational warmth | Stiff institutional tone |
+| Controlled intensity (when earned) | Breathless urgency on everything |
+| Humor and wit (when appropriate) | Snark without substance |
+
+### Word-Level Rules
+
+1. **Simple over complex** — "use" not "utilize," "help" not "facilitate"
+2. **Precise over vague** — Avoid "streamline," "optimize," "innovative," "cutting-edge"
+3. **Active over passive** — "IMA researchers discovered" not "It was discovered"
+4. **Earned intensity** — Phrases like "hit piece," "backfired," "the establishment is nervous" land because IMA uses them sparingly and backs them up
+5. **No exclamation points in body copy** — Exception: social media openers ("Live tonight!") and fundraising CTAs (one acceptable)
+6. **Define jargon** — "PACVS (Post-Acute COVID Vaccination Syndrome)" on first use
+
+### IMA Terminology
+
+| Avoid | Use Instead | Why |
+|-------|-------------|-----|
+| FLCCC | IMA / Independent Medical Alliance | Rebrand complete |
+| "Cure" / "treatment" (unqualified) | "Protocol" / "approach" / "may help with" | Precision |
+| "You should" | "You may consider" / "Research suggests" | Patient autonomy |
+| "Alternative medicine" | "Integrative medicine" / "complementary approaches" | Accurate framing |
+| "Big Pharma" (as sole descriptor) | Name the company or say "pharmaceutical industry" | Credibility |
+| "We believe" (for science) | "Evidence shows" / "Research indicates" | Evidence-based positioning |
+| "Anti-vaccine" (describing IMA) | "Pro-informed-consent" / "independent" | Accuracy |
+
+### Transitions to Avoid (AI Tells)
+
+These phrases signal AI-generated content and undermine trust:
+
+- "In today's rapidly evolving healthcare landscape..."
+- "It's worth noting that..."
+- "At its core,..."
+- "Let's delve into..."
+- "This begs the question..."
+- "In conclusion,..."
+- "Moreover,..." / "Furthermore,..." (overuse)
+
+**For approved transition phrases**: See [references/ima-transitions.md](references/ima-transitions.md)
+
+---
+
+## CTA Copy Guidelines
+
+### CTA Patterns by Channel
+
+| Context | CTA Text | Notes |
+|---------|----------|-------|
+| Webinar / Blog (email/web) | "Watch Now »" / "Read More »" | Chevron (») is IMA email/web style |
+| Download (email/web) | "Download Now »" | For guides, PDFs |
+| Conference (email/web) | "🎟 Buy Tickets Now »" | Emoji before text |
+| Donate (primary) | "💙 Match My Gift Today »" | During match campaigns |
+| Donate (secondary) | "🌱 Help Us Grow Hope »" | Softer, end-of-email |
+| Donate (evergreen) | "Please Support IMA's Mission »" | Standard newsletter close |
+| Social media | "Watch now." / "Learn more and sign:" | No chevron. Short imperative. |
+
+### CTA Rules
+1. **Email/web:** Always include » chevron at end
+2. **Social:** No chevron. Short imperative sentence ("Watch now.") or natural lead-in to link
+3. Emoji before CTA text on standalone email/web CTAs (💙, 🎟, 🌱, 👉)
+4. Verb-first: "Watch," "Read," "Download," "Support," "Buy"
+5. Never: "Click Here," "Learn More," "Submit"
+6. One primary CTA per content section; repeat in P.S. for fundraising
+
+---
+
+## Structural Patterns
+
+### The "Honest Medicine" Close (Newsletters)
+
+Every newsletter ends with this block. Vary the content; keep the structure:
+
+```
+PLEASE SUPPORT HONEST MEDICINE
+
+[2-3 sentences connecting this week's specific outputs to what donors fund.]
+No pharma funding, no institutional strings. Just [description of what IMA does].
+
+If you've found value in what we do, your support helps us keep going.
+
+Please Support IMA's Mission »
+```
+
+### The Opening Hook (Newsletters)
+
+| Pattern | Example |
+|---------|---------|
+| Bold declaration | "The establishment is nervous." |
+| Provocative setup | "Someone didn't want you to see this research." |
+| Trend observation | "Peptides are popping up like no tomorrow in the world of wellness." |
+| Contrast/irony | "Apparently, this is now a radical position." |
+
+### The Quick Links Block (Newsletters)
+
+Always emoji + title format. 3-6 items:
+
+| Emoji | Use For |
+|-------|---------|
+| 💊 | Drug/therapy/peptide content |
+| 📰 | News, responses, op-eds |
+| 🔬 | Research, studies, journal articles |
+| 🧬 | Genetics, DNA, molecular biology |
+| ⚡ | Breaking/urgent content |
+| 💬 | Opinion, commentary, "Here's a Thought" |
+| 💪 | Health guides, wellness content |
+| 💤 | Sleep-related content |
+| 🎉 | Achievements, appointments, wins |
+| 📖 | Journal, publications, long reads |
+| 📄 | Guides, downloadables, PDFs |
+
+---
+
+## Quality Checklist
+
+Before delivering any draft, verify:
+
+- [ ] **Brand alignment**: Does this sound like IMA, not a generic health org?
+- [ ] **Evidence backing**: Is every health claim supported or clearly labeled?
+- [ ] **Terminology**: No "FLCCC," no "cure" without context, no loaded terms?
+- [ ] **Active voice**: < 10% passive constructions?
+- [ ] **Plain language**: Would a patient understand this? Would a physician respect it?
+- [ ] **CTA clarity**: Does the reader know exactly what to do next?
+- [ ] **CTA format**: Chevron for email/web, short imperative for social?
+- [ ] **Emotional honesty**: Urgency earned, not manufactured?
+- [ ] **AI tells**: No "delve," "landscape," "moreover" chains, "it's worth noting"?
+- [ ] **Tone match**: Does the tone fit the format and channel?
+- [ ] **Independence signal**: Does the reader understand IMA is not pharma-funded?
+
+---
+
+## Additional References
+
+- **[references/ima-transitions.md](references/ima-transitions.md)** — Approved transition phrases
+- **[references/ima-copy-frameworks.md](references/ima-copy-frameworks.md)** — Headline formulas, structural templates, section patterns
+
+---
+
+## Related Skills
+
+- **ima-brand**: Voice, tone, terminology, visual identity (ALWAYS load alongside this skill)
+- **ima-editorial-scorecard**: Score and assess existing content against IMA standards
+- **ima-bootstrap**: CSS/SCSS for web implementation of IMA content

package/plugins/ima-claude/skills/ima-copywriting/references/format-blog-post.md

@@ -0,0 +1,51 @@
+# Format: Blog Post / Article
+
+Long-form content on IMA's website. Evidence-heavy, reader-friendly.
+
+## Tone
+- **Primary:** Professional + Informative
+- More room for depth — but never density for its own sake
+- Use subheadings to make scannable
+- Every claim backed by evidence or clearly labeled as opinion
+
+## Structure
+
+```
+Headline: Clear, specific, benefit-oriented
+Subtitle/Deck: One sentence expanding the headline
+Byline + Date
+
+Opening (2-3 paragraphs)
+- Hook with the "so what" — why this matters NOW
+- Brief context: what happened, what was published
+- Preview of what the reader will learn
+
+Embedded Media (if applicable)
+- Webinar video embed
+- PDF download CTA
+- Infographic
+
+Body Sections (H2 headers)
+- Each section advances one argument
+- Mix of prose, pull quotes, and data
+- Define terms, cite sources, link to studies
+
+Key Takeaways or Action Items
+
+Related Resources
+- Links to protocols, guides, related articles
+
+Support CTA
+```
+
+## Common Issues (from scorecard audits)
+
+Blog posts are the most frequently flagged format. Watch for:
+- **Missing editorial scaffolding** — raw transcripts need framing, context paragraphs, and H2 sections to function as blog posts
+- **Missing subtitle/deck** — every blog post needs the one-sentence expansion under the headline
+- **Non-standard CTAs** — must follow verb-first + » chevron format
+- **Absent H2 sections** — long-form content without section headers reads as a wall of text
+
+## Published Examples
+
+See `blog-posts-reference.md` in project Files for full published examples with editorial annotations.

package/plugins/ima-claude/skills/ima-copywriting/references/format-fundraising-email.md

@@ -0,0 +1,54 @@
+# Format: Fundraising Email
+
+Mission-driven, emotionally honest, specific about impact.
+
+## Tone
+- **Primary:** Inspirational + Supportive
+- First person from a named leader (Dr. Marik for cancer, Dr. Varon for policy)
+- Urgency is real, not manufactured — tie it to events, deadlines, patient need
+- Never guilt-trip; always empower
+- "Your gift" language (donor is the hero)
+- Match campaigns: repeat the match mechanic 2-3 times, not more
+
+## Structure
+
+```
+Headline/Hook: Emotional or provocative entry point
+Donate CTA (above the fold)
+"EVERY DOLLAR DOUBLED!" (if match campaign)
+
+Pull Quote (from Dr. Marik, Dr. Varon, or relevant voice)
+
+"Dear {Person.name},"
+
+Opening (2-3 paragraphs)
+- The problem, made personal and urgent
+- What IMA is doing about it
+- Why the reader's help matters NOW
+
+"Why Your Support Matters" section
+- 3-4 bullet points connecting urgency to action
+- Specific, data-backed claims
+
+Matched Gift CTA: "💙 Match My Gift Today »"
+
+"Your Gift Powers What's Next" section
+- 4 bullet points: what donations fund
+- Specific dollar amounts tied to outcomes when possible
+  ("A gift of $500 creates a new parent guide.")
+
+Signoff
+- Name, title, credentials
+- Personal, warm
+
+P.S.
+- Urgency reminder (match deadline, campaign end)
+- Bonus incentive if applicable (invite-only call, early access)
+- Repeat CTA
+
+Donate CTA: "🌱 Help Us Grow Hope »" or similar
+```
+
+## Published Examples
+
+See `fundraising-emails-reference.md` in project Files for full published examples with editorial annotations.

package/plugins/ima-claude/skills/ima-copywriting/references/format-newsletter.md

@@ -0,0 +1,54 @@
+# Format: Weekly Newsletter
+
+IMA's flagship communication. Roundup format with personality.
+
+## Tone
+- **Primary:** Friendly + Informative
+- The opening hook can be bold, even edgy — earn it with substance below
+- Section summaries should create curiosity without clickbait
+- End every summary with a clear CTA verb: "Read More," "Watch Now," "Download Now"
+
+## Structure
+
+```
+Subject Line: "This Week: [Compelling summary of 2-3 items]"
+
+Opening Hook (2-3 sentences)
+- Personality-forward. Set the tone for the week.
+- Can be wry, pointed, or warm — but always grounded.
+- Examples: "The establishment is nervous." / "Someone didn't want you to see this research."
+
+Quick Links Block
+- 3-6 items with emoji + title format
+- 💊 📰 🔬 🧬 ⚡ 💬 💪 💤 🎉 📖 📄
+
+Conference/Event Promotion (if applicable)
+- Brief, with urgency if deadline approaching
+- "🎟 Buy Tickets Now »"
+
+Content Sections (3-6 items)
+- Each: Emoji + Headline
+- 2-3 sentence summary that creates curiosity
+- "Read More »" / "Watch Now »" CTA
+
+Support CTA Block
+"PLEASE SUPPORT HONEST MEDICINE"
+- 2-3 sentences connecting this week's work to donor impact
+- "No pharma funding, no institutional strings."
+- "Please Support IMA's Mission »"
+
+Footer
+```
+
+## Subject Line Formula
+
+"This Week: [Item 1], [Item 2], and [Item 3 or theme]"
+
+Examples:
+- "This Week: 3 Studies, 1 Cyberattack, and DNA Contamination Confirmed"
+- "This Week: NYT Attacks, HHS Appoints, and Honest Medicine Keeps Winning"
+- "This Week: Peptides Demystified — 3 Experts, a Webinar, and a Guide You'll Actually Use"
+
+## Published Examples
+
+See `newsletters-reference.md` in project Files for full published examples with editorial annotations.

package/plugins/ima-claude/skills/ima-copywriting/references/format-op-ed.md

@@ -0,0 +1,41 @@
+# Format: Op-Ed
+
+IMA's most pointed editorial format. Published under a named author (usually Dr. Varon).
+
+## Tone
+- **Primary:** Professional + Direct, with earned edge
+- This is where IMA's voice has the most personality
+- Dry wit is a feature: "Cue the fainting couches."
+- Short paragraphs for emphasis. "That's it. That's the crime."
+- Historical analogies ground the argument ("Mr. Cig" example)
+- Always returns to patient autonomy and evidence as the foundation
+
+## Structure
+
+```
+Headline: Provocative, often a twist on the subject's own framing
+Word count indicator (for editorial planning)
+
+Opening Salvo (1-3 paragraphs)
+- State the offense or absurdity directly
+- Use the opposition's own words against them
+- Establish the stakes in the first 100 words
+
+The Case (body)
+- Build argument through evidence, historical parallel, and logic
+- Mix short punchy paragraphs with substantive ones
+- Strategic use of rhetorical questions
+- Name names; cite funding sources; show receipts
+
+The Turn
+- Reframe the narrative
+- "All Dr. Milhoan is advocating is that government bureaucrats stay out of the exam room."
+
+Close
+- Return to opening frame
+- Land on principle, not anger
+```
+
+## Published Examples
+
+See `op-eds-reference.md` in project Files for full published examples with editorial annotations.

package/plugins/ima-claude/skills/ima-copywriting/references/format-press-release.md

@@ -0,0 +1,45 @@
+# Format: Press Release / Statement
+
+Formal, AP-style, designed for media pickup and credibility.
+
+## Tone
+- **Primary:** Professional + Informative
+- Dr. Varon's quote voice: principled, direct, occasionally sardonic
+- Frame everything through patient benefit and scientific integrity
+- No advocacy language in the reporting sections — save opinion for quotes
+
+## Structure
+
+```
+"FOR IMMEDIATE RELEASE" or "For Immediate Release"
+Date (Day, Month DD, YYYY)
+"Contact [name]@IMAHealth.org" or "Media Contact [name]@imahealth.org"
+
+Headline: Active voice, newsworthy framing
+Subheadline: Key detail or context (italicized or lighter weight)
+
+Lede Paragraph (Washington, DC) —
+- Who, what, when, where, why in 2-3 sentences
+- Name IMA as "The Independent Medical Alliance — a coalition of independent doctors, healthcare providers, and researchers"
+
+Quote Block (Dr. Varon or relevant spokesperson)
+- 2-3 quoted paragraphs
+- Voice: authoritative, principled, measured
+- Always attributed: said Dr. Joseph Varon, President and Chief Medical Officer of the Independent Medical Alliance
+
+Supporting Details
+- Evidence, context, data
+- Additional quotes if relevant
+
+Boilerplate: "About the Independent Medical Alliance (IMA)"
+- Standard organizational description
+- Include IMA Action (c)(4) when relevant
+- Website: www.IMAhealth.org
+
+"Media Contact [email]"
+"###"
+```
+
+## Published Examples
+
+See `press-releases-reference.md` in project Files for full published examples with editorial annotations.