diff --git a/docs/markdown-content-pilot.md b/docs/markdown-content-pilot.md
new file mode 100644
index 0000000..c4c71d9
--- /dev/null
+++ b/docs/markdown-content-pilot.md
@@ -0,0 +1,24 @@
+# Markdown content pilot
+
+Branch: `markdown-content-pilot`  
+Commit: `78cfe0c`
+
+## What is being tested
+
+- Blog posts in `sites/blog/content/posts/*.md` with validated frontmatter and
+  generated detail pages.
+- Primary-site FAQ answers in `sites/www/content/faq/*.md` with rendered
+  Markdown answers.
+- `draft: true` filtering from listings, generated routes, and the sitemap.
+
+## Verified initial behavior
+
+- Three published journal entries render in the blog listing and at
+  `/posts/<slug>/`.
+- Two published FAQ entries render on the primary preview homepage.
+- The draft post and draft FAQ are absent; the draft post URL returns 404.
+- Gitea runs 136 (blog) and 137 (primary) built and deployed their respective
+  preview Workers successfully.
+
+This is still a Git-backed pilot. No CMS, client account, public editing
+surface, sign-up change, n8n change, or onboarding-worker change is included.