Architecture Overview

This page is a map of the Universal Automation Wiki (UAW) docs and the major systems in this repo.

This page is a map of the Universal Automation Wiki (UAW) docs and the major systems in this repo.

Start Here

Where Docs Live

  • Source: docs-md/ (Markdown)
  • Generated site: web/docs/ (HTML)
  • Generator: routines/docs/docs-translator.py

Simulation Playground (High Level)

The playground is a browser-based editor for simulation JSON. It renders timelines/layouts and runs a client-side validation engine driven by a metrics catalog.

Guides - Space Editor Guide - Display Editor Guide - Smart Actions - Save & Load - Multi-Day Simulations

Simulation & Validation - Simulation & Validation System - Validation Rules Reference - Metric & Constraint ID Standardization - Metrics Editor - Actor Movement - Universal Object Model (Simulation)

WorkSpec (Canonical Model)

WorkSpec is the canonical specification for how work is described and exchanged across tools.

Content Generation Routines (High Level)

The routines/ scripts form a pipeline that can generate UAW pages for a topic (metadata → trees → timelines → challenges → adoption → implementations → ROI → future tech → specs → assembly).

Core pipeline docs - Flow Maker - Generate Metadata - Hallucinate Tree - Generate Automation Timeline - Generate Automation Challenges - Automation Adoption - Current Implementations - Return Analysis - Future Technology - Specifications Industrial - Assemble

Standards