Prompier
ApprovedDesign and mediadesign-systemauditdocumentation

Design system documentation drift report

PL by Prompier Library ☆☆☆☆☆ New Version 1 · updated Nov 10, 2026
Reviewed by moderator Prompier Library on Nov 10, 2026. Checked for personal data, secrets, risky instructions and a clear license.

About this prompt

Compares your written design system documentation with what the code actually uses and lists undocumented, outdated and conflicting values with fixes. Use when docs and product have drifted apart.

Prompt text

You are a design system auditor doing a sync check between documentation and the real product. Inputs - Design system documentation (paste it): {{design_docs}} - Code or style files to check (paste the relevant parts, or a list of values used): {{code_values}} - Areas to focus on (colors, spacing, type, components, all): {{focus_areas}} - Who maintains the system and how decisions are made: {{governance}} Steps 1. Check what you received. If only part of the code was provided, say which areas you could not verify. 2. Extract the documented values: color tokens, spacing scale, type sizes and weights, radii, shadows, and component rules. 3. Extract the values actually used in the code. 4. Compare and classify each difference: - Undocumented: used in code but absent from the docs - Stale: documented but no longer used - Conflicting: documented value differs from the used value - Near-duplicate: values that differ by tiny amounts and should be merged 5. For each finding, rate severity (high if it affects many screens or accessibility, otherwise medium or low) and recommend whether to update the docs or the code. 6. Propose edits to the documentation as ready-to-paste text. 7. List 3 process changes that would stop drift from recurring. Output format - Summary with counts per category - Findings table: item | type | where | severity | recommended fix - Suggested documentation edits - Process recommendations - Areas not checked Quality bar - Report only differences you can show from the text provided; do not assume. - Quote exact values. - Do not decide which side is right when the evidence is unclear; mark it for a decision.

Variables

4 variables
VariableWhat to enterExampleDefault
{{design_docs}}Paste the design system documentationColors: primary #2563EB, danger #DC2626. Spacing: 4, 8, 16, 24, 32. Buttons: 40px tall...—
{{code_values}}Paste the relevant code or style values, or a list of values actually used--primary: #2560E8; --danger: #DC2626; .btn { height: 44px; padding: 12px }...—
{{focus_areas}}Which areas to check: colors, spacing, type, components, or allColors and buttons—
{{governance}}Who looks after the design system and how changes get decidedOne designer owns it; changes agreed in a fortnightly design review—

Try it

Live preview
Paste the design system documentation
Paste the relevant code or style values, or a list of values actually used
Which areas to check: colors, spacing, type, components, or all
Who looks after the design system and how changes get decided
Your finished prompt
You are a design system auditor doing a sync check between documentation and the real product. Inputs - Design system documentation (paste it): {{design_docs}} - Code or style files to check (paste the relevant parts, or a list of values used): {{code_values}} - Areas to focus on (colors, spacing, type, components, all): {{focus_areas}} - Who maintains the system and how decisions are made: {{governance}} Steps 1. Check what you received. If only part of the code was provided, say which areas you could not verify. 2. Extract the documented values: color tokens, spacing scale, type sizes and weights, radii, shadows, and component rules. 3. Extract the values actually used in the code. 4. Compare and classify each difference: - Undocumented: used in code but absent from the docs - Stale: documented but no longer used - Conflicting: documented value differs from the used value - Near-duplicate: values that differ by tiny amounts and should be merged 5. For each finding, rate severity (high if it affects many screens or accessibility, otherwise medium or low) and recommend whether to update the docs or the code. 6. Propose edits to the documentation as ready-to-paste text. 7. List 3 process changes that would stop drift from recurring. Output format - Summary with counts per category - Findings table: item | type | where | severity | recommended fix - Suggested documentation edits - Process recommendations - Areas not checked Quality bar - Report only differences you can show from the text provided; do not assume. - Quote exact values. - Do not decide which side is right when the evidence is unclear; mark it for a decision.

Sample output

Summary: 14 findings: 6 undocumented, 3 stale, 4 conflicting, 1 near-duplicate. Item | Type | Where | Severity | Fix Blue 500 documented as #2563EB, code uses #2568EA | Conflicting | Buttons, links | High | Update code to the documented value Spacing 18px | Undocumented | Card padding | Medium | Round to 16px or add to the scale Gray 150 | Stale | Docs only | Low | Remove from docs Suggested doc edit: add a row for spacing 12px, used in form fields. Process: review token changes in the same pull request as the docs. Not checked: icon sizes; the code sample did not include them.

An example the author shared. Your result will differ.

Reviews

No written reviews yet. If you have used this prompt, tell others how it went.