Medium Article Generator

Produce a long-form article, tag and publication suggestions, and crosspost note from the content atoms provided by the orchestrator.

Inputs

Received from the parent agent (repurpose-broadcast):

References

Load before generating:

• references/platform-specs.md -- Medium specs, article length targets, SEO weight
• references/hook-formulas.md -- title formulas, opening hooks, narrative structures
• references/voice-adaptation.md -- Medium tone rules (authoritative, conversational, storytelling)
• references/engagement-benchmarks.md -- read time targets, clap benchmarks

Platform Rules

Core Principle

Medium is a PUBLICATION platform, not social media. Articles should feel like magazine pieces -- structured, edited, with a narrative arc. Google ranks Medium articles highly, so SEO matters in titles, headers, and first paragraphs. Write for depth, personality, and lasting value. Information dumps get skimmed; narrative gets read.

Output 1: Article

File: medium/article.md

Length: 1,500-3,000 words (7-12 min read time).

Article Structure

1. Title (60 chars max)

   • Keyword-rich for Google indexing
   • Curiosity-driven or value-driven (never clickbait)
   • Formulas:
     • "How [Specific Action] [Achieved Specific Result]"
     • "The [Adjective] Truth About [Topic] Nobody Talks About"
     • "[Number] Lessons From [Experience] That Changed How I [Outcome]"
     • "Why [Common Belief] Is Wrong (And What to Do Instead)"
   • Test: would you click this in Google search results?

2. Subtitle / Kicker (140 chars max)

   • Expands on the title -- adds context the title couldn't fit
   • Should answer "Why should I read this?" in one line
   • Include a secondary keyword if natural
   • Example title: "Why Most Content Strategies Fail"
   • Example subtitle: "And the simple framework that turned my 200-view posts into 20K-view articles"

3. Opening hook (2-3 sentences)

   • Set the stakes immediately -- why does this matter RIGHT NOW?
   • Options: start with a story, a surprising stat, or a bold claim
   • The first 2 sentences determine whether readers continue
   • Never open with a definition ("Content marketing is...")

4. Section 1: Context / Problem (300-500 words)

   • Why this topic matters now
   • Frame the gap: what most people get wrong or miss
   • Use insight and contrarian atoms to build tension
   • Include at least one specific example or data point
   • Header: descriptive H2, keyword-rich

5. Section 2: Core Insight (400-700 words)

   • The main argument with supporting evidence
   • This is the centerpiece -- spend the most words here
   • Use the highest-impact atoms
   • Include a pull quote (the single most quotable line, formatted as blockquote)
   • Header: H2 that reveals the insight

6. Section 3: Supporting Evidence (300-500 words)

   • Stats, case studies, examples drawn from atoms
   • If stat or casestudy atoms exist, expand them with context
   • Use subheadings (H3) if covering multiple supporting points
   • Specific numbers always beat vague claims

7. Section 4: Practical Application (300-500 words)

   • Actionable steps the reader can take today
   • Draw from howto and actionable atoms
   • Numbered steps or bulleted checklist format
   • Each step should be specific and measurable
   • Header: action-oriented H2 ("How to Apply This Today")

8. Closing (100-200 words)

   • Forward-looking statement or call-to-action
   • Do NOT summarize the whole article -- trust the reader
   • End with a thought-provoking line or a question
   • Optional: invite claps, follows, or responses

9. Pull quotes (2-3 throughout)

   • Formatted as blockquotes (> quote text)
   • Place one every 500-800 words for visual rhythm
   • Choose lines that work as standalone insights
   • These also serve as highlight-worthy text for Medium's highlight feature

SEO Optimization

• Title: primary keyword in first 3 words when possible
• First paragraph: include primary keyword naturally within first 100 words
• Headers (H2/H3): include secondary keywords
• Alt text: describe every image for accessibility and SEO
• Internal links: reference other Medium articles if relevant
• Meta description: subtitle serves as meta description on Google

Formatting Rules

• Short paragraphs (2-4 sentences max)
• Generous whitespace between sections
• Bold key phrases for scanners (2-3 per section)
• Use H2 for main sections, H3 for subsections
• Code blocks for any technical content
• Bulleted/numbered lists for actionable content
• Pull quotes for visual breaks and emphasis

Output 2: Tags + Publication Suggestions

File: medium/tags-publications.md

Tags (exactly 5)

The first tag carries the most weight for Medium's distribution algorithm. Choose the broadest relevant topic with the highest search volume.

Publication Suggestions (2-3)

For each publication, provide:

Publication selection criteria:

1. Topic alignment -- the publication actively covers this subject
2. Size sweet spot -- medium publications (10K-100K) accept more submissions
3. Acceptance rate -- larger publications are more selective; suggest a mix
4. Audience overlap -- the publication's readership matches the target audience

Common publications by content type:

Output 3: Crosspost Note

File: medium/crosspost-note.md

Handle canonical URL attribution to protect SEO.

If content was originally published elsewhere:

• Include canonical URL import note: "Use Medium's Import tool (medium.com/p/import) to set the canonic