aql-authoringlisted

# AQL Authoring > The inline syntax below is a quick crib. The `aql/syntax` guide loaded in Step 1 is authoritative — if they ever disagree, follow the guide. ## Step 1: Load Guides (MANDATORY) Before writing or reviewing any AQL query, load the authoritative guides: ``` guide_get("aql/principles") guide_get("aql/syntax") guide_get("aql/idioms-cheatsheet") ``` ### Consult worked examples (when applicable) When the user asks for a query to adapt, or when the clinical question matches a common pattern (cohort selection, pagination with total count, time-window filtering, cross-composition joins, terminology value-set matching, "latest per EHR", ISM-state filtering), try `examples_search(kind="aql")` before drafting. The curated AQL examples are under `openehr://examples/aql/{name}` and include pattern metadata and related-spec links — reuse and adapt rather than invent. Skip this step if the question is clearly novel or the user already provided the skeleton. ## Step 2: Understand the Data Model AQL queries operate on archetypes. Before writing a query: 1. State assumptions about deployed templates/archetypes — verify path endpoints and RM types against the deployed template, not display labels 2. Identify which archetypes contain the data you need 3. Load the archetype to understand its path structure: ``` ckm_archetype_get("<archetype-id>") ``` 4. Use `type_specification_get` if you need to understand RM type details ## Step 3: AQL Syntax ### Basic Structu