wiki-refactor

Coordinate seven-phase wiki refactors with PRD gates and migration guides.

8|1|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/bordenet/superpowers-plus --skill wiki-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-refactor
Source: https://github.com/bordenet/superpowers-plus/tree/main/skills/wiki/wiki-refactor
Command: npx skills add https://github.com/bordenet/superpowers-plus --skill wiki-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Wiki ecosystems often become bloated and inconsistent as teams refactor in silos; this Skill coordinates an end-to-end wiki refactor to restore structure, remove duplication, and enable safer deployment.

Core Features & Use Cases

  • Orchestrates a seven-phase pipeline: discovery, deduplication, information architecture, writing plan, progressive rewrite + review, quality metrics, and safe delivery.
  • Enforces PRD protection with hard gates and human checkpoints to guard critical decisions and prevent scope drift.
  • Produces artifacts including a refactored wiki directory, a migration guide, and a comprehensive refactor report for governance, auditing, and handoff.

Quick Start

Run Phase 1: Discovery against your seed wiki URL and follow operator prompts through Phase 7, approving checkpoints as required.

Frequently Asked Questions about wiki-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restructure a large wiki to eliminate content duplication?

You can restructure a large wiki by running a seven-phase refactor pipeline that handles discovery, deduplication, and progressive rewriting to remove redundant content and restore navigational structure.

What is the best way to manage knowledge base governance during a migration?

Knowledge base migration governance is managed by enforcing hard PRD gates with human checkpoints at critical phases, preventing scope drift and producing a comprehensive refactor report for auditing and handoff.

How do I create an information architecture plan for a bloated wiki?

Creating an information architecture plan requires running the discovery phase against your seed wiki URL to audit existing content, followed by structured deduplication and writing plan phases to establish a clean directory structure.

Does this wiki refactor process require manual approval between phases?

Yes, the wiki refactor process requires manual approval through human checkpoints at hard PRD gates, ensuring operators explicitly approve critical decisions before progressing to the next phase of the pipeline.

What artifacts are produced after restructuring a knowledge base?

Restructuring a knowledge base produces three main artifacts: a refactored wiki directory for immediate use, a migration guide for safe deployment, and a comprehensive refactor report for governance and auditing.

When should I avoid using an automated wiki refactor pipeline?

You should avoid using an automated wiki refactor pipeline for small knowledge bases or isolated page updates, as the seven-phase process with hard PRD gates is designed for large-scale reorganization requiring end-to-end coordination.