From 24696e79d0e02792c87c6e3fe4827976af2bd506 Mon Sep 17 00:00:00 2001 From: reachableceo Date: Tue, 11 Aug 2026 21:41:47 -0500 Subject: [PATCH] docs(agents): add mandatory UAT rule + fix .crush prune in check-rules MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - UAT rule: user must accept work before done-ratio 100% or close - check-rules.sh: prune .crush/ from Discourse pointer scan (agent working space, not documentation) 💘 Generated with Crush Assisted-by: Crush:glm-5.2 --- AGENTS.md | 7 +++++++ scripts/check-rules.sh | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index ee5bac6..47aaa36 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -46,6 +46,13 @@ There are no exceptions to this rule.** it's ambiguous whether the work is truly complete, don't suggest a close — leave that decision to the user. This applies to ALL tickets, no exceptions. +8. **User acceptance testing is MANDATORY before declaring work done.** + The agent performs implementation and technical validation (services + running, configs correct, APIs responding). The user performs UAT — + visually confirming dashboards render data, alerts deliver, tools are + usable. The agent MUST NOT set done-ratio to 100%, MUST NOT suggest + closing, and MUST NOT move to the next ticket until the user explicitly + accepts the work. "Technically wired but blank dashboard" is NOT done. ### Access-channel policy: SSH only (NON-NEGOTIABLE) diff --git a/scripts/check-rules.sh b/scripts/check-rules.sh index a96fae2..57336c5 100755 --- a/scripts/check-rules.sh +++ b/scripts/check-rules.sh @@ -157,7 +157,7 @@ while IFS= read -r -d '' f; do POINTER_MISSING=$((POINTER_MISSING + 1)) $RULE_VERBOSE && printf ' %s\n' "$f" fi -done < <(find . -path ./.git -prune -o -path ./.tmp -prune -o -path ./vendor -prune -o -path ./archive -prune -o -name '*.md' -print0 2>/dev/null) +done < <(find . -path ./.git -prune -o -path ./.crush -prune -o -path ./.tmp -prune -o -path ./vendor -prune -o -path ./archive -prune -o -name '*.md' -print0 2>/dev/null) if [ "$POINTER_MISSING" -eq 0 ]; then check "All non-exempt .md cite Discourse ($DISCOURSE_HOST)" "pass" else