From dc7c6d5567e0fc9a49fd2d21a1ec8b8318a9bc12 Mon Sep 17 00:00:00 2001
From: Agent IX <agent@agent-ix.dev>
Date: Tue, 23 Jun 2026 10:19:47 -0700
Subject: [PATCH] feat(artifact): Glossary artifact for project Ubiquitous
 Language (FR-044)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A project authors a Glossary with a ## Terms table (Term | Definition). The
Term column is harvested by quire-rs (FR-044) and fed to the EARS object-aware
vague-response check as accepted concrete terms — so a repo's domain vocabulary
is not flagged as vague. Adds the artifact_type, frontmatter schema, skeleton.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 spec_artifacts_iso/manifest.yaml              | 31 +++++++++++++++++++
 .../schemas/glossary-frontmatter.schema.json  | 30 ++++++++++++++++++
 spec_artifacts_iso/skeletons/glossary.md      | 29 +++++++++++++++++
 3 files changed, 90 insertions(+)
 create mode 100644 spec_artifacts_iso/schemas/glossary-frontmatter.schema.json
 create mode 100644 spec_artifacts_iso/skeletons/glossary.md

diff --git a/spec_artifacts_iso/manifest.yaml b/spec_artifacts_iso/manifest.yaml
index 855e1d7..2813c6a 100644
--- a/spec_artifacts_iso/manifest.yaml
+++ b/spec_artifacts_iso/manifest.yaml
@@ -589,6 +589,37 @@ artifact_types:
           required: true
           assert:
             level: 2
+- name: Glossary
+  # FR-044: a project Ubiquitous-Language glossary. Its `## Terms` table
+  # (Term | Definition) is harvested by quire-rs and fed to the EARS
+  # object-aware vague-response check as accepted concrete terms.
+  grammar_ref: iso-spec-core
+  frontmatter_schema_ref: schemas/glossary-frontmatter.schema.json
+  defaults:
+    id_pattern: GLO-{next:03d}
+  allowed_links:
+  - references
+  - depends_on
+  examples: []
+  lint_rules_ref: []
+  body_extraction:
+    yield_pattern:
+      match:
+        terms:
+          from: section_body
+          after_heading: Terms
+          required: true
+          assert:
+            level: 2
+        terms_table:
+          from: table_row
+          under_section: Terms
+          required: true
+          assert:
+            columns:
+            - Term
+            - Definition
+            min_rows: 1
 doc_kinds:
 - spec
 object_types: []
diff --git a/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json b/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json
new file mode 100644
index 0000000..43f1911
--- /dev/null
+++ b/spec_artifacts_iso/schemas/glossary-frontmatter.schema.json
@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "id",
+    "title",
+    "type"
+  ],
+  "additionalProperties": true,
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "const": "Glossary"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "scope": {
+      "type": "string",
+      "description": "Optional: the bounded context / component this glossary serves."
+    },
+    "description": {
+      "type": "string"
+    }
+  }
+}
diff --git a/spec_artifacts_iso/skeletons/glossary.md b/spec_artifacts_iso/skeletons/glossary.md
new file mode 100644
index 0000000..c72768d
--- /dev/null
+++ b/spec_artifacts_iso/skeletons/glossary.md
@@ -0,0 +1,29 @@
+---
+id: GLO-001
+title: "Order Management Glossary"
+type: Glossary
+scope: order-management
+---
+<!-- Glossary authoring skeleton (spec-artifacts-iso, FR-044). A project's
+     Ubiquitous-Language vocabulary. Contract (manifest body_extraction
+     asserts, validated by `quire validate`):
+     - REQUIRED (level 2): Terms — a table with headers EXACTLY
+       Term | Definition, with >= 1 data row.
+     - The `Term` column is harvested by quire-rs and fed to the EARS
+       object-aware vague-response check (FR-042/043) as accepted concrete
+       terms, so a requirement that says "the system shall provide a
+       <glossary term>" is not flagged as vague.
+     - Define terms the project uses in a SPECIFIC way (ISO/IEC/IEEE 29148
+       glossary intent); common industry terms ship in the module lexicons
+       and need not be repeated here.
+     - Keep headings unique per level. -->
+# [GLO-001] Order Management Glossary
+
+## Terms
+
+| Term | Definition |
+|------|------------|
+| Place | Convert a draft order into a binding purchase request. |
+| Capture | Confirm payment for a placed order at the authorised amount. |
+| Fulfilment | The pick, pack, and ship work that completes a paid order. |
+| Cancellation window | The period during which a placed order may still be cancelled without compensation steps. |