Declarative YAML Schemas

AAM models architecture into four semantic layers using static, checked, local YAML nodes.

1. system.yaml

Declares global repository specifications, identity, ownership, and tech stack parameters.

system.yaml Fields

string

Required

Global system slug ID (e.g. SYS-ORCHESTRIX).

name

string

Required

Human-readable system title.

description

string

Required

Detailed explanation of the system purposes.

stack

string[]

Optional

Tech stack tags.

yaml

id: SYS-ORCHESTRIX
name: Orchestrix Core Platform
description: LangGraph multi-agent orchestration service with NVIDIA embeddings.
stack:
  - nextjs
  - spring-boot
  - python-fastapi

2. domains/*.yaml

Establishes high-level business or technical boundaries (e.g. Backend, Frontend, Data Platform).

yaml

id: DOM-BACKEND
name: Backend Platform
description: Core transactional APIs, microservices, and databases.
ownership: Backend-Team

3. features/*.yaml

Cross-cutting capabilities that capture real business value (e.g. Authentication, Ledger Services).

yaml

id: FEAT-AUTHENTICATION
name: Secure Authentication
description: End-to-end OAuth2 and JWT credentials validation.
domains:
  - DOM-BACKEND
  - DOM-FRONTEND
components:
  - COMP-AUTH-SERVICE
  - COMP-API-GATEWAY