# CLAUDE.md

## Overview

Research-to-publication workflow toolkit. Exports research to Ulysses for OurDigital blog publishing.

## Quick Start

```bash
# Export research to Ulysses
python scripts/export_to_ulysses.py --input research.md --group "Blog Drafts"
```

## Scripts

| Script | Purpose |
|--------|---------|
| `export_to_ulysses.py` | Export markdown to Ulysses app for editing/publishing |

## Ulysses Export

```bash
# Basic export
python scripts/export_to_ulysses.py --input research.md

# With target group
python scripts/export_to_ulysses.py \
  --input research.md \
  --group "Blog Drafts" \
  --tags "research,draft"

# From Notion export
python scripts/export_to_ulysses.py \
  --notion-export notion_export.zip \
  --group "From Notion"
```

## Workflow

1. Complete research in Claude/Notion
2. Export to markdown format
3. Run export script to Ulysses
4. Edit and polish in Ulysses
5. Publish to Ghost/OurDigital

## Output Targets

- **blog.ourdigital.org** - Main blog
- **journal.ourdigital.org** - Long-form essays
- **ourstory.day** - Personal narratives

## Ulysses Integration

Requires:
- Ulysses app installed
- x-callback-url scheme enabled
- Target group created in Ulysses

## References

See `references/` for:
- `blog-style-guide.md` - OurDigital writing style
- `publishing-checklist.md` - Pre-publish checklist
- `ghost-api-config.md` - Ghost CMS integration