ahd — v0.4.2 — main

Artificial Human Design

A framework for evaluating web design with explicit rules, not model optimism. You write a brief in YAML, AHD compiles it, runs a 28-rule linter, and scores candidates against a vision-critic scaffold. No rankings without reasoning.

01

ONE LINER

bash
ahd — eval-live
$ ahd eval-live swiss-editorial \
    --brief briefs/landing.yml \
    --models claude-sonnet-4,gpt-4o,gemini-2.5-pro \
    --n 10
02

What ships

  • OK Brief compiler
  • OK 28-rule linter typography, color contrast, motion, reflow, focus, alt text
  • OK Eval harness parallel generation, rule enforcement, score aggregation
  • OK Vision-critic scaffold prompt templates, structured output schema, no live calls
  • OK MCP server stdio transport, tool definitions for brief inspection
  • OK Editor plugins VS Code, Zed; .wasm for nvim in progress
  • OK Eight tokens curated design vocabulary, versioned in git
03

What is gated

  • KEY Live frontier-model calls requires your own API keys
  • KEY Live vision critique requires multimodal key + screenshot pipeline
  • WIP Standalone npm packages for editor plugins
  • WIP Additional tokens
Read the code forgejo mirror also available