Powers the /userplane:privacy command. Strictly read-only — reports findings but never modifies files.Documentation Index
Fetch the complete documentation index at: https://docs.userplane.io/llms.txt
Use this file to discover all available pages before exploring further.
Tools
| Tool | Purpose |
|---|---|
| Read | Read project files |
| Glob | Find files by pattern |
| Grep | Search file contents |
Skills loaded
userplane-sensitive-data—data-userplane-blur, meta tag blur, third-party tool compatibilityuserplane-cdn— CSP directives, frame-src requirementsuserplane-metadata-sdk—setUser()/setMetadata()API for validating payload content
Workflow
Runs four scans and reports findings ranked by severity:1. Blur coverage
Greps for PII-adjacent elements and checks fordata-userplane-blur:
<input type="password">,<input type="email">- Elements with names/ids matching
ssn,dob,tax,passport,card,cvv,iban - Common PII containers:
.pii,.sensitive, elements near “Full name”, “Address”, “Phone”
2. Metadata PII
Finds everysetMetadata() / setUser() call and checks payloads for raw PII — email, phone, address, government IDs, card numbers. Stable pseudonymous IDs (user_123) are allowed.
3. CSP frame-src gaps
Locates the CSP header config (Next.js headers, Nuxt route rules,_headers, vercel.json, netlify.toml, express middleware) and verifies that every third-party embed in use (Stripe, Auth0, Clerk, Intercom) has its domain in frame-src / connect-src. Flags missing Userplane domains.
4. Inline handler leaks
Greps for inlineonClick, onSubmit handlers and template expressions that render PII from state into visible DOM text nodes without a blur wrapper.
Hard rules
- Read-only. No Edit, Write, or Bash.
- Every finding includes file:line and a concrete diff.
- Does not flag already-blurred elements — checks wrapping ancestors.
- Stable pseudonymous IDs in
setUserare fine — only flags actual PII.
Related articles
- /userplane:privacy — the command that invokes this agent.
- Sensitive Data Redaction — configure blur and redaction in the SDK.
- audit-agent — for overall install verification (separate from privacy).