From 96df7285da1b1ee9178768be91d5b8e309237b36 Mon Sep 17 00:00:00 2001
From: Rongsong Shen <rshen@shenrs.eu>
Date: Fri, 29 May 2026 11:11:29 +0000
Subject: [PATCH] =?UTF-8?q?docs(ha-config-bootstrap):=20add=20path=20verif?=
 =?UTF-8?q?ication=20warning=20=E2=80=94=20config=20must=20be=20in=20workd?=
 =?UTF-8?q?ir/myname/conf/?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .kiro/specs/ha-config-bootstrap/manual-tests.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/.kiro/specs/ha-config-bootstrap/manual-tests.md b/.kiro/specs/ha-config-bootstrap/manual-tests.md
index e5d04f96..18311006 100644
--- a/.kiro/specs/ha-config-bootstrap/manual-tests.md
+++ b/.kiro/specs/ha-config-bootstrap/manual-tests.md
@@ -117,6 +117,23 @@ printf "cluster.bin.${TAG}" > "${CONF_DIR}/current"
 > Nodes B and C need **no** config pre-installed — they will receive it from
 > the primary automatically after election completes.
 
+**Verify before starting (common mistake: wrong subdirectory):**
+
+```bash
+# The path MUST include the node name as a subdirectory:
+#   {workdir}/{myname}/conf/current  ✓  /tmp/xce-a/ctrl-a/conf/current
+#   {workdir}/conf/current           ✗  /tmp/xce-a/conf/current  ← WRONG
+
+ls -la /tmp/xce-a/ctrl-a/conf/
+# Must show: current  cluster.bin.<tag>
+```
+
+If you see the files at `/tmp/xce-a/conf/` instead, move them:
+```bash
+mkdir -p /tmp/xce-a/ctrl-a/conf
+mv /tmp/xce-a/conf/* /tmp/xce-a/ctrl-a/conf/
+```
+
 ### Start the 3-node cluster (3 terminals)
 
 **Terminal 1 — Node A (priority 0 = highest):**