Build a Revision Site

I want to build a revision website for my child, [CHILD'S NAME], studying [SUBJECT] at [GCSE or A Level] with [EXAM BOARD], specification code [SPEC CODE]. The exam is on [EXAM DATE]. Target grade: [TARGET GRADE]. [ANYTHING ABOUT HOW THEY LEARN — for example "has ADHD and gives up on long pages". Delete this if there's nothing.]

Before anything else, find [EXAM BOARD]'s official documents for [SPEC CODE] on the board's own website and download them: the specification, any formula booklet or data sheet issued in the exam, and the most recent past papers, mark schemes and examiners' reports. Tell me the exact title, issue number and date of the specification you found, and wait for me to confirm before going further. Everything on the site must come from those documents, not from memory. If you cannot download something, say so — I will attach it.

One rule for the whole project: never install anything globally on this computer. If you need a tool, use npx, or tell me exactly what to install and where, and wait for me.

Don't build anything yet. Propose how the site should work and wait for me to agree. I want:

- Every topic and numbered point from the specification, in the board's own numbering, with a plain-English summary of what the exam expects.
- Practice questions. Where an answer can be checked automatically (numbers, short answers, multiple choice), check it instantly and then show the working. Where it cannot (longer writing), show a model answer and a self-marking checklist — never pretend to mark it.
- Mark-scheme guidance in the convention this board uses for this subject: find out from the mark schemes you downloaded whether it marks step by step (then label each step with its mark) or by levels (then show the level descriptors and what moves an answer up a level).
- Pitched at [TARGET GRADE] — depth, not prediction. I'll say exactly how in a later step.
- Progress saved in the browser, so it opens where [CHILD'S NAME] left off with no sign-in.
- Works on whatever they actually use — phone, tablet or laptop — and quick on a small screen, in short sessions, with one obvious thing to do on the front page.
- Tests you run yourself. Never tell me a step is done if a test is failing.

It only needs to run where I am for now; nothing goes online yet. Make every technical decision yourself and just tell me what you chose. Only ask me questions a parent could answer. Keep the plan to a page.

Build the site and the full topic map: every topic and numbered point from the specification, each with its summary and a short "in the exam" note on where the marks usually are. Keep the board's numbering exactly — I'll check it against the PDF. Set up the tests and run them. Then start the site and tell me the address to open on this computer.

Pitch the whole site at [TARGET GRADE]. This is about depth, not prediction: I want [CHILD'S NAME] working on what is within reach, not being shown material meant for someone two grades above. Do not hide or drop any topic — the specification does not say which content belongs to which grade.

If this qualification has tiers, tell me what each tier covers, and I will tell you which one the school has entered [CHILD'S NAME] for; do not guess.

Work it out from question demand instead, using the past papers and mark schemes you downloaded: the questions and question parts a [TARGET GRADE] candidate must get every time are the standard; the final parts of the longest questions are stretch. [GCSE only: Content the specification marks as Higher-only is stretch for a Foundation target and required for a Higher target. Delete this sentence for A Level.]

For every topic write two lines: "For a [TARGET GRADE] you must be able to…" and "Stretch: …". Do ONE topic first, tell me which past-paper questions you based it on, and wait for me to agree before doing the rest.

Before you write any questions: what does [SUBJECT] need that a generic revision site wouldn't have? Look at the past papers you downloaded and tell me what those questions actually put in front of a candidate.

Then add whatever applies: [KEEP THE ONES THAT FIT — spoken audio, and a way to record my child speaking and play it back; diagrams to label or complete; a quotation bank; source extracts, graphs or case studies to work from; a reference sheet of formulae or key terms; anything else you found in the papers.]

Use what's already built into the browser rather than anything I have to pay for or sign up to. If something can't be done well that way, say so plainly and tell me what the honest version looks like instead. Don't approximate it, and don't offer to mark anything you can't really mark.

Add practice questions for every numbered point, one topic at a time. After each topic, tell me it's done and continue with the next without waiting for me. Every question that can be checked automatically must be. Add a test that proves every question marks its own correct answer as correct — a site that tells a child they're wrong when they're right is worse than no site. Each five-question session should be three or four questions at [TARGET GRADE] level and at most one stretch question, labelled as stretch. Run the tests before you tell me you've finished.

For every question, show the working the way this board's mark schemes do — [step by step with the mark each step earns / against level descriptors — whichever you found in step 2] — with one line on why each mark is given. Say which marks an answer at [TARGET GRADE] must secure and which it can afford to drop. Add the mistakes the board's examiners' reports say students make on each topic, taken from the reports you downloaded; if you can't find a report for a topic, say so rather than inventing one.

Now make it the site [CHILD'S NAME] will open every day, not once. Front page: one clear thing to do, opening on whatever topic they practised last. Sessions of five questions with a clear finish. Never use "overdue", "due", "behind" or anything that makes revision sound like a debt. Fold long explanations away behind a tap. Quick on a small screen, readable in light and dark. No analytics, no tracking, no third-party scripts. [ANYTHING ABOUT HOW THEY LEARN, or delete.] Then look at the front page, a topic page and a question at phone width and on a tablet-sized screen, and tell me honestly what still looks wrong.

Go through every piece of content on the site and check it against the documents you downloaded — every claim about what is examined, what is given in the exam, and what a grade needs. List what you found and fixed, naming the page and the document you checked it against. Then add tests that stop the site contradicting itself in future — for example, one page saying a formula is given in the exam and another saying it must be memorised.