diff --git a/docs/hackathon/README.md b/docs/hackathon/README.md
new file mode 100644
index 0000000..60db7f6
--- /dev/null
+++ b/docs/hackathon/README.md
@@ -0,0 +1,11 @@
+# OpenStudio MCP — Hackathon Guide
+
+> **Work in progress.** This directory will contain:
+>
+> - Sample prompts and expected outputs for hackathon participants
+> - Use case ideas for LLM + building energy modeling workflows
+> - Web app concept pitch (SPA with sliders → OpenStudio simulation)
+> - Recommendation to use CLI clients (Claude Code, Gemini CLI) for efficiency
+> - Tips on plan mode, context window management, and working fast
+
+See [`docs/examples/`](../examples/) for existing workflow walkthroughs.