{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-design-variations-questions",
  "slug": "design-variations-questions",
  "title": "Generate to diverge, code to converge — questions and tradeoffs",
  "summary": "Detailed questions and tradeoffs with concrete prompts, observable outcomes, and the limits of the example.",
  "category": "Planning",
  "tags": [
    "design-variations",
    "questions"
  ],
  "sources": [
    {
      "label": "Generate to diverge, code to converge — questions and tradeoffs",
      "url": "https://indigo-kayak-2zw8.here.now/dialogue.html"
    }
  ],
  "sourceUnits": [
    "07-variations/dialogue.html#The room asks"
  ],
  "collection": "factory",
  "categoryId": "planning",
  "wordCount": 871,
  "url": "/topics/factory-design-variations-questions/",
  "markdownUrl": "/markdown/factory-design-variations-questions.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-design-variations-questions.json",
  "headings": [
    {
      "id": "the-room-asks",
      "text": "The room asks",
      "level": 2
    }
  ],
  "markdown": "# Generate to diverge, code to converge — questions and tradeoffs\n\nDetailed questions and tradeoffs with concrete prompts, observable outcomes, and the limits of the example.\n\n## The room asks\n\nWhy generate images at all? Your agent can write nine real HTML pages.\n\nIt can — at roughly an hour a draft, which is why you normally see three directions before you commit. A bitmap mockup costs about a minute, so nine directions becomes the cheap default, and you can't prefer an option you never saw. Images are for deciding; code is for shipping. Generate to diverge, code to converge. Here's the whole first taste, one paste — fair warning: it launches Codex, a paid agent, with sandboxing and approvals off, so read it and be comfortable with the cost and permissions before you run it:\n\n``` text\nmkdir -p mockups\ncodex exec --dangerously-bypass-approvals-and-sandbox 'Use the $imagegen skill to generate 9 WILDLY different website homepage mockups for a landing page for an indie coffee roaster. The subject stays identical in all 9 - ONLY the visual style varies. One built-in image_gen call per mockup. After each image completes, copy it from $CODEX_HOME/generated_images/ into ./mockups/ as mockup-01.png ... mockup-09.png. Announce progress after each one.'\nls mockups/\n```\n\nWon't “nine wildly different mockups” just give me nine incomparable posters?\n\nOnly if you let the subject drift. The prompt pins the subject — same product, same page type, same rough content — and varies nothing but the style. That turns nine images into a controlled experiment you can read at a glance. This is the exact prompt, verbatim (the agy mobile version is on the [guide](https://indigo-kayak-2zw8.here.now/)):\n\n``` text\nUse the $imagegen skill to generate 9 WILDLY different website homepage mockups\nfor {{SUBJECT}}.\n\nRules:\n- The SUBJECT stays identical in all 9 — same product, same page type\n  (homepage), same rough content (hero, nav, one CTA). ONLY the visual style\n  varies. This is what makes them comparable.\n- Pick 9 maximally divergent directions, e.g.: swiss/international typographic,\n  neo-brutalist, glassmorphic dark, editorial magazine, retro terminal,\n  playful memphis, luxury minimal, bento-grid dashboard, hand-drawn zine.\n  Name each direction before generating.\n- One built-in image_gen call per mockup (do NOT drop to the CLI fallback).\n- Desktop aspect, full homepage visible, legible headline text.\n- After each image completes, copy it from $CODEX_HOME/generated_images/\n  into ./mockups/ as mockup-01.png ... mockup-09.png (match the direction\n  order you announced).\n- Announce progress after each one — never go silent.\n- When all 9 exist, list the 9 directions next to their filenames.\n```\n\nAnd if one mockup comes back as a different page type anyway: regenerate it. Don't compare it.\n\nI ran it. The run “succeeded” and my `mockups/` folder is empty. So the model lied?\n\nNo — it saved your images, just not where you looked. Codex's built-in `image_gen` writes to `$CODEX_HOME/generated_images/` by default, which is why the prompt explicitly orders a copy into `./mockups/`. The other classic: agy's `--print-timeout` defaults to five minutes, and nine images take longer — the run script raises it to fifteen. An empty contact sheet means read the run log before blaming the model.\n\nNine tiles and no rubric. How do I “pick with my eyes” honestly?\n\nOpen the contact-sheet gallery — it polls every five seconds, so tiles fill in live while the run generates — and pick the tile you would be embarrassed to lose. If nothing clears that bar, your styles weren't divergent enough: widen the directions and rerun. Never polish the least-bad option.\n\nFine, I picked one. It's a PNG. What do I actually ship?\n\nYou hand the winner back to a coding agent as a reference image. The bitmap decided; the code converges:\n\n``` text\nmockup-0N.png is the winner. Rebuild it as a real single-file HTML/CSS page at\n./winner/index.html, using the image strictly as a visual reference — real\ntext, real layout, no bitmap backgrounds.\n```\n\nReal text, real layout, no bitmap backgrounds — the image is strictly a visual reference.\n\nCute demo. Does it survive contact with 200 images?\n\nThat's exactly what [inspiration-board](https://inspiration-board.pages.dev/variations/01-masonry-grid) is: a bash loop driving the Antigravity CLI across 200 named web-design styles. Scale is mostly error handling — fixed output filenames, a skip-if-exists guard (file already on disk above 100 KB), and machine-readable status demanded from every single run:\n\n``` text\nRespond with ONLY a JSON object (no markdown, no explanation):\n- Success:     {\"status\":\"ok\",\"path\":\"<output_path>\"}\n- Quota error: {\"status\":\"quota_exhausted\",\"reset_seconds\":<N>,\"reset_time\":\"<ISO8601>\"}\n- Other error: {\"status\":\"error\",\"message\":\"<description>\"}\n```\n\nQuota errors are real; a JSON reset time beats a silent retry. And the variations idea applies twice there: the images are style variations, and the gallery pages themselves are twelve layout variations of the same image set.\n\nDo you actually trust this loop for anything real, or is it a workshop trick?\n\nThe page you're reading is the proof. Its theme was picked by this exact loop: wildly different theme candidates rendered over this section's real content, three rounds of Elo voting, 130 recorded votes — and the winner, Instrument Panel, undefeated in both light and dark, became the template for every site in this workshop. The annotated transcript is on the [Session Replay](https://indigo-kayak-2zw8.here.now/replay.html) page.\n\nAnd you can take the winner home: the resulting `here-now-workshop-page` skill is [downloadable and installable from the guide](https://indigo-kayak-2zw8.here.now/#attachments-install-the-page-skill)."
}
