sota-api-design
State-of-the-art API design and audit guidance (2026) covering REST/HTTP, GraphQL, gRPC, WebSockets/SSE/realtime, webhooks,…
State-of-the-art privacy and compliance engineering guidance for building privacy-respecting systems and auditing existing code for privacy/compliance gaps. Use when work involves privacy, GDPR, PII, personal data, consent, data retention, deletion, DSAR (data subject access
Claude Code
$ npx -y skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance --agent claude-code
Codex
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a codex -y
Cursor
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a cursor -y
Gemini CLI
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a gemini-cli -y
GitHub Copilot
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a github-copilot -y
OpenCode
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a opencode -y
Windsurf
$ npx skills add martinholovsky/SOTA-skills --skill sota-privacy-compliance -a windsurf -y
name: sota-privacy-compliance description: State-of-the-art privacy and compliance engineering guidance for building privacy-respecting systems and auditing existing code for privacy/compliance gaps. Use when work involves privacy, GDPR, PII, personal data, consent, data retention, deletion, DSAR (data subject access requests), SOC 2, ISO 27001, HIPAA, PCI DSS, compliance evidence, data residency/sovereignty, data classification, anonymization/pseudonymization, breach notification, or EU AI Act obligations — whether designing new data flows, implementing user-rights features (export/delete), preparing for an audit, or reviewing a codebase for places personal data is over-collected, under-protected, retained forever, or impossible to delete.
Engineering-facing privacy and compliance architecture: how to design, build, and audit systems so that data protection is a property of the code and infrastructure, not a binder of policy documents. Compliance that lives in schemas, TTLs, IAM policies, and CI checks survives staff turnover and audit scrutiny; compliance that lives in wiki pages does not.
> **This is engineering guidance, not legal advice.** Regulations change, vary by > jurisdiction, and turn on facts about your business that code review cannot see. > Regulatory facts below were verified against primary sources as of June 2026 — > re-verify deadlines and statuses before relying on them, and route legal > interpretation (lawful basis selection, contract terms, breach reportability > decisions) to qualified counsel or your DPO. This skill tells you how to build > the machinery those decisions require.
**Related skills — reference, don't duplicate:**
When designing or implementing systems that touch personal data:
1. **Inventory first.** Before writing a schema or integrating a vendor, classify every field you intend to collect and record where it flows ([rules/01](rules/01-data-inventory-classification.md)). The cheapest control is the field you never store. 2. **Annotate at the source.** Schemas, structs, and API contracts carry classification and purpose annotations; tooling derives the data map from code, not the other way around ([rules/01](rules/01-data-inventory-classification.md), [rules/02](rules/02-privacy-by-design.md)). 3. **Build user rights as features, not afterthoughts.** Export, deletion, and consent are product capabilities with APIs, state machines, and tests — design them with the first table, because retrofitting deletion into a 200-table schema with denormalized copies is a quarter-long project ([rules/03](rules/03-consent-and-user-rights.md)). 4. **Automate retention.** Every datastore gets a TTL, lifecycle rule, or partition-drop schedule at creation time. "We'll clean it up later" is how seven-year-old PII ends up in a breach disclosure ([rules/03](rules/03-consent-and-user-rights.md)). 5. **Emit evidence as a byproduct.** Access reviews, change approvals, and config baselines should fall out of normal engineering workflow (PRs, IaC, IdP logs) so audits are queries, not scrambles ([rules/05](rules/05-audit-ready-engineering.md)). 6. **Know your regimes.** Check [rules/04](rules/04-regulatory-landscape.md) for which regulations the system triggers (data types × subjects' locations × sector) before architecture freezes — data residency and breach-clock requirements shape topology.
**Coverage:** every `rules/` file's Audit checklist applies in AUDIT mode. Mark one *not applicable* only with its reason in the report — never skip a file because the thing it checks for is absent, since that absence may be the finding.
When reviewing an existing codebase/infrastructure for privacy and compliance gaps:
**Process:** (1) Build or obtain the data inventory — grep schemas, API payloads, log statements, analytics events, object storage for personal data ([rules/01](rules/01-data-inventory-classification.md) has discovery patterns). (2) Trace lifecycle per data category: collection → purpose → storage → sharing → retention → deletion. (3) Test user rights paths end-to-end (does deletion actually propagate?). (4) Check evidence trails for auditable controls. (5) Map findings to applicable regimes ([rules/04](rules/04-regulatory-landscape.md)).
**Severity conventions:**
| Severity | Meaning | Examples | |---|---|---| | CRITICAL | Active violation with regulatory/breach exposure; fix now | PII in world-readable bucket; deletion endpoint that doesn't delete; special-category data collected without any consent record; cardholder PANs stored unencrypted in app DB | | HIGH | Violation likely under normal operation or on first DSAR/audit/breach | No deletion propagation to backups/analytics; consent not versioned or not propagated to processors; no retention enforcement anywhere; PII in logs shipped to third party without DPA | | MEDIUM | Gap that degrades posture or audit readiness | Classification annotations missing; data map stale/manual; soft-delete only with no purge job; access reviews manual and undocumented | | LOW | Hardening/hygiene | Cookie banner lacks granular toggles; export format not machine-readable; missing purpose comments on schema fields
Make your AI coding assistant build and audit like your most senior engineer. Your assistant is brilliant — it just doesn't know your standards, and it forgets the ones it does know as the task grows long.
State-of-the-art API design and audit guidance (2026) covering REST/HTTP, GraphQL, gRPC, WebSockets/SSE/realtime, webhooks,…
State-of-the-art software and system architecture rules (2026) for both building and auditing. Use when designing, building,…
State-of-the-art rules for writing and auditing asynchronous and concurrent code across runtimes (Python asyncio, JS/Node, Go,…
State-of-the-art C and C++ engineering rules that Claude applies when writing or auditing C/C++. Covers modern idioms (RAII,…
State-of-the-art CLI and developer-tool UX guidance (2026) covering command and flag design, output and interaction…
State-of-the-art cloud infrastructure architecture (2026). Applies when designing, building, or auditing cloud environments on…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.