diff --git a/.story_kit/work/1_upcoming/217_story_scaffold_generates_claude_md.md b/.story_kit/work/1_upcoming/217_story_scaffold_generates_claude_md.md
new file mode 100644
index 0000000..e366c79
--- /dev/null
+++ b/.story_kit/work/1_upcoming/217_story_scaffold_generates_claude_md.md
@@ -0,0 +1,20 @@
+---
+name: "Scaffold generates CLAUDE.md"
+---
+
+# Story 217: Scaffold generates CLAUDE.md
+
+## User Story
+
+As a developer setting up a new project with Story Kit, I want the scaffold to generate a CLAUDE.md file with sensible defaults, so that Claude Code agents have project instructions from the start.
+
+## Acceptance Criteria
+
+- [ ] Scaffold creates a CLAUDE.md at the project root with a scaffold-template sentinel
+- [ ] CLAUDE.md includes a directive to read .story_kit/README.md for the dev process
+- [ ] Scaffold does not overwrite an existing CLAUDE.md (consistent with other scaffold files)
+- [ ] Onboarding status does not check CLAUDE.md (it is not a required onboarding step)
+
+## Out of Scope
+
+- TBD