agentleFS
MicrosoftKnown publishermicrosoft/hve-core/.github/skills/project-planning/privacy-by-design/SKILL.md

privacy-by-design

Skill1.6k starsChanged 7 days agoMITView on GitHub

Privacy by Design (PbD) knowledge base for assessing proactive privacy practices against the 7 Foundation Principles, with data retention and disposal lifecycle checks and cross-jurisdictional mappings (GDPR, CCPA, APP).

2 other projects use a version of this.

Trending

More talk lately.about the whole repository

Dec 2025: 0 mentionsJan 2026: 0 mentionsFeb 2026: 5 mentionsMar 2026: 6 mentionsApr 2026: 2 mentionsMay 2026: 1 mentionJun 2026: 0 mentionsJul 2026: 5 mentionsAug 2026: 0 mentionsSep 2026: 1 mentionOct 2026: 5 mentionsNov 2026: 0 mentions
Dec 2025Jun 2026Nov 2026
Mentions a month of the microsoft/hve-core repository that our weekly crawl found. There is no adoption data for this file yet.

Most recently taken up by

Who's talking about microsoft/hve-core

The biggest 5 of 25 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 25

Talked about on GitHub, Hacker News and Bluesky (25 times).

On GitHub · 22

17 more on GitHub

On Hacker News · 2

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 8 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    All 7 principles have a verdict, evidence completeness, and severity (N/A when no deficiency is established).

    line 29
  2. Distinctive:

    Use when you need to:

    line 39
  3. Distinctive:

    Verify that privacy is embedded proactively (not bolted on after incidents)

    line 42
  4. Distinctive:

    Check data retention schedules, disposal methods, and legal hold procedures

    line 43
  5. Distinctive:

    Do not use for:

    line 49
  6. Distinctive:

    Stop the assessment if the system boundary cannot be established.

    line 58
  7. Distinctive:

    Stop and escalate if processing occurs in a jurisdiction not covered by this skill's mappings.

    line 59
  8. Very specific:

    Do not fabricate evidence.

    line 60
  9. Distinctive:

    Do not provide legal opinions.

    line 61
  10. Very specific:

    Do not duplicate security findings that the security-planning skill already covers.

    line 62
  11. Distinctive:

    Use these fields when capturing a finding so the reviewer can assert a stable source-control reference:

    line 102

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Privacy by Design

This SKILL.md is the entrypoint for the Privacy by Design skill.

The skill provides structured assessment references for the 7 Foundation Principles of Privacy by Design (Cavoukian, 2009). Consumers that explicitly load it can assess privacy practices across the software lifecycle. It complements privacy-standards with principle-level criteria, retention and disposal checks, regulatory mappings, a finding schema and implementation patterns. Current agent wiring is described under Integration below.

[!NOTE] This skill is a planning aid, not legal advice. Its standards summaries support privacy reasoning and review preparation; they do not substitute for qualified legal counsel or a formal regulatory interpretation.

Goal

Produce an evidence-based assessment against the 7 PbD Foundation Principles, with per-principle verdicts, explicit evidence gaps, deficiency severity, and remediation for established deficiencies. Assessment labels describe this planning rubric, not legal certification.

Success criteria

  • All 7 principles have a verdict, evidence completeness, and severity (N/A when no deficiency is established).
  • Each FAIL or PARTIAL finding includes a specific, actionable remediation.
  • Findings use the structured schema defined in finding-schema.md.
  • Cross-jurisdictional obligations are identified for the applicable regulatory scope.
  • Retention and disposal are assessed for any system that stores personal data.
  • An overall assessment verdict (COMPLIANT / PARTIALLY_COMPLIANT / NON_COMPLIANT / INCOMPLETE) is determined without treating missing evidence as a failed control.
  • Finding, principle, checklist and severity counts reconcile under the finding schema.

When to use this skill

Use when you need to:

  • Assess a system, feature, or data flow against the 7 PbD Foundation Principles
  • Verify that privacy is embedded proactively (not bolted on after incidents)
  • Check data retention schedules, disposal methods, and legal hold procedures
  • Map privacy requirements across GDPR Art. 25, CCPA/CPRA, and Australian Privacy Principles
  • Generate per-principle PASS/PARTIAL/FAIL/INSUFFICIENT_EVIDENCE results with evidence-backed severity
  • Identify code-level and configuration-level privacy patterns or anti-patterns
  • Produce backlog items from privacy assessment findings

Do not use for:

  • General privacy standards mapping without principle assessment (use privacy-standards)
  • Security threat modeling (use security-planning or OWASP skills)
  • RAI assessment (use rai-planner)
  • Legal advice or regulatory compliance certification

Stop rules

  • Stop the assessment if the system boundary cannot be established.
  • Stop and escalate if processing occurs in a jurisdiction not covered by this skill's mappings.
  • Do not fabricate evidence; record INSUFFICIENT_EVIDENCE and the evidence needed. Continue supported checks without inventing deficiency remediation for unknowns.
  • Do not provide legal opinions; frame all findings as planning guidance requiring qualified review.
  • Do not duplicate security findings that the security-planning skill already covers; cross-reference them.

Normative references (PbD 7 Foundation Principles)

  1. 00 Principle Index
  2. 01 Proactive Not Reactive
  3. 02 Privacy as the Default
  4. 03 Privacy Embedded into Design
  5. 04 Full Functionality
  6. 05 End-to-End Security
  7. 06 Visibility and Transparency
  8. 07 Respect for User Privacy

Operational references

  • Assessment Protocol — step-by-step protocol for conducting a PbD assessment
  • Finding Schema — structured output format for findings and backlog handoff
  • Implementation Patterns — pragmatic code-level and architecture-level verification patterns

Supplementary references

  • Data Retention and Disposal — Principle 05 deep-dive: retention schedules, disposal methods, legal holds
  • Cross-Jurisdictional Mapping — regulatory equivalence matrix across GDPR, CCPA/CPRA, and APP
  • Industry Privacy Profiles — sector-specific principle priorities, checks, and .pbd-config.yml customization

Skill layout

  • SKILL.md — this file (skill entrypoint).
  • references/ — the PbD normative documents, operational guides, and supplementary material.
    • 00-principle-index.md — index of all principle identifiers, categories, source mappings, and cross-references.
    • 01 through 07 — one document per PbD Foundation Principle with checklist, controls, anti-patterns, and regulatory mappings.
    • assessment-protocol.md — phased assessment protocol for agents conducting PbD reviews.
    • finding-schema.md — YAML-based finding and summary schema for structured output.
    • implementation-patterns.md — code-level and configuration-level patterns agents can verify.
    • data-retention-and-disposal.md — Principle 05 deep-dive: retention schedules, disposal methods, legal holds.
    • cross-jurisdictional-mapping.md — regulatory equivalence matrix across GDPR, CCPA/CPRA, and APP.
    • industry-privacy-profiles.md — telco, healthcare, financial sector profiles with .pbd-config.yml customization schema.

Citation-field vocabulary

Use these fields when capturing a finding so the reviewer can assert a stable source-control reference:

  • pbd_principle: Principle number (1–7) with short name, e.g., PbD-01 Proactive Not Reactive
  • gdpr_article: GDPR article reference, e.g., Art. 25
  • app_principle: Australian Privacy Principle number, e.g., APP 1
  • ccpa_section: CCPA/CPRA section reference

Finding severity conventions

SeverityMeaning
CRITICALEstablished deficiency with severe direct risk, or FAIL under an effective CRITICAL industry priority
HIGHPrinciple is violated with direct risk to data subjects
MEDIUMPrinciple is partially met; gaps exist that could lead to non-compliance
LOWMinor gap; principle intent is largely met but documentation or controls could improve
N/ANo deficiency established, including PASS and unknown-only results

Data sensitivity informs the impact of a proven deficiency; it does not create one. Preserve CRITICAL in records and summaries. CRITICAL and HIGH map to P1, with CRITICAL ordered first; MEDIUM maps to P2 and LOW to P3. PASS and unknown-only results do not create remediation backlog items.

Finding verdict conventions

VerdictMeaning
PASSAll applicable checks are MET, with no unresolved evidence or anti-patterns
PARTIALA deficiency is established but the FAIL threshold is not met
FAILMore than half of applicable checks are NOT MET, or an uncompensated critical anti-pattern is established
INSUFFICIENT_EVIDENCENo deficiency established, but unknown evidence or zero applicable checks prevents PASS

Apply the ordered rules in the assessment protocol. Record evidence completeness independently so a proven deficiency is not hidden by unknown checks. Suppressions require a documented applicability reason and do not count as MET.

Overall assessment verdicts

VerdictCondition
NON_COMPLIANTOne or more principles are FAIL; retain any evidence gaps separately
INCOMPLETENo FAIL, but any principle or applicable retention/jurisdiction check has incomplete evidence
PARTIALLY_COMPLIANTComplete evidence, no FAIL, and at least one PARTIAL
COMPLIANTComplete evidence and all 7 principles PASS

Evaluate these rows in order. Never use null for a verdict or interpret an unknown jurisdictional baseline as met or failed.

Integration with Privacy Planner and Reviewer

This skill complements privacy-standards (which provides the NIST PF, GDPR, CCPA, OWASP backbone). A consumer performing PbD assessment should explicitly load both:

  • privacy-standards — standards mapping, data-flow reasoning, DPIA thresholds
  • privacy-by-design — principle-level assessment, retention/disposal checks, cross-jurisdictional equivalence, implementation pattern verification

The current Privacy Planner and Privacy Reviewer do not explicitly load privacy-by-design. This skill supplies assessment knowledge, not automatic integration; dedicated agent wiring is outside this skill change. It remains background-only (user-invocable: false).

Interaction with other skills

SkillRelationship
privacy-standardsProvides data inventory, DPIA thresholds, and standards backbone; PbD builds on top
security-planningSecurity controls overlap with PbD-05; reference rather than duplicate
rai-plannerRAI data-use concerns feed into PbD-04 (full functionality) and PbD-07 (user respect)
secure-by-designSBD-11 (Secure Deprecation) aligns with PbD-05 lifecycle; cross-reference for decommissioning

Attribution and licensing posture

SKILL.md and references/ contain original assessment guidance and paraphrased summaries under CC BY 4.0. The cited publications remain authoritative and retain their own rights; this license does not relicense upstream text. Principle names and legal identifiers are preserved for traceability. No upstream document is reproduced or bundled.

Cavoukian PbD Foundation Principles

  • Author: Dr. Ann Cavoukian, Information and Privacy Commissioner of Ontario
  • Source: https://www.ipc.on.ca/sites/default/files/legacy/2018/01/pbd.pdf
  • Modifications: Principles restructured into agent-consumable assessment checklists with cross-references to GDPR, CCPA, and APP; original principle text paraphrased with attribution
  • Note: The 7 Foundation Principles are widely referenced in academic and regulatory literature; content here is paraphrased for planning use

GDPR Art. 25 (Data Protection by Design and by Default)

Australian Privacy Principles (APP)

CCPA/CPRA

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.