diff --git a/README.md b/README.md
index da57a32..15b7631 100644
--- a/README.md
+++ b/README.md
@@ -38,9 +38,11 @@ You are welcome to still raise bugs in this repo.
 * [pages](pages): solutions for Pages workflows
 * [icons](icons): svg icons for the relevant template
 
-Each workflow must be written in YAML and have a `.yml` extension. They also need a corresponding `.properties.json` file that contains extra metadata about the workflow (this is displayed in the GitHub.com UI).
+Starter workflow templates in this repository need a corresponding `.properties.json` file that contains extra metadata about the workflow (this is displayed in the GitHub.com UI).
 
-For example: `ci/django.yml` and `ci/properties/django.properties.json`.
+Most starter workflows are written in YAML and use a `.yml` extension. Agentic starter workflows in [agentic](agentic) are authored as Markdown templates with YAML frontmatter and use a `.md` extension.
+
+For example: `ci/django.yml` and `ci/properties/django.properties.json`, or `agentic/daily-plan.md` and `agentic/properties/daily-plan.properties.json`.
 
 ### Valid properties