tarot-content

# Tarot Content Generator

Create professional tarot × astrology content for social media at scale.

## Capabilities

1. **Weekly 12-Sign Readings** — Scripted horoscope videos with tarot card pulls
2. **Event-Driven Specials** — Content for major transits (retrogrades, eclipses, conjunctions)
3. **Tarot Spreads** — Custom spread designs with interpretation frameworks
4. **Video Scripts** — TTS-ready scripts with screen text cues
5. **Cover Art** — Pillow-generated thumbnails optimized for mobile
6. **Content Calendar** — Automated scheduling based on astrological events

## Quick Start

### Weekly 12-Sign Reading

```
Generate a weekly tarot reading for all 12 signs.
Date range: {start} to {end}
Style: conversational, no jargon
Format: video script with screen text cues
```

The agent will:
1. Pull real ephemeris data (planetary positions, aspects)
2. Map transits to each sign's house system
3. Pull tarot cards (Challenge / Guidance / Blessing spread)
4. Write scripts in a natural, engaging voice

### Event-Driven Special

```
Create a special video about {transit/event}.
Example: Saturn conjunct Neptune in Aries
Include: what it means, historical context, 12-sign breakdown
```

## Content Framework

### The 3-Card Spread (Challenge / Guidance / Blessing)

A proven framework for weekly readings:

| Position | Meaning | Tone |
|----------|---------|------|
| Challenge | What to watch out for | Honest, not scary |
| Guidance | What to focus on | Actionable advice |
| Blessing | What's coming | Hopeful, encouraging |

### Script Structure (per sign, 60-90 seconds)

```
1. Opening hook (5s) — "Hey {Sign}, this week is about..."
2. Transit context (10s) — What planets are doing in their house
3. Card 1: Challenge (15s) — The obstacle + real-life scenario
4. Card 2: Guidance (15s) — Practical advice
5. Card 3: Blessing (10s) — The reward / positive outcome
6. CTA (5s) — "Follow for your sign's weekly reading"
```

### Writing Style Guidelines

- **Say it like a friend, n...