Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.aiparlance.org/llms.txt

Use this file to discover all available pages before exploring further.

​
AI Parlance

v0.1 is specification-only. Parser, validator, and transpilers are not published yet. This documentation defines the language; code generation is planned.
AI Parlance is an AI-first language for intermediate representation (IR) in AI-assisted software generation — focused on data-oriented applications, APIs, authorization, and declarative automations. Humans, agents, and LLMs describe systems in .aip; transpilers turn the spec into concrete implementations. 
Human or AI
↓
AI Parlance (.aip)
↓
AST + validation
↓
Transpilers
↓
Go, TypeScript, SQL, OpenAPI, …
Normative details: Specification.

​
Why it exists

When models generate code directly in general-purpose languages, they face:
  • large amounts of boilerplate (CRUD, routes, validation, migrations)
  • inconsistency across stacks
  • large context → more tokens and more hallucination
  • business rules and permissions scattered in generated code
AI Parlance concentrates intent in a compact semantic layer before implementation.

​
What it describes (and what it does not)

DescribesDoes not describe
entities, types, relationscustom UI
CRUD, indexes, migrationscomplex algorithms
auth, policiesintegrations without a dedicated block
domain workflows and eventshand-written imperative SQL

​
Minimal example

app Demo @0.1 {
  database postgres
}

entity User {
  name: string required
  email: email required unique
}

crud User
See examples/minimal.aip. Every v0.1 spec requires one app block (Specification). One definition can feed multiple generators (see transpiler matrix).

​
AI-first principles

The language prioritizes, in order:
  1. domain intent and semantics
  2. predictable structure for LLMs
  3. static validation before generation
  4. multi-target implementation via transpilers

​
Documentation map

PageContent
SpecificationGrammar, builtins, policies, stability
Cost impactTokens, honest comparisons
SyntaxCore + Infra blocks
DatabaseMigrations, indexes, naming
SecurityAuth, policies, rate limit
WorkflowsEvents, jobs, queues
AgentsPrompts, ai_context, best practices
Reference spec: examples/crm-reference.aip.