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| Variable | What to enter | Example | Default |
|---|---|---|---|
| {{design_docs}} | Paste the design system documentation | Colors: 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 all | Colors and buttons | — |
| {{governance}} | Who looks after the design system and how changes get decided | One designer owns it; changes agreed in a fortnightly design review | — |
Try it
Live previewPaste 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.
0 forks
Public forks of “Design system documentation drift report” by Prompier Library (v1).
Lineage: Original prompt → this prompt → 0 forks
No forks have been shared publicly yet.