slide-factory/README.md
2026-06-08 21:43:58 -07:00

58 lines
1.3 KiB
Markdown

# Slide Factory
Slide Factory turns messy business content into brand-consistent slide decks.
The first build is intentionally local-first: a CLI, an API, and a small web UI
share the same deck spec, style packs, and PPTX renderer. The same core contract
can later run behind `dev.slides.scottfelten.com` and `slides.scottfelten.com`.
## MVP Contract
```text
source content
-> content extraction
-> deck planning
-> validated DeckSpec
-> brand/style pack
-> PPTX renderer
-> saved artifacts
```
The LLM layer should produce structured thinking, not freehand slide design.
Renderers consume a validated `DeckSpec` and a `StylePack`.
## Quick Start
```bash
npm install
npm run sample
```
Outputs are written to:
```text
outputs/sample-incorta.pptx
outputs/sample-incorta.deck.json
```
Run the local API:
```bash
npm run dev:api
```
Run the web shell:
```bash
npm run dev:web
```
## AgentPlane Notes
- Implementation truth should live in Forgejo.
- Runtime secrets must come from scoped projections or Model Service Gateway.
- Do not commit raw source data, tokens, refresh tokens, or customer documents.
- Google Slides generation should reuse the existing AgentPlane guidance:
copy templates, inventory native containers, fill existing object IDs, and
render thumbnails/contact sheets before handoff.