# Oracle Content Loop — Workflow

**Phase 4** · Built 2026-10-14

## Pipeline

```
ClearFeed (cluster.py) → stories.json → oracle_loop.py → vault (05_Output/oracle/)
```

## Run

### 1. Fetch and cluster news (ClearFeed)
```bash
cd ~/src/ClearFeed/prototype
python cluster.py --llm --topk 10
```

This writes `prototype/out/stories.json` + `index.html`.

### 2. Generate content (Oracle loop)
```bash
cd ~/Projects/hermes-dashboard
python oracle/oracle_loop.py --topk 5        # template mode
python oracle/oracle_loop.py --topk 5 --llm  # LLM-enhanced (needs model on :8080)
```

### Output

Per story:
- `05_Output/oracle/YYYY-MM-DD/<slug>-social.txt` — Twitter/X draft
- `05_Output/oracle/YYYY-MM-DD/<slug>-blog.md` — blog post draft

### Dashboard

Oracle card reads `oracle_state.json` and shows ranked stories with hooks, coverage, and links to drafts.

## Daily cron (future)
```bash
# Morning run
cd ~/src/ClearFeed/prototype && python cluster.py --llm && cd ~/Projects/hermes-dashboard && python oracle/oracle_loop.py --topk 5
```