Design Quality & Craft

A craft-oriented philosophy for the web: pursue “Quality” and understanding over pure metric optimization, and resist dark patterns and “AI slop.”


Definition

Drawing on Robert Pirsig’s “Metaphysics of Quality,” Frederick O'Brien (What Zen And The Art Of Motorcycle Maintenance Can Teach Us About Web Design) argues for treating web work as craft: understand how your systems work (read docs, trace pipelines, do dependency “health work”; don’t accept “black boxes”), evaluate decisions by Quality, not a single metric (the highest-Quality option isn’t always the A/B-test winner), wed art with science (reject the false intuition-vs-testing binary), and make space for reflection. The ethical corollary: Quality orientation pulls work away from dark patterns and engagement-maximizing “slop” toward genuine delight.

This is creator-opinion — a reflective essay, not established practice — and its value to the wiki is mainly content fuel and a values counterweight to the metric-maximizing ethos elsewhere (the SEO corpus’s rank/conversion focus; vendor KPI framing). Its concrete, established kernel — documentation, dependency hygiene, understanding your stack — belongs to Clean Code & Maintainability; the rest is attributed philosophy.


Key Properties

  • Understand, don’t black-box your rendering, tracking, and AI systems.
  • Quality > single metrics — challenge A/B-test/conversion absolutism.
  • Craft ethic resists dark patterns and AI slop.
  • A values counterweight to metric-maximization; content fuel more than reference.
  • Concrete kernel (docs, dependency hygiene) overlaps Clean Code & Maintainability.

Examples from Sources

ExampleSource
”Reducing any given task to a single metric… hamstrings the entire process”What Zen And The Art Of Motorcycle Maintenance Can Teach Us About Web Design

In the Sources

SourceContext
What Zen And The Art Of Motorcycle Maintenance Can Teach Us About Web DesignPirsig’s “Quality” applied to web craft, ethics, and metric skepticism.

Concepts: Clean Code & Maintainability, Responsive & Intent-Based Design, Web Accessibility (WCAG 2.2 AA) Entities: Frederick O'Brien, Smashing Magazine