Does it make changes to my files automatically?

No, the skill follows a strict safety invariant where a restructuring plan is always shown first. Changes are only executed upon your explicit approval.

Which files are required for this skill to work?

It requires three key files in the 'ops' directory: derivation-manifest.md, config.yaml, and derivation.md to establish the baseline and current state.

What triggers the Refactor skill?

You can trigger the skill by using the command `/refactor` or by asking Claude to 'restructure vault'.

What is the relationship between /architect and /refactor?

/architect is used to analyze project health and recommend changes, while /refactor is the implementation tool that applies those approved architectural shifts.

Can I preview changes without being prompted for approval?

Yes, you can use the '--dry-run' argument to view the full restructuring plan and impact assessment without triggering the execution phase.

Vault Refactor Manager

Name: Vault Refactor Manager
Author: LopeWale

byLopeWale

•

Developer Tools

Automates the restructuring of project vaults and metadata by aligning configuration files with implementation artifacts.

The Refactor skill synchronizes your project’s architectural dimensions by detecting drift between live configuration and original derivation records. It performs a deep cascade analysis to identify how shifts in project organization, granularity, or schema affect note templates, Map of Content (MOC) hierarchies, and automation hooks. By providing a detailed risk assessment and an interactive approval workflow, it ensures that complex structural updates are executed consistently across all project artifacts, preventing technical debt and architectural drift.

Key Features

01Cascade analysis mapping dimension shifts to affected files and skills

02Multi-phase execution including template updates and skill regeneration

03Support for dry-run previews and targeted dimension refactoring

04Comprehensive risk assessment and content impact reporting

05Automated drift detection between config.yaml and derivation records

061 GitHub stars

Use Cases

01Updating metadata schemas and validation rules across an entire project vault

02Reorganizing a flat note structure into a hierarchical MOC system

03Synchronizing automation hooks and processing depths after architectural shifts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lopewale/dev_ignition refactor

For use in Claude.ai and ChatGPT

Download Skill