What an AI assistant should follow when building a small tool for someone
who has a browser and nothing else. Written in English on purpose —
models follow it more reliably. The tools it produces speak the user's
language.
Every section in one file. One fetch, no follow-ups.
/ai-build-guide/guide/<name>.md
A single section as plain text.
The rule that matters most
Deliver a folder the user saves, where
index.html runs from a double-click. No
build step, no server, nothing to install. One file for a small tool,
several when it earns it — classic <script src> and
<link> work fine across files. What does not work on
file://: ES modules and fetch() of local data.