Skip to content
Webakery baking websites since 2000

All news

Building a site step by step with Impeccable

In the launch news I said that Impeccable did an impeccable job on this site. Here is a short account of how it works, for anyone who wants to try it.

Impeccable is a skill for Claude Code. It is not a template and it does not generate a site in one shot. It leads you through a process, one step at a time, and asks for what it needs when it needs it. If you do not want to lose time, that is the point: you answer short questions instead of writing a long brief.

This is the path it took me through.

  1. It reads first. Before asking anything, it looks at the project: the documents, the existing copy, the code. It does not make you repeat what it can already find out.
  2. It interviews you. A few questions at a time: who the visitors are, what the site must achieve, what it must keep, and what the technical constraints are. It waits for each answer and confirms what it only guessed. The result is written down in a PRODUCT.md file, so the answers last beyond one conversation.
  3. It proposes a direction. Only after it knows the product does it decide how the site should look and feel, and it asks you to agree before building.
  4. It builds, and looks at the result. It follows a set of quality rules, with a list of things it will not do, and it checks the real page at the sizes the site ships at instead of trusting the code.
  5. It checks itself while you work. After every edit to a page or stylesheet, a detector looks for common design problems and reports them.
  6. It refines on request. There are commands for each kind of fix: critique, audit, polish, typography, layout, animation, and more. You pick the one you need, and it works only on that.
  7. It writes the design down. At the end it records what was actually built, colours, type and rules, in a DESIGN.md file, so the next change starts from the real design.

The result is very good, and I did not have to be a designer to get there. The process is the useful part: Claude, or any LLM, does not guess what you want. It keeps asking until it knows.