spa-day

name	spa-day
description	Audit rules and skills for semantic contradictions, redundancy, and staleness, then interactively resolve with the user. Use periodically when agent performance degrades or after adding many rules/skills.
version	1.0.1
level	advanced
category	meta

Spa Day

Periodic health audit for your rules and skills. Finds contradictions, redundancies, dead references, and oversized files, then walks you through resolving each one interactively.

Constraints

• Read gotchas.md before starting
• NEVER modify files without explicit user approval for each change
• Read-heavy, write-light — most work is analysis
• Do NOT load all files upfront — read progressively as needed
• Stateless — no config, no logs, ask scope each time
• Use AskUserQuestion tool for ALL user interactions — never just print a question and wait

---

Phase 0 — Determine Scope

Use AskUserQuestion to ask the user what to audit. Options:

• Global only (~/.claude/)
• Project only (.claude/)
• Both

Then scan the chosen locations:

• CLAUDE.md
• rules/**/*.md
• skills/*/SKILL.md

Build an inventory table: file path, purpose (first line or heading), line count.

---

Phase 1 — Contradiction Detection

Read references/contradiction-patterns.md for the 6 pattern types to check.

Cross-reference all inventoried files for:

• Direct contradictions (rule A says X, rule B says NOT X)
• Implicit conflicts (skill uses approach A, rule bans approach A)
• Scope overlaps (global and project say opposite things)
• Stale references (CLAUDE.md points to files that don't exist)

---

Phase 2 — Redundancy Detection

Scan for:

• Duplicate or near-duplicate directives across files
• Rules that are subsets of other rules
• Skills with overlapping descriptions (false trigger risk)
• Gotchas that restate existing rules

---

Phase 3 — Health Report

Read references/health-metrics.md for thresholds. Present a report covering:

• Total files, total lines
• Contradictions found (with evidence: quotes from both files)
• Redundancies found (with both locations)
• Oversized files exceeding thresholds
• Dead references
• Recommendation per finding: consolidate / split / delete / update ref

See examples/ for concrete report samples.

If no issues found: "All healthy. No contradictions or redundancies found." and stop.

---

Phase 4 — Interactive Resolution

For each finding, use AskUserQuestion to present the issue with evidence and ask for an action:

• Rewrite — edit the conflicting file(s) to resolve
• Delete — remove the redundant file
• Merge — combine files covering the same concern
• Update refs — fix CLAUDE.md pointers
• Skip — defer this item, no action now

Consolidation guidance:

• When merging: keep the more specific/recent version
• When splitting: extract if a file covers >2 unrelated concerns
• When deleting: verify nothing references it first
• Global vs project conflict: project-level wins (intentional override)

---

Phase 5 — Summary

Print before/after metrics: file count, total lines, changes made. Suggest running /context-budget for token impact verification.