diff --git a/CLAUDE.md b/CLAUDE.md
index 54441033..fce21827 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -52,6 +52,7 @@ Reach for these before grinding through tasks manually:
   - `Explore` for any codebase search that would take > 3 queries
   - `feature-dev:code-explorer` / `code-architect` / `code-reviewer` for new feature work
 - **Doctrine**: skills override default behavior except user instructions in this file. If a CLAUDE.md rule conflicts with a skill, this file wins.
+- **Manual UAT scaffold**: when the user starts a "manual testing" / "UAT" pass (Playwright + React Grab walkthrough), scaffold `docs/superpowers/audits/YYYY-MM-DD-manual-uat-findings.md` (append to today's if it exists) with buckets: Quick fixes (<15min), Medium (15min–2h), Features/larger (>2h), Bugs (severity-tagged), Cross-references to the active audit doc. Append findings to the matching bucket as they land in chat — don't ask for the format each time.
 
 ## Tech stack (non-obvious choices)