thematic-doc-generator

# Thematic Technical Documentation Generator

Generate publication-quality technical manuals with thematic storytelling through multi-agent orchestration.

## What This Does

Transform dry technical topics into engaging, memorable documentation using:
- **Multi-agent parallel workflow** - 2 research + N chapter + 3 assembly agents
- **Thematic metaphor system** - Complex concepts through memorable metaphors
- **AI-generated illustrations** - Custom artwork matching theme (optional)
- **Professional structure** - Front matter, back matter, index, glossary
- **Publication pipeline** - Pandoc conversion to PDF/HTML/EPUB (optional)
- **Quality enforcement** - 95%+ QA score requirement

## When to Use

Invoke this skill when creating:
- Technical documentation with personality and narrative
- Training materials that need to be memorable
- Onboarding guides that people actually want to read
- Comprehensive technical manuals (20K+ words)
- Documentation that stands out from typical reference material

## How It Works

### 6-Phase Workflow

**Phase 1: Adversarial Research** (15-30 min)
- Theme Designer proposes visual identity and metaphor system
- Structure Architect critiques and designs chapter structure
- Output: `THEME_PROPOSAL.md` (synthesized specification)

**Phase 2: Parallel Content Generation** (30-60 min)
- N chapter agents write simultaneously (self-contained chapters)
- Each follows theme proposal for consistency
- Output: `CHAPTER_01_*.md` through `CHAPTER_N_*.md`

**Phase 3: Publisher Assembly** (15-30 min)
- Synthesizes chapters into complete manual
- Adds front matter (foreword, TOC, usage guide)
- Adds back matter (appendices, index, glossary, statistics)
- Output: `THE_COMPLETE_MANUAL.md`

**Phase 4: Illustration Generation** (15-30 min, optional)
- Generates 6-8 AI images via fal-text-to-image
- Maintains theme consistency
- Gracefully skips if fal unavailable
- Output: `images/*.png` + integration guides

**Phase 5: Builder Pipeline** (5-10 min, option