Contract framework with markdown-native contracts utilizing fenced YAML blocks

examples/contracts/concept-note.contract.md

@@ -0,0 +1,43 @@
+---
+title: Concept Note Contract
+version: "0.1"
+---
+
+# Concept Note Contract
+
+```yaml contract
+id: concept-note-contract-v1
+document:
+  type: concept-note
+fields:
+  concept_id:
+    type: string
+    required: true
+  status:
+    type: string
+    required: true
+    enum: [draft, reviewed, accepted, archived]
+sections:
+  - id: definition
+    title: Definition
+    presence: required
+    level: 2
+  - id: assertions
+    title: Assertions
+    presence: required
+    level: 2
+    assertions:
+      - id: assertions-use-claims
+        contains_any: [claim, evidence, assumption]
+        severity: warning
+  - id: relationships
+    title: Relationships
+    presence: recommended
+    level: 2
+metrics:
+  document:
+    words:
+      min: 120
+      max: 1200
+      severity: warning
+```