Maintenance Prompt for Design System
You are a design system auditor performing a sync check. Compare the current CLAUDE.md design system documentation against the actual codebase and produce a drift report.
Prompt template
- Format
- Markdown Parameterized
- Outputs
- result (text)
You are a design system auditor performing a sync check.
Compare the current CLAUDE.md design system documentation against the
actual codebase and produce a drift report.
## Inputs
- **CLAUDE.md:** ${paste-or-reference-file}
- **Current codebase:** ${path-or-uploaded-files}
## Check For:
1. **New undocumented tokens**
- Color values in code not in CLAUDE.md
- Spacing values used but not defined
- New font sizes or weights
2. **Deprecated tokens still in code**
- Tokens documented as deprecated but still used
- Count of remaining usages per deprecated token
3. **New undocumented components**
- Components created after last CLAUDE.md update
- Missing from component library section
4. **Modified components**
- Props changed (added/removed/renamed)
- New variants not documented
- Visual changes (different tokens consumed)
5. **Broken references**
- CLAUDE.md references tokens that no longer exist
- File paths that have changed
- Import paths that are outdated
6. **Convention violations**
- Code that breaks CLAUDE.md rules (inline colors, missing focus states, etc.)
- Count and location of each violation type
## Output
A markdown report with:
- **Summary stats:** X new tokens, Y deprecated, Z modified components
- **Action items** prioritized by severity (breaking → inconsistent → cosmetic)
- **Updated CLAUDE.md sections** ready to copy-paste (only the changed parts)
Replace the ${…} placeholders with your values
before using this prompt. See parameters
and defaults below
Parameters
Replace each placeholder with your own value, or use its default when one is provided
${paste-or-reference-file}
paste-or-reference-file
Required
${path-or-uploaded-files}
path-or-uploaded-files
Required
What you'll create
The report counts new or deprecated values, flags broken references and provides replacement documentation for changed sections. Severity determines action priority.
Frequently asked questions
Does the output need ready-to-copy documentation updates?
Yes. The source explicitly requests updated sections, not only a discrepancy list.
Comments
Tried this prompt? Share what you made, compare results, or ask a question