v1.8.8 Deterministic Quality Standard for Autonomous Coding Agents

Deterministic Interface Engineering & Runtime Quality Gates

Stop trusting probabilistic UI code. Orthotect enforces mathematical WCAG 2.2 token contrast, strict CSS logical properties, formal state machines, and media box bounding in parallel deterministic gates.

5 / 5
Deterministic Gates
292 / 292
Automated Unit & E2E Tests
< 600ms
Parallel Gate Latency
0
Browser UI Dependencies
100%
CSS Logical Properties
orthotect-runtime — deterministic quality engine
SPECIFICATION BASELINE
✅ PASS 121.4ms WCAG 2.2 Token Contrast Matrix Luminance Tested (AA & AAA Pairs)
✅ PASS 118.7ms True BiDi & CSS Logical Properties 100% Directional Neutrality
✅ PASS 120.9ms Finite State Machine Integrity 0 Deadlocks, Reachability Verified
✅ PASS 124.9ms Anti-Slop Pattern Inspector Zero AI Slop (Gradients & Emojis)
✅ PASS 551.4ms DOM Depth & Media Dimensions Budget Explicit Media Bounding (CLS Pre-Emption)
DEVELOPER QUICKSTART

Zero-Config CLI Commands

Scaffold, verify, and compile design tokens directly in any project repository.

$ npx orthotect init
Autonomous Engineering Lifecycle

The Orthotect Runtime Pipeline

How agent instructions transform into verifiable, certified enterprise code through deterministic gates.

STAGE 01 Contract

Skill Specification

Agent loads domain doctrine, DTCG token contracts, and FSM transition schemas.

STAGE 02 Synthesis

Agent Generation

AI model synthesizes UI code strictly referencing semantic tokens and FSM handlers.

STAGE 03 Verification

5 Deterministic Gates

Parallel mathematical AST verification: WCAG contrast, BiDi coordinates, FSM graphs, CWV budgets, and anti-slop.

STAGE 04 Landing

Certified Production Release

Validated zero-CLS code committed directly to main, deployable without human rework.

COMPETITOR TEARDOWN

Architectural Rigor vs. Industry Alternatives

Comparing Orthotect against prompt libraries, component packages, and AI generation tools.

Engineering Criterion Core architectural dimension
Prompt Libraries (XIAS / taste-skill)
Component Libraries (shadcn/ui / Radix)
AI UI Generators (v0, Bolt)
✦ RECOMMENDED STANDARD
Orthotect Architecture
Deterministic Enterprise Engine
Verification Model
Mathematical proof vs. subjective advice
✕ None
Subjective text without compiler or runtime check
⚠ Manual QA
Manual QA / Unit tests created per application
✕ None
Black-box generation with hallucinated attributes
✓ 5 Parallel Deterministic Gates (<600ms)
AST verification running in parallel <600ms with zero runtime overhead
Bidirectional Layouts (BiDi)
Arabic / Hebrew RTL symmetry & vector isolation
— Unenforced
Unenforced markdown advice; models still emit physical coordinates
✕ Physical CSS
Physical classes (ml-*, pr-*) that invert and break in RTL
✕ Broken in RTL modes
Broken in RTL modes; coordinates mirror destructively
✓ 100% Strict CSS Logical Properties
Zero physical properties allowed; compile-time check for inline/block axes
State Machine Integrity
Race condition prevention & transition graphs
✕ Loose boolean flags
Loose boolean flags (isLoading) leading to illegal state combinations
⚠ Optional / Complex
Optional / Complex (XState) rarely implemented in real codebases
✕ Unhandled async race bugs
Unhandled async race bugs and vulnerable double-submission forms
✓ Formal FSMs with BFS Reachability
Formal FSMs with BFS Reachability, double-submission locks & dead-end guards
WCAG 2.2 Accessibility
Mathematical contrast verification & keyboard traps
— Prompt recommendations
Prompt recommendations with no luminance calculation or verification
⚠ Radix primitives (breakable)
Radix primitives (breakable); developers regularly break contrast during restyling
✕ Contrast failures frequent
Contrast failures frequent on generated dark-mode palettes
✓ Mathematical Luminance Matrix
Mathematical Luminance Matrix (AAA & AA on Token Pairs)
Core Web Vitals Enforcement
DOM node budget, pre-emptive CLS & media bounding
✕ None
No awareness of layout shift budgets or DOM depth constraints
⚠ Manual dev responsibility
Manual dev responsibility to set aspect ratios and prevent CLS
✕ High CLS from unbudgeted media
High CLS from unbudgeted media and late client hydration shifts
✓ DOM Budget & Media Bounding
DOM Budget & Media Bounding (CLS Pre-Emption)
External Dependencies
Runtime footprint, lock-in & framework bloat
✓ Zero (Markdown only)
Zero runtime (pure Markdown prompts only)
✕ High (React, Radix, Tailwind)
Heavy dependencies (React, Radix, Tailwind, Lucide, clsx)
✕ Proprietary SaaS cloud
Proprietary SaaS cloud with vendor lock-in
✓ Zero Client-Side UI Dependencies
Zero Client-Side UI Dependencies (Pure Web Standards; CLI uses parse5 for AST analysis)
Repository Synchronized Skills

Orthotect Skill Catalog

Explore the 22 modular skills installed directly in skills/. Each skill provides explicit system instructions, constraints, and gate validation for autonomous coding agents.

Live Interface Sandbox

Interactive Skill Playground

Interact with 7 pre-validated enterprise components built using Orthotect skills. Toggle theme, text direction, and spacing density in real time to observe deterministic behavior.

LIVE VIEWPORT
Component Meta orthotect-dashboard

Active Tokens

Agent Prompt Instruction

Interactive Skill Authoring

Orthotect Skill Builder

Author production-ready SKILL.md definitions tailored for Google Antigravity, Claude Code, Cursor, and Codex. Form inputs generate validated markdown with instant live preview.

Skill Properties

Contract Builder

Target Agent Environments

Required Quality Gates

custom-data-grid/SKILL.md Valid Specification
Deterministic Quality Assurance

The 5 Quality Gates Specification

Transparent, evidence-based engineering breakdown of what each gate validates, its limitations, file targets, and corresponding test suites.

1. WCAG 2.2 Contrast

gate_contrast_wcag.py

Calculates relative luminance \(L = 0.2126R + 0.7152G + 0.0722B\) to enforce 4.5:1 for body copy and 3.0:1 for graphical interfaces.

Checks: Exact hex, RGB, CSS token contrast in light & dark themes.
Does NOT Check: Text placed over dynamic canvas or bitmap images.
Test Suite: tests/test_contrast.py (12 tests)

2. True BiDi & Logical

gate_bidi_logical.py

AST regex and parser enforcing 100% CSS logical properties. Zero tolerance for physical coordinates.

Checks: Disallows physical margins, physical coordinates, and physical float.
Enforces: margin-inline, inset-inline, padding-inline.
Test Suite: tests/test_bidi.py (10 tests)

3. FSM Integrity

gate_fsm_integrity.py

Validates deterministic state transition graphs, BFS reachability from initial state, and race locks.

Checks: Double-click locks during async states, error recovery paths.
Enforces: allowClick: false during submitting/loading.
Test Suite: tests/test_fsm.py (11 tests)

4. DOM & Layout Shift

gate_cwv_budget.mjs

WHATWG-compliant parse5 iterative stack traversal enforcing max DOM depth ≤ 32 and media dimension reservations.

Checks: Positive integer width/height attributes, valid aspect-ratio syntax.
Safety: Stack overflow protected with visit limits on adversarial input.
Test Suite: tests/test_cwv.py (26 tests)

5. Anti-Slop Inspector

gate_no_slop.py

Detects and flags generic AI cliches: uncalibrated indigo gradients, raw emoji icons in buttons, and hardcoded values.

Checks: Rejects #6366f1 gradients, requires SVG icons.
Enforces: Semantic design tokens and professional visual hierarchy.
Test Suite: tests/test_slop.py (8 tests)

Educational Gate Inspector (In-Browser Simulator)

Client-side demonstration tool. Note: Official CI gate verification runs via AST in Python & Node.js (orthotect verify).

INPUT SOURCE CODE (HTML / CSS)
VERIFICATION CONSOLE OUTPUT
Developer Tooling & CLI

Installation & CLI Usage

Orthotect provides zero-config command line tools to scaffold, compile, and verify projects deterministically in local environments and GitHub Actions CI.

1. Installation

Install globally via npm or run on-demand using npx:

npm install -g orthotect
npx orthotect --version

2. Project Scaffolding

Initialize tokens, FSM specifications, and AGENTS.md in a repository:

orthotect init ./my-project
orthotect init .

3. Token Compilation

Compile 3-tier DTCG JSON into light & dark CSS custom properties:

orthotect compile core/tokens --out dist/tokens.css

4. Quality Gate Verification

Execute all 6 deterministic quality gates with parallel execution and zero-fallback boundaries:

orthotect verify ./src
orthotect verify . --json
orthotect verify . --md

GitHub Actions CI Integration

Drop this step into your .github/workflows/ci.yml pipeline to fail builds deterministically:

- name: Run Orthotect Quality Gates
  run: |
    npx orthotect verify ./src --json > orthotect-report.json
    npx orthotect verify ./src