diff --git a/README.md b/README.md
index c6f6d0f..5f7ec64 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,25 @@
 # Vending Machine C# - Test Driven Development exercise with agent skills
 
+See AGENTS.md or CLAUDE.md (same contents, symlinked) for agent instructions.
+
+User stories are in stories/ . They are an invitation for communication - as Ron Jeffries says: "Card, Conversation, Confirmation".
+
+Agent skills are in:
+
+```
+.claude/skills
+├── task-breakdown
+│   └── SKILL.md
+├── task-execution
+│   └── SKILL.md
+├── tdd-minimalism
+│   └── SKILL.md
+├── tdd-test-refactoring
+│   └── SKILL.md
+├── test-focus-isolation
+│   └── SKILL.md
+└── testcase-common-setup
+    └── SKILL.md
+```
+
+