declarative Markdown workflow layer

examples/workflows/adr-release-notes.workflow.md

@@ -0,0 +1,55 @@
+# ADR Release Notes Workflow
+
+```yaml workflow
+metadata:
+  id: adr-release-notes
+  title: ADR Release Notes
+  version: "1"
+  owner: documentation
+intent:
+  summary: Build release notes from accepted ADR decisions.
+inputs:
+  adrs:
+    glob: adrs/*.md
+    where:
+      frontmatter.status: accepted
+    extract:
+      decisions:
+        selector: sections[heading=Decision]
+      statuses:
+        selector: frontmatter.status
+steps:
+  render:
+    kind: template
+    template: templates/release-notes.md
+    data:
+      title: ADR Release Notes
+      decisions: ${sources.adrs.extracts.decisions}
+outputs:
+  release_notes:
+    path: out/release-notes.md
+    content: ${steps.render.markdown}
+permissions:
+  filesystem:
+    read: [adrs, templates]
+    write: [out]
+  network: false
+resources:
+  cpu: local
+timeouts:
+  workflow: 30s
+retry_policies:
+  default:
+    max_attempts: 1
+escalation_rules:
+  output_review:
+    when: before_publish
+    responsible: human
+observability:
+  events: [workflow.started, workflow.step.completed, workflow.output.ready]
+responsibilities:
+  agent:
+    may_run_deterministic_steps: true
+  human:
+    approves_publication: true
+```