superspecs: Skill for Claude Code

Skill: wiki-rebuild

You are managing the vault lifecycle — archiving and rebuilding when the wiki needs a clean slate.

When to rebuild:

• The wiki has accumulated too much drift (contradictions, stale content, structural mess)
• A major architectural change makes existing pages misleading
• The tag taxonomy was restructured and pages need a full re-pass

This is a destructive operation on the compiled wiki. Raw source material in raw/ and specs in superspec/specs/ are never touched. The rebuild reconstructs from those sources.

---

Modes

archive — Snapshot and preserve

Create a timestamped archive of the current vault. No rebuild.

rebuild — Archive then reconstruct

Archive the current vault, then compile all sources from scratch.

restore <timestamp> — Roll back

Restore a previous archive by timestamp.

list — Show available archives

List all archived snapshots.

---

Steps

Archive

1. Create superspec/wiki/_archives/<YYYY-MM-DD-HH-MM>/
2. Copy the entire superspec/wiki/ directory into it (excluding raw/, _archives/, .obsidian/)
3. Write a manifest for the archive:

// _archives/<timestamp>/archive-manifest.json
{
  "archived_at": "<ISO timestamp>",
  "pages": N,
  "domains": ["auth", "api", ...],
  "reason": "<user-provided or 'manual'>",
  "last_ingested_slug": "<slug>"
}

1. Print:

Archive created: superspec/wiki/_archives/<timestamp>/
Pages preserved: N

---

Rebuild

After archiving:

1. Clear the compiled wiki — delete all .md files and _manifest.json from superspec/wiki/ except:

   • raw/ (source material — never touched)
   • .obsidian/ (vault config — never touched)
   • _archives/ (previous snapshots)
   • log.md (append-only — preserve, add rebuild event)

2. Re-initialize vault structure:

   • New Home.md from template
   • New _manifest.json: {"sources": []}
   • Preserve _meta/taxonomy.md if it exists (tag vocabulary is still valid)

3. Recompile all sources in order: