REQUIREMENTS AI QUERY LANGUAGE

Make software requirements executable.

RAIQL is a declarative language for describing application structure, data models, APIs, access rules and delivery intent in a specification that can be parsed, validated and compiled.

Start with RAIQL →Open playground

01 Human-readable02 Machine-validatable03 AI-native by design

commerce.raiqlvalid

CREATE APPLICATION "Commerce Core";
TYPE WEB;

USE STACK
  FRONTEND NEXTJS,
  BACKEND SPRING_BOOT,
  DATABASE POSTGRESQL;

CREATE ENTITY Product (
  id UUID PRIMARY,
  name STRING REQUIRED,
  price DECIMAL REQUIRED
);

CREATE API Product;
CREATE CRUD Product;
ADD AUTHENTICATION JWT;

GENERATE TESTS;
BUILD;

RAIQL compilersource → AST → IR → generators

One specification Explicit intent Deterministic structure Extensible generation

WHY RAIQL

Prompts explain. Specifications define.

Natural-language prompts are excellent for exploration, but software delivery needs stable structure. RAIQL captures the parts of an application that should be explicit—its type, technology stack, domain model, APIs, security intent and build actions.

The compiler turns that source into a normalized intermediate representation so downstream tools operate on a predictable contract instead of re-interpreting prose.

Understand the compiler →

01RAIQL sourceReadable requirements

02Parser + validationDeterministic language core

03RAIQL IRStructured application contract

04GeneratorsCode, tests and delivery artifacts

LANGUAGE SURFACE

Describe the system, not every keystroke.

RAIQL keeps intent close to the product model while leaving implementation detail to the selected stack and generators.

APP

Application intent

Declare application type and selected technology stack in one place.

TYPE WEB;

DATA

Domain model

Define entities, fields, types, constraints and relationships.

CREATE ENTITY Product (...);

API

Application surface

Express CRUD and API generation intent against named entities.

CREATE API Product;

AUTH

Security intent

Declare authentication mechanisms, roles and access rules.

ADD ROLE ADMIN, USER;

Compiler IR

Compile source into a stable JSON representation for tooling.

source → AST → IR

SHIP

Delivery intent

Attach tests, build and deployment targets to the specification.

DEPLOY DOCKER;

READABLE BY DESIGN

A concise language for application architecture.

RAIQL syntax favors explicit statements and familiar data-model concepts. The same source can be read during planning, reviewed in pull requests and consumed by the compiler.

Semicolon-delimited statements
Typed entity fields and modifiers
Cross-reference validation
Machine-readable intermediate representation

domain.raiql

CREATE ENTITY Order (
  id UUID PRIMARY,
  customerId UUID REQUIRED,
  total DECIMAL REQUIRED,
  status STRING REQUIRED
);

RELATE Order.customerId TO Customer.id;
CREATE API Order;

DOCUMENTATION

Learn the language from first declaration to build intent.

The documentation covers syntax, data types, entities, APIs, authentication, compiler behavior, IR shape and deployment statements.

01Getting startedFirst valid RAIQL program 02Language fundamentalsStatements, comments and structure 03Entities & typesModel application data 04APIs & securityExpose and protect application behavior

WRITE YOUR FIRST SPECIFICATION

Start with requirements.
Compile toward software.

Open the playground →Read the language spec