{"topic":"design-onboarding","content":"# Design onboarding notes\n\nSecondPage's current publish contract is static files. Treat design preferences\nas authoring context: ask only when useful, carry the answers into the HTML/CSS\nfiles you generate, and do not claim that the preference was saved globally\nunless a separate product surface has actually saved it.\n\n## When to ask\n\nAsk about taste only when the Page would benefit from a stronger visual\ndirection and the user's intent is not already clear. Do not block publishing.\n\nGood prompts are short and concrete:\n\n- \"Should this feel more like a quiet memo, an editorial page, or a dense dashboard?\"\n- \"Do you want this airy and premium, or compact and operational?\"\n- \"Any hard no's: stock photos, gradients, loud colors, tiny text, heavy cards?\"\n\n## What to capture\n\nUse these dimensions as private drafting guidance:\n\n- **Character:** analytical, bold, calm and premium, editorial, playful, utilitarian, or whatever the user's own words suggest.\n- **Density:** airy, balanced, compact.\n- **Voice:** quiet factual labels, warm direct copy, energetic headings.\n- **Exclusions:** stock imagery, decorative gradients, cluttered cards, marketing tone.\n- **Use case:** report, itinerary, dashboard, comparison, guide, visual explainer.\n\nMap the answer into the generated bundle:\n\n```css\n:root {\n  /* Name the direction the user actually chose,\n     e.g. quiet-editorial, playful-bold, or dense-operational. */\n  --page-density: balanced;\n  --page-tone: playful-bold;\n}\n```\n\n## Link-based inspiration\n\nIf the owner gives public websites or images as examples, use them as inspiration\nfor the current Page only unless a separate saved-profile flow exists. Borrow\npalette, spacing, density, typography feel, and layout cues. Do not copy logos,\nproprietary text, exact hierarchy, brand names, or source imagery.\n\n## After Edits\n\nIf the user repeatedly asks for the same design change, apply it to future\nPages you author in that organization context. Until the product has a live\nprofile persistence contract, keep that as agent-side context rather than a\nstored SecondPage setting.\n"}