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.
Zero-Config CLI Commands
Scaffold, verify, and compile design tokens directly in any project repository.
npx orthotect init
The Orthotect Runtime Pipeline
How agent instructions transform into verifiable, certified enterprise code through deterministic gates.
Skill Specification
Agent loads domain doctrine, DTCG token contracts, and FSM transition schemas.
Agent Generation
AI model synthesizes UI code strictly referencing semantic tokens and FSM handlers.
5 Deterministic Gates
Parallel mathematical AST verification: WCAG contrast, BiDi coordinates, FSM graphs, CWV budgets, and anti-slop.
Certified Production Release
Validated zero-CLS code committed directly to main, deployable without human rework.
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)
|
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.
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.
Active Tokens
Agent Prompt Instruction
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 BuilderTarget Agent Environments
Required Quality Gates
Production Examples Gallery
Explore 50 standalone, pre-certified production templates built to Orthotect standards. Each template includes DTCG design tokens, FSM models, full BiDi symmetry, WCAG 2.2 AAA contrast, and one-click source downloads.
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.pyCalculates relative luminance \(L = 0.2126R + 0.7152G + 0.0722B\) to enforce 4.5:1 for body copy and 3.0:1 for graphical interfaces.
tests/test_contrast.py (12 tests)2. True BiDi & Logical
gate_bidi_logical.pyAST regex and parser enforcing 100% CSS logical properties. Zero tolerance for physical coordinates.
margin-inline, inset-inline, padding-inline.tests/test_bidi.py (10 tests)3. FSM Integrity
gate_fsm_integrity.pyValidates deterministic state transition graphs, BFS reachability from initial state, and race locks.
allowClick: false during submitting/loading.tests/test_fsm.py (11 tests)4. DOM & Layout Shift
gate_cwv_budget.mjsWHATWG-compliant parse5 iterative stack traversal enforcing max DOM depth ≤ 32 and media dimension reservations.
tests/test_cwv.py (26 tests)5. Anti-Slop Inspector
gate_no_slop.pyDetects and flags generic AI cliches: uncalibrated indigo gradients, raw emoji icons in buttons, and hardcoded values.
#6366f1 gradients, requires SVG icons.tests/test_slop.py (8 tests)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