docs(audit): start active-uat.md as the persistent live findings doc
Every UAT finding the user surfaces during a live walkthrough now lands in docs/superpowers/audits/active-uat.md regardless of which session captured it. Persists across sessions until the user explicitly says to wrap a round and archive (rename to YYYY-MM-DD-uat.md, start fresh). CLAUDE.md's "Manual UAT" guidance updated to point at the new file + documents the status-tag taxonomy and the append-protocol detail level (file:line, React-grab anchor, root cause, fix proposal walking each layer, effort estimate, alternatives + rejection reasons, open questions, bundle-with notes, cross-refs, acceptance criteria). Historical alpha-uat-master.md retained as the previous master through 2026-05-26. This commit seeds the doc with the full body of findings captured during this live session — Documenso reliability work, dialog width sweep, recipient UX, recommender card polish, tenancy + notes plumbing, the larger Documenso upload audit and Automate Signing feature specs. Each entry follows the detail contract documented in the file footer. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -57,7 +57,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 — single master doc**: all multi-day Playwright + React Grab UAT findings go into `docs/superpowers/audits/alpha-uat-master.md` (the cross-cutting "alpha" audit that spans many sessions). Append to it as findings land in chat — don't create per-day files. Buckets: Quick fixes (<15min), Medium (15min–2h), Features/larger (>2h), Bugs (severity-tagged), Cross-references to the active full-codebase audit. Don't ask for the format each time.
|
||||
- **Manual UAT — currently active doc**: `docs/superpowers/audits/active-uat.md` is the **live** findings doc. Every UAT finding the user surfaces in chat lands here regardless of which session captures it. Persists across sessions until the user explicitly says to wrap the round and archive — at which point rename to `YYYY-MM-DD-uat.md` and start a fresh `active-uat.md`. Buckets: Quick fixes (<15min), Medium (15min–2h), Features/larger (>2h), Bugs (severity-tagged). Tag every entry with status: `OPEN | IN PROGRESS | SHIPPED in <hash> | QUEUED | BLOCKED`. Don't ask the format each time. Historical: `alpha-uat-master.md` was the previous master through 2026-05-26 drain.
|
||||
|
||||
## Tech stack (non-obvious choices)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user