authoringlisted

# openEHR Specification Document Authoring This skill covers creating and editing openEHR specification documents — the AsciiDoc sources that live in `specifications-XX` repositories (RM, AM, BASE, LANG, PROC, SM, QUERY, CNF, TERM, ITS-*). > **Note:** `specifications-ITS-REST` is an exception — it uses OpenAPI YAML with embedded Markdown > rather than the standard AsciiDoc approach. See the "ITS-REST Exception" section below. ## Related Skills - **content-patterns** — prose writing patterns for spec chapters (overview, semantics, design rationale, etc.) - **amendment-record** — dedicated guide for amendment record authoring - **review** — checklist-driven quality review of spec documents - **its-rest** — for OpenAPI YAML and Markdown in the ITS-REST repo - **governance** — release management, change requests, lifecycle governance - **class-generation** — regenerate the class-definition tables and UML diagrams in `docs/UML/` from BMM via `bmm-publisher` - **Cross-reference guide** — see `references/cross-references.md` for attribute naming patterns ## Repository Layout Each specification component lives in its own repo: `specifications-XX` (e.g., `specifications-RM`). The shared infrastructure repo `specifications-AA_GLOBAL` provides boilerplate, styles, references, and publishing scripts used by all components. ``` specifications-XX/ ├── manifest.json # Component metadata, specs, releases, Jira links ├── docs/ │ ├── index.adoc # Component ind