A prompt library audit should make the collection smaller, clearer, and easier to trust. The goal is not to rewrite every file. It is to remove ambiguity about which prompts still deserve to be used.
You can make meaningful progress in thirty minutes if you focus on high-use and high-confusion areas first.
Minute 0 to 5: find the noisy area
Choose one folder, tag, or search term that returns too many similar results. Do not audit the entire library at once.
Good starting points include:
- several prompts with
final,v2, ornewin the title - prompts for the same recurring meeting or report
- a category you search often but rarely trust
- files with no description
Write down the job the winning prompt should perform. That becomes the standard for the rest of the audit.
Minute 5 to 12: group likely duplicates
Prompts are duplicates when they compete for the same decision, not only when their wording matches.
Place candidates into three groups:
- exact duplicates: same task and instructions
- competing variants: same task, meaningful differences
- neighbors: related task, different output or audience
Keep neighbors separate. They need clearer titles, not forced consolidation.
Minute 12 to 20: choose the trusted version
For each duplicate group, compare:
- Is the task stated clearly?
- Are required inputs explicit?
- Does the output contract match the real workflow?
- Does the prompt depend on hidden chat context?
- Has anyone used this version successfully?
Keep the version that is easiest to explain and test. Move any useful instruction from the losing variants into the winner only when it serves the same task.
Avoid creating a giant combined prompt. A shorter trusted version is better than a merger that preserves every historical idea.
Minute 20 to 25: repair retrieval
Rename the winner by job and add a description that distinguishes it from nearby prompts.
Title: Review product brief for decision gaps
Description: Use before roadmap review. Checks audience, evidence, constraints,
and unresolved decisions. Use the launch-readiness prompt after scope is approved.
Update broad folders or labels only if the current location repeatedly causes confusion. One audit is not a reason to redesign the whole taxonomy.
Minute 25 to 30: retire safely
Remove exact duplicates. Archive a variant when its history may still matter. Add a short note if another person might wonder where it went.
Before deleting files, confirm that your backup or version history can recover them. Do not use an archive as a second active library; archived prompts should disappear from normal retrieval.
Record four outcomes
Every reviewed prompt should end in one of four states:
- keep
- merge
- rewrite
- retire
That small vocabulary makes the next audit easier and prevents “reviewed” from becoming another vague label.
Promptlight can help you search the vault, compare nearby Markdown files, reveal a source file in Finder, and favorite the version you use most. It does not automatically identify semantic duplicates or choose the winner. The audit decision stays with the person who understands the workflow.
For a broader structure, use How To Organize Your Prompt Vault, then test the cleaned library with Prompt Search for Mac. If the winning prompt is still hard to understand, continue with When To Rewrite a Prompt.



