# Present - Project Instructions for Claude

emoji: 🎤

## Purpose

Visual augmentation and recording library (`rivus-present`). Two core tools: **Illustrator** (AI image generation + injection into HTML reports) and **Recorder** (terminal recording via VHS + browser capture via Playwright + TTS narration). Also hosts the system-wide presentation gallery and deliverable reports.

## Package: `rivus-present`

Installable package under `src/rivus_present/`. Contains the two core tools plus shared standards (e.g., `presenting.md` rubric).

```
present/
├── src/rivus_present/      ← installable package
│   ├── illustrator/        ← AI image slots + generation + injection
│   ├── recorder/           ← VHS + Playwright + TTS recording pipeline
│   └── standards/          ← presenting.md rubric (shared with draft/critique)
├── gallery/                ← system-wide presentations (ai_ops_pitch, learning, gyms, vario, ...)
├── reports/                ← deliverable artifacts
├── tests/                  ← test suite
└── tasks.py                ← invoke tasks
```

## Illustrator

Reads an HTML report, uses LLM to suggest image placements, generates images via multi-provider engine (Imagen, Gemini, DALL-E, Grok), injects into HTML at specified locations. Creates tabbed review page showing all stages (Original, Slots, Gallery, Result). Editable JSON manifests for tweaking without re-analysis.

```bash
python -m rivus_present.illustrator report.html              # full pipeline
python -m rivus_present.illustrator --analyze-only report.html   # just planning
python -m rivus_present.illustrator --slots-file slots.json report.html  # skip analysis
```

## Recorder

Terminal recording and browser capture pipeline. VHS for terminal sessions, Playwright for web UI recording, TTS for narration audio. Combines into polished demo videos.

## Gallery

System-wide presentations live under `present/` as sibling directories:

| Directory             | Description                                                |
|-----------------------|------------------------------------------------------------|
| `ai_ops_pitch/`      | Enterprise AI/Ops pitch deck (PowerPoint + redlines)       |
| `self_improvement/`   | LaTeX paper: "Can Claude Speed Itself Up?"                 |
| `learning/`           | Learning system presentation + rubric guide                |
| `gyms/`               | Gym self-improvement system presentation                   |
| `vario/`              | Vario multi-model pipeline engine presentation             |
| `rivus_explainer/`    | Interactive web explainer of rivus                         |

## Note on Evaluation Tools

Redline (multi-model editorial review) and critique (rubric-based assessment) have moved to `draft/`. They are document analysis tools, not presentation tools, and belong with the writing assistance pipeline. See `draft/redline/` and `draft/critique/`.

## Dependencies

`lib.llm`, `lib.llm.image_gen`, python-pptx, loguru