refactor

Compare ops/config.yaml with ops/derivation.md to plan vault restructuring.

1|Updated Mar 6, 2026

Search Tags:#automation #planning #configuration #refactor #vault #derivation

Ready to run

npx skills add https://github.com/adiman9/mnemos --skill refactor-adiman9

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/adiman9/mnemos/tree/main/core/skills/refactor
Command: npx skills add https://github.com/adiman9/mnemos --skill refactor-adiman9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams coordinate vault restructuring by automatically comparing the live configuration (ops/config.yaml) to the original derivation (ops/derivation.md), surfacing drift and guiding safe remediation.

Core Features & Use Cases

Detect configuration drift between config.yaml and derivation.md and surface actionable changes.
Generate an end-to-end restructuring plan that accounts for cascaded changes across templates, context, MOC structure, and notes, then apply changes on approval.
Support dry-run previews and targeted dimension focus (e.g., granularity, organization) to minimize risk.
Update derivation records and maintain config-vs-derivation traceability for governance.

Quick Start

Run the /refactor command to compare config against derivation and apply the approved vault restructuring plan.

Frequently Asked Questions about refactor

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

FAQPage Schema

How do I detect configuration drift in my vault?▼

Detect configuration drift by comparing ops/config.yaml against ops/derivation.md to identify discrepancies and surface actionable changes for safe vault remediation.

What is the safest way to plan vault restructuring across templates and MOCs?▼

Plan vault restructuring using a dry-run preview to generate an end-to-end plan that accounts for cascaded changes across templates, context, and MOC structure before applying on approval.

Can I target a specific dimension like organization when restructuring my vault?▼

Yes, dimension-focused targeting supports restructuring specific dimensions like organization or granularity to minimize risk and limit the scope of applied vault changes.

How do I maintain traceability between config and derivation after restructuring?▼

Maintain traceability by updating derivation records after applying restructuring changes, ensuring config-vs-derivation governance is preserved and providing rollback guidance.

Does the vault restructuring process provide risk insight and rollback guidance?▼

Yes, the vault restructuring process provides risk insight and rollback guidance, generating a comprehensive plan requiring approval before applying cascaded changes across templates and MOC structure.