From f35cd61e2ddce944ac709ba550aab1d7ebed0d4c Mon Sep 17 00:00:00 2001
From: Willem van den Ende <willem@qwan.eu>
Date: Tue, 30 Jun 2026 22:28:21 +0200
Subject: [PATCH] explain where the skills are

---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

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
+```
+
+