Does this skill automatically modify my directory structure?

No. Following a strict safety protocol, PM System Refactor only generates proposals. All structural changes require explicit human approval before execution.

What happens to old files during a merge?

The skill follows a non-destructive path; it typically archives or redirects old registers rather than deleting them, preserving the history of the knowledge system.

Will renaming a decision break my internal links?

The skill includes logic to update all wiki-links pointing to the old file name during a rename operation, ensuring your vault's integrity remains intact.

How does the skill decide when a register is 'overcrowded'?

The skill reads your local configuration (ops/config.yaml). By default, it identifies registers with more than 35 decisions as candidates for splitting.

Can I use this for any Markdown-based documentation?

While it is optimized for Project Management vaults with registers and decision folders, its logic can be adapted for any system following a similar 'Hub and Spoke' documentation pattern.

PM System Refactor

Name: PM System Refactor
Author: LopeWale

byLopeWale

0•

生产力与工作流

Optimizes and reorganizes project management knowledge systems by restructuring decision registers and vault architectures.

PM System Refactor is a maintenance-focused skill for Claude Code designed to manage the evolution of project management decision vaults. It addresses the 'brittleness' of growing knowledge systems by identifying overcrowded registers, merging thin folders, and correcting inconsistent naming conventions. Whether you are scaling from 20 to 80 decisions or need to split a general register into domain-specific ones, this skill proposes surgical architectural changes. Built with a 'safety-first' philosophy, it never auto-applies structural shifts, instead providing detailed proposals that require explicit human approval to ensure the vault remains intuitive and searchable.

主要功能

01Merging of thin or redundant documentation registers

02Smart splitting of overcrowded knowledge categories

03Consistency checking for decision title formats

04Automated structural audits of decision registers

05Automated renaming and link-integrity management

060 GitHub stars

使用场景

01Standardizing inconsistent decision naming conventions across a team

02Scaling a small project vault into a multi-domain knowledge base

03Reorganizing folder structures to improve documentation discoverability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopewale/ampllabs pm-refactor

For use in Claude.ai and ChatGPT