BaseStack help article

Fix generic or inaccurate AI output

A troubleshooting guide for portfolio copy, layout, and details that miss the mark.

Overview

AI generation is strongest when the source data and refinement prompt are both clear. If a site feels generic, first improve the Data Tree, then use a targeted refinement request.

Common causes

Key points

  • The Data Tree has broad labels like "developer" or "designer" without projects, outcomes, or audience.
  • Several sections repeat the same information, so the AI gives the duplicate details too much weight.
  • The selected vibe is too broad, such as "modern" without direction.
  • The refinement prompt asks for everything at once, which makes the changes harder to control.
  • Photos are low resolution, too dark, or not relevant to the story the site is trying to tell.

Better refinement prompts

Key points

  • Make the hero sound more senior and less salesy. Emphasize product engineering, developer tools, and founder collaboration.
  • Keep the visual style, but rewrite the project section so each card explains the problem, stack, and result.
  • Use a calmer editorial layout with more whitespace. Remove hype language and make the copy more direct.
  • Replace the contact call to action with a consulting-focused CTA for startups that need launch help.

Refine in small passes

One focused request usually works better than a long list of unrelated changes. Save versions between big changes so you can restore a better draft.

When to use manual editing

Overview

Use manual editing for short text fixes, image crop positions, and tiny polish after the generated structure is right. Use AI refinement for larger changes to layout, tone, sections, and visual direction.