Guide · Intermediate
Review AI-generated website code
Turn a large generated code dump into an inspectable set of claims, files, behaviors, tests, and small corrections.
- Author
- Editorial team
- Reviewer
- Publication review pending
- Review tier
- 90-day
Begin with the contract
Write down the user, task, required pages, content facts, technologies, accessibility requirements, and explicit exclusions. Review generated output against that contract before judging visual polish.
Reduce the surface
List files and dependencies. Remove packages whose behavior is not justified. Find network requests, storage, forms, trackers, and dynamic HTML because they cross trust or privacy boundaries.
Review in layers
- Confirm source order, headings, landmarks, links, controls, labels, and content truth.
- Check responsive layout, zoom, focus, motion, and failure states.
- Validate all mutable endpoints and output encoding.
- Measure asset sizes and client JavaScript.
- Inspect metadata, canonicals, links, and public response status.
Run behavior, not just syntax
Open every important route. Use only a keyboard, block JavaScript, slow the network, force invalid input, and try direct deep links. Automated checks help find classes of problems but do not prove conformance or user success.
Ask for small corrections
Give the assistant one reproducible finding and request the smallest patch plus a regression test. Broad “make it better” prompts invite unrelated changes and hide whether the original defect was fixed.