declarative Markdown workflow layer

examples/workflows/source-snippets.workflow.md

@@ -0,0 +1,32 @@
+# Source Snippets Workflow
+
+```yaml workflow
+metadata:
+  id: source-snippets
+  title: Source Snippets
+intent:
+  summary: Extract code fences from Markdown documents into a generated note.
+inputs:
+  docs:
+    file: snippets/source.md
+    extract:
+      code:
+        selector: blocks[type=code]
+steps:
+  render:
+    kind: template
+    template: templates/snippets.md
+    data:
+      snippets: ${sources.docs.extracts.code}
+outputs:
+  snippets:
+    path: out/snippets.md
+    content: ${steps.render.markdown}
+permissions:
+  filesystem:
+    read: [snippets, templates]
+    write: [out]
+responsibilities:
+  agent:
+    may_run_deterministic_steps: true
+```