A shared semantic layer

Architecture should mean the same thing everywhere.

Architecture Tokens are the smallest reusable semantic units for software architecture.

Define intent once. Reference it across diagrams, documentation, reviews, and automation—without binding the meaning to a particular cloud or tool.

Read the specification Explore the repository

Architecture token

component.database

semantic

id: component.database
name: Database
category: component
description: >-
  A persistent structured data store.

capabilities:
  - persistent-storage
  - structured-query

constraints:
  - stateful

Stable meaning, flexible implementation

One token. Many environments.

The semantic contract stays constant while each environment chooses an implementation that satisfies it.

Semantic token Database component.database

AWS RDS
Azure Azure SQL
Google Cloud Cloud SQL

The v0.1 premise

Meaning before rendering.

01
Semantic first
Describe architectural intent before choosing implementation.
02
Tool independent
Reference the same vocabulary from diagrams, docs, and automation.
03
Small and composable
Build architecture models from focused, reusable units.

Open draft

Help shape the vocabulary.

The first specification is intentionally small. Review the model, test it against real architecture work, and propose what it is missing.

Review v0.1 on GitHub