Why this matters
Documenting security/privacy consequences in ADRs reduces risk and speeds audits.
Add a 'Security & Privacy' section in ADRs addressing threat model impacts, secrets handling, data retention, and PII processing; link to relevant runbooks and DPA if applicable.
Documenting security/privacy consequences in ADRs reduces risk and speeds audits.
Side-by-side examples engineers can pattern-match during review.
Decision to add analytics (no mention of PII or retention).Security & Privacy: No raw PII logged; use KMS-managed keys; retain events 30 days; DPA clause 4.2 referenced.## Security & Privacy
PII minimized; keys via KMS## Security & Privacy
N/AFrom the same buckets as this rule.
For changes that affect architecture, data models, external APIs, security posture, deployment topology, or cost (>10%), create an ADR in docs/adr/ using the standard template (Context, Decision, Consequences) and link the PR and issue IDs.