From c1622efb4138f44db6c19d0527a058d3ce495a34 Mon Sep 17 00:00:00 2001
From: Agent <agent@Martys-Mac-mini.local>
Date: Mon, 16 Mar 2026 23:24:22 +0000
Subject: [PATCH] docs: add acceptance test instructions

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

diff --git a/README.md b/README.md
index fae0f8d..bc9a8ab 100644
--- a/README.md
+++ b/README.md
@@ -115,6 +115,20 @@ What the tests cover (high level):
 Notes:
 - Socket-based tests use `/tmp` to keep Unix-domain-socket paths under the `sockaddr_un` limit.
 
+### Acceptance / smoke tests
+
+Location:
+- `scripts/acceptance-tests.sh`
+
+Run locally:
+
+```bash
+./scripts/acceptance-tests.sh
+```
+
+What they cover (high level):
+- `gitw` fails closed when `--as <alias>` is missing.
+
 ## Usage
 
 ### 1) Login (store a PAT in Keychain)