Using blocks with an AI builder

Plain HTML, CSS variables and clear rules: the shape of thing an AI builder gets right first time.

Why blocks suit AI builders

An AI builder does its best work with small parts that have clear rules. These blocks give it both.

  • No hidden behaviour. Blocks are plain HTML and CSS with no scripts and no inline styles, so there is nothing for the builder to wire up or break.
  • One place to change the look. Everything visual is a --blk- variable. The builder edits a theme file and never touches the blocks.
  • Machine-readable docs. llms.txt is the index and llms-full.txt holds every block, token and rule in one file.
  • Guard rails. Themes are contrast-checked at build time, and the rules tell the builder never to invent numbers or clients.

Prompts to copy

Paste these into Claude, ChatGPT, Lovable, v0 or any builder that can read a URL.

Build a page

Prompt

Build a landing page using Product Scope Blocks (https://resources.productscope.uk/blocks/blocks). Read https://resources.productscope.uk/blocks/blocks/llms-full.txt first. Link https://resources.productscope.uk/blocks/blocks/kit/blocks.css once and set data-blk-theme on the body. Use these blocks in this order: hero-proof, feature-rows, case-panels, faq, cta-band. Replace the placeholder text with the content I give you. Customise only through the --blk- CSS variables. Add no inline styles and no scripts. Do not invent numbers, clients or quotes: if I have not given you a fact, leave that part out. My business: [what you do, for whom] My proof: [real numbers or results] My colours: [brand colours, or choose a theme]

Make a theme for a brand

Prompt

Create a new theme for Product Scope Blocks (https://resources.productscope.uk/blocks/blocks/themes) for this brand: [colours and mood]. Output one CSS file that sets only --blk- variables under [data-blk-theme="my-brand"]. Read https://resources.productscope.uk/blocks/blocks/llms-full.txt for the list of tokens. Keep --blk-accent at 4.5:1 or better on white, --blk-on-dark-muted at 4.5:1 or better on every dark surface, and --blk-on-accent readable on --blk-accent. Tell me the contrast ratios you checked.

The rules

These are the same rules the builder is given in llms-full.txt.

  • Include blocks.css once. Add at most one theme file and set data-blk-theme on the page.
  • Paste block HTML as given and keep the class names. Change the text and links.
  • Customise with tokens, never by editing a block's CSS or adding inline styles.
  • Do not invent numbers, clients or quotes. If you have no proof, remove that part of the block.
  • One section header per section, one filled button per page, outline buttons for links to other pages.

Want a site built on blocks like these?

I help teams plan, build and ship websites, products and automation, using AI where it makes the work faster and safer.