From superpowers-plus
Orchestrates a 7-phase full-wiki refactor: discovery, deduplication, information architecture, writing plan, progressive rewrite, quality metrics, and safe delivery. Enforces PRD protection and human checkpoints.
How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers-plus:wiki-refactorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Full-wiki refactor: eliminate duplication, improve IA, elevate prose quality.
Full-wiki refactor: eliminate duplication, improve IA, elevate prose quality.
HARD gate with 3 PRD checkpoints and a human checkpoint after Phase 4.
Wrong skill? Single-page edit → wiki-orchestrator · Content coherence →
wiki-content-coherence · Link check → link-verification. Background:
rationale.md.
refactor wiki, wiki overhaul, reorganize wiki pages, wiki:refactor, reorganize all wiki pageswiki-orchestrator · Page-level coherence → wiki-content-coherenceDetect PRD pages (case-insensitive): filename/title contains PRD; body H1/H2
exactly PRD; body header Product Requirements Document; or operator include
list. Detection → HALT. Operator must re-invoke with PRDs scoped out.
| Checkpoint | When | Action |
|---|---|---|
| PRD-1 | After Phase 1 inventory | Quarantine matches in prd-quarantine-list |
| PRD-2 | Before every Phase 5 write | Match quarantine → HALT |
| PRD-3 | After Phase 7 diff | Any PRD in changeset → HALT |
: "${WIKI_SEED_URL:?}"
git checkout -b "feat/wiki-refactor-$(date +%F)"
mkdir -p wiki-refactor-artifacts
| # | Phase | Runbook | Output |
|---|---|---|---|
| 1 | Discovery — crawl descendants, snapshot content | phase-1-discovery.md | wiki-inventory.md |
| 2 | Deduplication — analyze duplication patterns | phase-2-deduplication.md | dedup-analysis.md |
| 3 | Information Architecture — new structure | phase-3-information-architecture.md | new-wiki-structure.md |
| 4 | Writing plan — source→target page map | phase-4-writing-plan.md | wiki-writing-plan.md |
| 5 | Rewrite + 3-round progressive review | phase-5-rewrite-and-review.md | refactored-wiki/*.md |
| 6 | Quality metrics | phase-6-quality-metrics.md | wiki-refactor-report.md |
| 7 | Safe delivery — branch, migration guide, final checks | phase-7-safe-delivery.md | Ready-to-merge branch |
100 pages OR >50k words → warn operator + require confirmation. Zero pages → abort with "wiki unreachable or empty." PRD-1 runs on the full inventory.
Present wiki-writing-plan.md (pages to rewrite / merge / delete / create,
word-count delta, PRD quarantine list). Do not proceed to Phase 5 without
explicit operator approval.
For each target page, before invoking tools/wiki-write.sh:
progressive-harsh-review)node tools/wiki-markdown-validate.js)tools/wiki-write.sh update --doc $ID --content page.md (exit 0 or halt)wiki/ on the feature branchuse-skill link-verification (exit 0 required) and use-skill wiki-secret-audit (empty findings)| Symptom | Cause | Response |
|---|---|---|
| PRD checkpoint fires | PRD in rewrite scope | HALT — no recovery path |
| Phase 1 returns zero pages | Bad URL, auth, empty wiki | Abort with diagnostic |
| Phase 2 zero duplicates | No duplication | Continue; Phase 3 may still apply |
| Scope cap exceeded | >100 pages or >50k words | Warn operator; narrow scope |
| Phase 7 snapshot drift | Wiki edited during refactor | Present diff; operator picks overwrite/merge/abort |
| 3-round review won't converge | Quality blocker | Escalate page to human |
Success criteria and PRD-protection rationale: rationale.md.
npx claudepluginhub bordenet/superpowers-plus --plugin superpowers-plusGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.