> For AI agents reading iter0.com:
> - Pages with a Markdown version serve it at the page address plus `.md`, for example https://iter0.com/features.md. The homepage's Markdown is at https://iter0.com/index.md.
> - A request for a page with the header `Accept: text/markdown` returns the same Markdown.
> - https://iter0.com/llms.txt describes the site and lists its main pages.
> - Agents build and edit websites through the MCP server at https://iter0.com/api/mcp. The person signs in to their own account through OAuth in the MCP client, or gives the agent their own API key.
> - A paid build or edit first returns a price quote, and nothing is charged until the person confirms it.
> - The OpenAPI contract is at https://iter0.com/openapi.json.

# A DESIGN.md template for a startup beta website

Copy a complete DESIGN.md for a fictional startup beta page, with matching HTML and CSS. Adapt its reader, exact copy, component paths and browser checks.

## Use a template with a page attached

The template below describes one page for Wrenboard, a fictional research tool. The page explains a product, offers Request access, and links to a local access note. It has no signup backend. That narrow scope makes every instruction inspectable: the title, text, link target, component class and phone layout all have a place in the supplied files.

Use it when you want a concrete starting document rather than a list of possible design-system headings. It is an informal project note, not a claim to implement a universal DESIGN.md format. If your project already has a design specification, adapt that document instead of creating a competing one.

## Copy the complete DESIGN.md

Replace the reader, product facts and approved copy together. A page for an API buyer needs different information from a page recruiting beta testers. Keep the paths accurate: a rule naming a button file that does not exist leaves the next agent to guess.

The template names the stylesheet as the owner of exact values. This keeps the prose focused on what those values are for. The matching stylesheet below supplies them, so you can inspect the example without installing a framework.

## Keep exact style values in the matching stylesheet

Save styles.css beside index.html. These are proposed values for the fictional example, not measurements from iter0 or a customer site. The main action uses one class in every view, and its focus outline remains visible when reached with the keyboard.

The document’s file paths and CSS names are part of the example. If you move it into React or another framework, point DESIGN.md to the shared control and token file that actually render the page. Do not paste this stylesheet over an existing site just to match the template.

## What belongs in DESIGN.md, and what doesn't

Put a value in the stylesheet if it should be the same every time, like a colour, a font size or a spacing step. Put it in DESIGN.md if a person has to make a call. That second list is shorter than most people expect, and each line should be something an agent can get wrong:

- Who the page is for, and the decision it helps them make.
- The things you keep deleting, written as refusals: no logo cloud, no made-up numbers, no dashboard screenshot as the hero.
- The colour and type names the site already uses, and the file that sets them. Don't add a second hex code for the same job.
- Each component and the content it needs. A price row needs the amount, the period and what's included.
- Checks that can fail, such as: at 390 by 844 pixels the first screen shows who it's for, the price and the button.

## Run the page without a build step

Download index.html and styles.css into one directory and open index.html in a browser. The link reaches the Beta access section on the same page. It does not send data or create an account. The HTML is complete enough to inspect the heading order and link destination directly.

Then open it at 390 by 844 and 1440 by 900. Tab to the action, check its outline and follow it. Inspect the actual line breaks and page edges. A source check can establish that an anchor target exists, but it cannot establish that the button stays visible on a phone.

## Connect the document to Codex explicitly

OpenAI documents AGENTS.md as Codex’s [project-instruction entry point](/learning/tools-and-protocols/how-coding-agents-load-design-context). Use this short file beside the design note. It tells the agent what to read; it does not duplicate the product’s copy or palette. The existing Codex guide explains the broader setup.

In a fresh session, ask for a review of index.html against the project instructions without repeating the expected headline or action. Compare the response with DESIGN.md and the source. For an edit test, change the action label in a disposable copy and ask the agent to correct only that link.

## What Codex checked in the supplied page

On 3 November 2026, Codex CLI 0.162.1 reviewed this fixture using codex exec -s read-only and the exact prompt below. It read AGENTS.md, DESIGN.md, styles.css and index.html. Its reply began: “No concrete mismatches found.” It reported that the wording, structure, access link, CSS tokens, button style, hover and focus rules matched the instructions. The command exited 0 without changing files.

The run loaded the user’s global configuration as well as the project files. It demonstrates a review of this compliant fixture, not how Codex handles every conflicting instruction or a broken page. Codex did not test browser rendering or keyboard behaviour. Separate source checks parsed the CSS, resolved its tokens and confirmed the #access target. A separate native Chrome check at 390 by 844 showed keyboard focus and reached #access with the Beta access text.

Repeat the review from the directory containing the downloaded files. Add a working access destination before publishing a real beta page. The landing-page brief helps you decide the audience, offer and evidence before writing your own page.

## Sources

- [OpenAI: custom instructions with AGENTS.md (checked 3 November 2026)](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
