docs.archai

A path-first architecture language for sites, parcels, terrain, buildings, evals, and agent patches.

Start With A Site Primitive Index Read The Path Model

ArchAI starts from land and rules, then generates complete building options that can be evaluated, patched, committed, and exported.

The core loop:

site / parcel / terrain -> zoning -> envelope -> building option -> eval -> repair -> commit -> export

Path-first docs

Source, graph nodes, eval findings, and repair patches use canonical paths such as site.main.parcels.pcl_001.constraints.setbacks.front.

Full built environment graph

The model includes parcels, terrain, zoning overlays, envelopes, buildings, systems, spaces, constraints, and artifacts.

Agent-ready patches

Agents change designs through explicit operations, selectors, paths, evals, and repair hints instead of raw meshes.

Primitive inventory

The reference now enumerates entity, operation, artifact, terrain, planning, building, and adapter primitives.

Cloudflare deployable

The docs site is static and deploys directly to Cloudflare Pages.

Primitive Reference

Start with the Primitive Index for the complete checklist. The detailed pages cover:

Minimal Language Shape

project housing_study:

  site main:
    parcels:
      parcel pcl_001:
        boundary:
          edge front: (0, 0) -> (42000, 0) tags [frontage]

        constraints:
          setbacks:
            front:
              from boundary.edges.front
              distance 5000mm

    envelopes:
      primary:
        parcel parcels.pcl_001
        derive_from parcels.pcl_001.constraints

  buildings:
    building b_001:
      parcel site.main.parcels.pcl_001
      envelope site.main.envelopes.primary
      use residential
      target_gfa 4200sqm