Skip to content

Generative AI

Generative AI is a powerful tool, but without good guidance and clear context it’ll happily produce off-brand, generic, or flat-out wrong output. When you use it to make something for the Pulumi brand, follow the rules below.

One principle above all: We don’t hand our brand to an AI agent and walk away. AI is a powerful tool for drafting and reviewing, but everything we publish has to carry a real point of view — and that comes from you. Your experience, your judgment, and the quality of what you put in are what separate something valuable and worth a reader’s time from generic, bot-generated filler.

  • When it’s grounded in the brand. Point your agent at our brand guidelines MCP server so it’s working with good context instead of just guessing.
  • When it’s given your thinking, a clear prompt, a good writing sample, and a solid outline as input.
  • When you’re using it as a reviewer. Ask a different agent (or the same agent in a different session) to read the piece you’re working on, evaluate it as your reader would, and tell you what’s missing. See the Review for a prompt that can help with this.

AI still often hallucinates, inventing facts, numbers, APIs, and even features, and it does so with absolute confidence. Treat everything a model tells you as unverified until you’ve checked it against a real source yourself — the same standard we hold for any claim we make. (See Attribution and accuracy.)

  • Ship AI-generated copy you haven’t reviewed and revised yourself, and never ship raw model output as a finished piece. Revise it until the words are genuinely your own before you submit for review, and never publish anything without a human reviewing it first.
  • Generate original images, illustrations, or other visual assets. Our visual language is specific, image models struggle to reproduce it cleanly, and the results almost always read off-brand.
  • Generate or modify the Pulumipus with AI. Ever. (See Mascot for why.)