How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

generate-book-old - Prompt

Name: generate-book-old
Author: ketankshukla

Prompt file imported from ketankshukla/agentic-development (.windsurf/workflows/generate-book-old.md). Copyright stays with the author.

Book Generation Workflow

This workflow generates a complete book from concept through all output formats. DO NOT PAUSE OR ASK FOR CONFIRMATION - complete all steps in one uninterrupted flow.

CRITICAL: Sequential Execution Only

Execute ALL steps SEQUENTIALLY. NEVER run multiple tasks in parallel.

Complete Step N fully → Verify it succeeded → THEN start Step N+1
Re-check dependencies at each step (don't cache earlier checks)
Especially in Phase 5: Complete MP3 → THEN check covers → THEN EPUB/PDF/M4B

Why: Parallel tasks cache outdated state. If covers aren't found during MP3 generation, but user adds them later, parallel execution misses them.

CRITICAL: No Illegal Characters in Filenames

NEVER use these characters in filenames: : / \ * ? " < > |

When generating output files (EPUB, PDF, DOCX, MP3,M4B):

Replace colons with dashes: Red Horizon: First Strike → Red Horizon - First Strike
Always sanitize the --title argument before passing to scripts

Prerequisites

Book concept or pen name concept selected

REQUIRED FILES CHECKLIST

Every book MUST have ALL of these files. Do NOT skip any:

01-planning/ (2 files)

01-book-brief.md — High-level concept
02-book-plan.md — Detailed story architecture, characters, plot

RULE: All books MUST have exactly 12 chapters. No exceptions.

02-manuscript/ (22 files)

Files 00-21 (opening credits through retail sample)

03-image-generation/

image-prompts/book-covers/01-[prompt-name].md through 05-[prompt-name].md
image-prompts/audiobook-covers/01-[prompt-name].md through 05-[prompt-name].md

04-book-metadata/ (4+ files)

book-summary.md
description.md, categories.md, keywords.md
chapter-summaries/chapter-01-summary.md through chapter-12-summary.md

05-books/ (generated)

DOCX, PDF, PDF (KDP), EPUB, audiobooks

Workflow Steps

Phase 1: Planning

Create book folder structure under pen-names/[author]/books/[book-name]/
Generate 01-planning/01-book-brief.md
Generate 01-planning/02-book-plan.md
Create README.md with project checklist

Phase 2: Manuscript Generation

Generate all manuscript files in 02-manuscript/:
- 00-opening-credits.md (audiobook only, plain text)
- 01-copyright.md
- 02-dedication.md
- 03-epigraph.md
- 04-prologue.md
- 05-chapter-01-[title].md through 16-chapter-12-[title].md
- 17-epilogue.md
- 18-acknowledgments.md
- 19-a-favour-please.md
- 20-closing-credits.md (audiobook only, plain text)
- 21-retail-sample.md (audiobook only, plain text)

Phase 3: Image Generation

Generate 5 individual prompt files in 03-image-generation/image-prompts/book-covers/:
- Format: 01-[prompt-name].md through 05-[prompt-name].md
- Each starts with: "A stunning 9:16 portrait book cover..."
- Each file contains ONLY the prompt text (no headers) for easy copy-paste
Generate 5 individual prompt files in 03-image-generation/image-prompts/audiobook-covers/:
- Same filenames as book-covers
- Each starts with: "A stunning 2400x2400 px audiobook cover..."
USER ACTION: Generate images and place in 03-image-generation/covers/:
- ebook-cover.png
- audiobook-cover.png

Phase 4: Book Metadata

Generate 04-book-metadata/book-summary.md
Generate 04-book-metadata/description.md
Generate 04-book-metadata/categories.md
Generate 04-book-metadata/keywords.md
Generate 12 chapter summaries in 04-book-metadata/chapter-summaries/

Phase 5: Book Generation (FINAL STEP - covers must be ready)

// turbo 14. Generate MP3 audiobook (FIRST - longest running):

python "e:\agentic-development\common-tasks\audiobook-generation\generate-audiobooks.py" --book-path "[book-path]" --author "[Author]" --title "[Title]"

// turbo 15. Generate Word document:

powershell -ExecutionPolicy Bypass -File "e:\agentic-development\common-tasks\docx-generation\generate-docx.ps1" -BookPath "[book-path]" -Author "[Author]" -Title "[Title]"

// turbo 16. Upscale audiobook cover (REQUIRED before M4B):

python "e:\agentic-development\common-tasks\audiobook-generation\upscale-audiobook-cover.py" "[book-path]\03-image-generation\covers\audiobook-cover.png"

// turbo 17. Generate EPUB:

python "e:\agentic-development\common-tasks\ebook-generation\generate-ebook.py" --book-path "[book-path]" --author "[Author]" --title "[Title]"

// turbo 18. Generate PDF with cover:

python "e:\agentic-development\common-tasks\pdf-generation\generate-pdf.py" --book-path "[book-path]" --author "[Author]" --title "[Title]"

// turbo 19. Generate PDF for KDP (no cover):

python "e:\agentic-development\common-tasks\pdf-generation\generate-pdf-without-image.py" --book-path "[book-path]" --author "[Author]" --title "[Title]"

// turbo 20. Generate M4B audiobook (LAST - requires MP3s + upscaled cover):

python "e:\agentic-development\common-tasks\audiobook-generation\create-m4b.py" --book-path "[book-path]" --author "[Author]" --title "[Title]"

Phase 6: Completion

Update docs/BOOK-COMPLETION-TRACKER.md to "✅ Complete"

// turbo 22. Commit and push to GitHub:

git add -A
git commit -m "Complete book generation: [Author] - [Title]"
git push

Output Files Location

All generated documents go to 05-books/:

[Author] - [Title].docx
[Author] - [Title].pdf
[Author] - [Title] (KDP).pdf
[Author] - [Title].epub
mp3-audiobook/ (MP3 files)
m4b-audiobook/[Author] - [Title].m4b

CRITICAL RULES

Books are to be generated in the following order:

1st MP3 audiobook generate-audiobooks.py 2nd DOCX generate-docx.ps1 3rd Upscale cover upscale-audiobook-cover.py 4th EPUB generate-ebook.py 5th PDF (with cover) generate-pdf.py 6th PDF (KDP) generate-pdf-without-image.py 7th M4B audiobook create-m4b.py

DO NOT STOP between phases - complete the entire workflow
DO NOT ASK for confirmation to continue
PUSH TO GITHUB ONLY at the very end after ALL assets are generated
All generated files go to 05-books/ folder
Covers are in 03-image-generation/covers/
Use scripts from common-tasks/ folder

Install generate-book-old and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Book Generation Workflow This workflow generates a complete book from concept through all output formats. **DO NOT PAUSE OR ASK FOR CONFIRMATION** - complete all steps in one uninterrupted flow. ## CRITICAL: Sequential Execution Only **Execute ALL steps SEQUENTIALLY. NEVER run multiple tasks in parallel.** - Complete Step N fully → Verify it succeeded → THEN start Step N+1 - Re-check dependencies at each step (don't cache earlier checks) - Especially in Phase 5: Complete MP3 → THEN check covers → THEN EPUB/PDF/M4B Why: Parallel tasks cache outdated state. If covers aren't found during MP3 generation, but user adds them later, parallel execution misses them. ## CRITICAL: No Illegal Characters in Filenames **NEVER use these characters in filenames:** `: / \ * ? " < > |` When generating output files (EPUB, PDF, DOCX, MP3,M4B): - Replace colons with dashes: `Red Horizon: First Strike` → `Red Horizon - First Strike` - Always sanitize the `--title` argument before passing to scripts ## Prerequisites - Book concept or pen name concept selected ## REQUIRED FILES CHECKLIST Every book MUST have ALL of these files. Do NOT skip any: **01-planning/** (2 files) - `01-book-brief.md` — High-level concept - `02-book-plan.md` — Detailed story architecture, characters, plot **RULE: All books MUST have exactly 12 chapters.** No exceptions. **02-manuscript/** (22 files) - Files 00-21 (opening credits through retail sample) **03-image-generation/** - `image-prompts/book-covers/01-[prompt-name].md` through `05-[prompt-name].md` - `image-prompts/audiobook-covers/01-[prompt-name].md` through `05-[prompt-name].md` **04-book-metadata/** (4+ files) - `book-summary.md` - `description.md`, `categories.md`, `keywords.md` - `chapter-summaries/chapter-01-summary.md` through `chapter-12-summary.md` **05-books/** (generated) - DOCX, PDF, PDF (KDP), EPUB, audiobooks ## Workflow Steps ### Phase 1: Planning 1. Create book folder structure under `pen-names/[author]/books/[book-name]/` 2. Generate `01-planning/01-book-brief.md` 3. Generate `01-planning/02-book-plan.md` 4. Create `README.md` with project checklist ### Phase 2: Manuscript Generation 5. Generate all manuscript files in `02-manuscript/`: - `00-opening-credits.md` (audiobook only, plain text) - `01-copyright.md` - `02-dedication.md` - `03-epigraph.md` - `04-prologue.md` - `05-chapter-01-[title].md` through `16-chapter-12-[title].md` - `17-epilogue.md` - `18-acknowledgments.md` - `19-a-favour-please.md` - `20-closing-credits.md` (audiobook only, plain text) - `21-retail-sample.md` (audiobook only, plain text) ### Phase 3: Image Generation 6. Generate 5 individual prompt files in `03-image-generation/image-prompts/book-covers/`: - Format: `01-[prompt-name].md` through `05-[prompt-name].md` - Each starts with: "A stunning 9:16 portrait book cover..." - Each file contains ONLY the prompt text (no headers) for easy copy-paste 7. Generate 5 individual prompt files in `03-image-generation/image-prompts/audiobook-covers/`: - Same filenames as book-covers - Each starts with: "A stunning 2400x2400 px audiobook cover..." 8. **USER ACTION:** Generate images and place in `03-image-generation/covers/`: - `ebook-cover.png` - `audiobook-cover.png` ### Phase 4: Book Metadata 9. Generate `04-book-metadata/book-summary.md` 10. Generate `04-book-metadata/description.md` 11. Generate `04-book-metadata/categories.md` 12. Generate `04-book-metadata/keywords.md` 13. Generate 12 chapter summaries in `04-book-metadata/chapter-summaries/` ### Phase 5: Book Generation (FINAL STEP - covers must be ready) // turbo 14. Generate MP3 audiobook (FIRST - longest running): ```powershell python "e:\agentic-development\common-tasks\audiobook-generation\generate-audiobooks.py" --book-path "[book-path]" --author "[Author]" --title "[Title]" ``` // turbo 15. Generate Word document: ```powershell powershell -ExecutionPolicy Bypass -File "e:\agentic-development\common-tasks\docx-generation\generate-docx.ps1" -BookPath "[book-path]" -Author "[Author]" -Title "[Title]" ``` // turbo 16. Upscale audiobook cover (REQUIRED before M4B): ```powershell python "e:\agentic-development\common-tasks\audiobook-generation\upscale-audiobook-cover.py" "[book-path]\03-image-generation\covers\audiobook-cover.png" ``` // turbo 17. Generate EPUB: ```powershell python "e:\agentic-development\common-tasks\ebook-generation\generate-ebook.py" --book-path "[book-path]" --author "[Author]" --title "[Title]" ``` // turbo 18. Generate PDF with cover: ```powershell python "e:\agentic-development\common-tasks\pdf-generation\generate-pdf.py" --book-path "[book-path]" --author "[Author]" --title "[Title]" ``` // turbo 19. Generate PDF for KDP (no cover): ```powershell python "e:\agentic-development\common-tasks\pdf-generation\generate-pdf-without-image.py" --book-path "[book-path]" --author "[Author]" --title "[Title]" ``` // turbo 20. Generate M4B audiobook (LAST - requires MP3s + upscaled cover): ```powershell python "e:\agentic-development\common-tasks\audiobook-generation\create-m4b.py" --book-path "[book-path]" --author "[Author]" --title "[Title]" ``` ### Phase 6: Completion 21. Update `docs/BOOK-COMPLETION-TRACKER.md` to "✅ Complete" // turbo 22. Commit and push to GitHub: ```powershell git add -A git commit -m "Complete book generation: [Author] - [Title]" git push ``` ## Output Files Location All generated documents go to `05-books/`: - `[Author] - [Title].docx` - `[Author] - [Title].pdf` - `[Author] - [Title] (KDP).pdf` - `[Author] - [Title].epub` - `mp3-audiobook/` (MP3 files) - `m4b-audiobook/[Author] - [Title].m4b` ## CRITICAL RULES Books are to be generated in the following order: 1st MP3 audiobook generate-audiobooks.py 2nd DOCX generate-docx.ps1 3rd Upscale cover upscale-audiobook-cover.py 4th EPUB generate-ebook.py 5th PDF (with cover) generate-pdf.py 6th PDF (KDP) generate-pdf-without-image.py 7th M4B audiobook create-m4b.py 1. **DO NOT STOP** between phases - complete the entire workflow 2. **DO NOT ASK** for confirmation to continue 3. **PUSH TO GITHUB ONLY** at the very end after ALL assets are generated 4. All generated files go to `05-books/` folder 5. Covers are in `03-image-generation/covers/` 6. Use scripts from `common-tasks/` folder

{ "prompt": "# Book Generation Workflow\n\nThis workflow generates a complete book from concept through all output formats. **DO NOT PAUSE OR ASK FOR CONFIRMATION** - complete all steps in one uninterrupted flow.\n\n## CRITICAL: Sequential Execution Only\n\n**Execute ALL steps SEQUENTIALLY. NEVER run multiple tasks in parallel.**\n\n- Complete Step N fully → Verify it succeeded → THEN start Step N+1\n- Re-check dependencies at each step (don't cache earlier checks)\n- Especially in Phase 5: Complete MP3 → THEN check covers → THEN EPUB/PDF/M4B\n\nWhy: Parallel tasks cache outdated state. If covers aren't found during MP3 generation, but user adds them later, parallel execution misses them.\n\n## CRITICAL: No Illegal Characters in Filenames\n\n**NEVER use these characters in filenames:** `: / \\ * ? \" < > |`\n\nWhen generating output files (EPUB, PDF, DOCX, MP3,M4B):\n\n- Replace colons with dashes: `Red Horizon: First Strike` → `Red Horizon - First Strike`\n- Always sanitize the `--title` argument before passing to scripts\n\n## Prerequisites\n\n- Book concept or pen name concept selected\n\n## REQUIRED FILES CHECKLIST\n\nEvery book MUST have ALL of these files. Do NOT skip any:\n\n**01-planning/** (2 files)\n\n- `01-book-brief.md` — High-level concept\n- `02-book-plan.md` — Detailed story architecture, characters, plot\n\n**RULE: All books MUST have exactly 12 chapters.** No exceptions.\n\n**02-manuscript/** (22 files)\n\n- Files 00-21 (opening credits through retail sample)\n\n**03-image-generation/**\n\n- `image-prompts/book-covers/01-[prompt-name].md` through `05-[prompt-name].md`\n- `image-prompts/audiobook-covers/01-[prompt-name].md` through `05-[prompt-name].md`\n\n**04-book-metadata/** (4+ files)\n\n- `book-summary.md`\n- `description.md`, `categories.md`, `keywords.md`\n- `chapter-summaries/chapter-01-summary.md` through `chapter-12-summary.md`\n\n**05-books/** (generated)\n\n- DOCX, PDF, PDF (KDP), EPUB, audiobooks\n\n## Workflow Steps\n\n### Phase 1: Planning\n\n1. Create book folder structure under `pen-names/[author]/books/[book-name]/`\n2. Generate `01-planning/01-book-brief.md`\n3. Generate `01-planning/02-book-plan.md`\n4. Create `README.md` with project checklist\n\n### Phase 2: Manuscript Generation\n\n5. Generate all manuscript files in `02-manuscript/`:\n - `00-opening-credits.md` (audiobook only, plain text)\n - `01-copyright.md`\n - `02-dedication.md`\n - `03-epigraph.md`\n - `04-prologue.md`\n - `05-chapter-01-[title].md` through `16-chapter-12-[title].md`\n - `17-epilogue.md`\n - `18-acknowledgments.md`\n - `19-a-favour-please.md`\n - `20-closing-credits.md` (audiobook only, plain text)\n - `21-retail-sample.md` (audiobook only, plain text)\n\n### Phase 3: Image Generation\n\n6. Generate 5 individual prompt files in `03-image-generation/image-prompts/book-covers/`:\n - Format: `01-[prompt-name].md` through `05-[prompt-name].md`\n - Each starts with: \"A stunning 9:16 portrait book cover...\"\n - Each file contains ONLY the prompt text (no headers) for easy copy-paste\n7. Generate 5 individual prompt files in `03-image-generation/image-prompts/audiobook-covers/`:\n - Same filenames as book-covers\n - Each starts with: \"A stunning 2400x2400 px audiobook cover...\"\n8. **USER ACTION:** Generate images and place in `03-image-generation/covers/`:\n - `ebook-cover.png`\n - `audiobook-cover.png`\n\n### Phase 4: Book Metadata\n\n9. Generate `04-book-metadata/book-summary.md`\n10. Generate `04-book-metadata/description.md`\n11. Generate `04-book-metadata/categories.md`\n12. Generate `04-book-metadata/keywords.md`\n13. Generate 12 chapter summaries in `04-book-metadata/chapter-summaries/`\n\n### Phase 5: Book Generation (FINAL STEP - covers must be ready)\n\n// turbo 14. Generate MP3 audiobook (FIRST - longest running):\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\audiobook-generation\\generate-audiobooks.py\" --book-path \"[book-path]\" --author \"[Author]\" --title \"[Title]\"\n```\n\n// turbo 15. Generate Word document:\n\n```powershell\npowershell -ExecutionPolicy Bypass -File \"e:\\agentic-development\\common-tasks\\docx-generation\\generate-docx.ps1\" -BookPath \"[book-path]\" -Author \"[Author]\" -Title \"[Title]\"\n```\n\n// turbo 16. Upscale audiobook cover (REQUIRED before M4B):\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\audiobook-generation\\upscale-audiobook-cover.py\" \"[book-path]\\03-image-generation\\covers\\audiobook-cover.png\"\n```\n\n// turbo 17. Generate EPUB:\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\ebook-generation\\generate-ebook.py\" --book-path \"[book-path]\" --author \"[Author]\" --title \"[Title]\"\n```\n\n// turbo 18. Generate PDF with cover:\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\pdf-generation\\generate-pdf.py\" --book-path \"[book-path]\" --author \"[Author]\" --title \"[Title]\"\n```\n\n// turbo 19. Generate PDF for KDP (no cover):\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\pdf-generation\\generate-pdf-without-image.py\" --book-path \"[book-path]\" --author \"[Author]\" --title \"[Title]\"\n```\n\n// turbo 20. Generate M4B audiobook (LAST - requires MP3s + upscaled cover):\n\n```powershell\npython \"e:\\agentic-development\\common-tasks\\audiobook-generation\\create-m4b.py\" --book-path \"[book-path]\" --author \"[Author]\" --title \"[Title]\"\n```\n\n### Phase 6: Completion\n\n21. Update `docs/BOOK-COMPLETION-TRACKER.md` to \"✅ Complete\"\n\n// turbo 22. Commit and push to GitHub:\n\n```powershell\ngit add -A\ngit commit -m \"Complete book generation: [Author] - [Title]\"\ngit push\n```\n\n## Output Files Location\n\nAll generated documents go to `05-books/`:\n\n- `[Author] - [Title].docx`\n- `[Author] - [Title].pdf`\n- `[Author] - [Title] (KDP).pdf`\n- `[Author] - [Title].epub`\n- `mp3-audiobook/` (MP3 files)\n- `m4b-audiobook/[Author] - [Title].m4b`\n\n## CRITICAL RULES\n\nBooks are to be generated in the following order:\n\n1st MP3 audiobook generate-audiobooks.py\n2nd DOCX generate-docx.ps1\n3rd Upscale cover upscale-audiobook-cover.py\n4th EPUB generate-ebook.py\n5th PDF (with cover) generate-pdf.py\n6th PDF (KDP) generate-pdf-without-image.py\n7th M4B audiobook create-m4b.py\n\n1. **DO NOT STOP** between phases - complete the entire workflow\n2. **DO NOT ASK** for confirmation to continue\n3. **PUSH TO GITHUB ONLY** at the very end after ALL assets are generated\n4. All generated files go to `05-books/` folder\n5. Covers are in `03-image-generation/covers/`\n6. Use scripts from `common-tasks/` folder", "variables": [], "notes": "Complete book generation workflow from concept to final output", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/ketankshukla/agentic-development", "path": ".windsurf/workflows/generate-book-old.md", "ref": "149e01e93499a2273231d252a9339c375c00a2db", "url": "https://github.com/ketankshukla/agentic-development/blob/149e01e93499a2273231d252a9339c375c00a2db/.windsurf/workflows/generate-book-old.md", "key": "ketankshukla/agentic-development/.windsurf/workflows/generate-book-old.md" } } }

generate-book-old

About

Book Generation Workflow

CRITICAL: Sequential Execution Only

CRITICAL: No Illegal Characters in Filenames

Prerequisites

REQUIRED FILES CHECKLIST

Workflow Steps

Phase 1: Planning

Phase 2: Manuscript Generation

Phase 3: Image Generation

Phase 4: Book Metadata

Phase 5: Book Generation (FINAL STEP - covers must be ready)

Phase 6: Completion

Output Files Location

CRITICAL RULES

Install generate-book-old and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews