SPEC-REF / SYSTEM

The Technasm System

AI generates UI statistically. Without constraints, consistency collapses across iterations. The same prompt produces different spacing, colors, and structure each time. Technasm introduces a system where these decisions are constrained by design tokens and semantic primitives.

Three Layers

  1. Design Tokens
    Values only. No behavior. Color, spacing, typography, radius, and borders defined as CSS custom properties. The token set is intentionally minimal to reduce choice and increase predictability. → tokens.css
  2. Primitives
    Surface, layout, text, actions. Semantic, not decorative. Small CSS classes that combine tokens into reusable patterns. Primitives define structure, not style — a grammar AI can follow consistently. → surface.css layout.css text.css action.css
  3. AI Prompt Contract
    Explicit rules for AI. Prevents hallucination. Tells AI how to use tokens and primitives correctly. Without it, AI invents class names, adds inline styles, and creates layout drift. → technasm.prompt.md

Non-Goals

Technasm is a system, not a style.