refactor

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

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/adiman9/mnemos --skill refactor-adiman9
Or copy as Structured Prompt for Agent
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.