refactor

Detect configuration drift between ops/config.yaml and ops/derivation.md and generate a restructuring plan.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hellofrommorgan/intent-computer --skill refactor-hellofrommorgan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/hellofrommorgan/intent-computer/tree/main/packages/plugin/src/skill-sources/refactor
Command: npx skills add https://github.com/hellofrommorgan/intent-computer --skill refactor-hellofrommorgan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and resolve configuration drift between ops/config.yaml and ops/derivation.md by detecting every dimension and feature change, then plan and orchestrate a safe restructuring workflow that requires explicit approval.

Core Features & Use Cases

  • Detects drift by comparing derivation and live config, listing changed dimensions and feature flags.
  • Generates a comprehensive, phase-based restructuring plan that maps dimension changes to affected artifacts with risk and rollback considerations.
  • Executes a staged workflow: detect, plan, present, approve, execute, and validate, with traceability and rollback guidance.

Quick Start

Run /refactor to compare your live config against the baseline and review the proposed plan before applying changes.

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 between ops/config.yaml and ops/derivation.md?

To detect configuration drift, compare your live ops/config.yaml against the ops/derivation.md baseline. This identifies every changed dimension and feature flag across the 8 structural dimensions, highlighting exactly where your vault has diverged from the design baseline.

How do I plan a vault restructuring workflow with rollback safety?

Plan a vault restructuring by running a staged workflow that maps detected dimension changes to affected artifacts. This generates a phase-based restructuring plan with an integrated risk assessment and a validated rollback path to ensure safe execution.

What is config drift detection across the 8 vault dimensions?

Config drift detection is the process of identifying structural divergences across granularity, organization, linking, processing, navigation, maintenance, schema, and automation dimensions. It compares your live configuration against the design baseline to list all feature and structural changes.

Can I execute vault restructuring changes without explicit approval?

No, executing vault restructuring requires explicit approval. The workflow follows a strict sequence: detect, plan, present, approve, execute, and validate, ensuring all restructuring changes are reviewed before they are applied to your artifacts.

What do I need to run a config drift analysis and restructuring plan?

You need the live configuration file in ops/config.yaml and the design baseline in ops/derivation.md. These two files provide the necessary inputs to compare dimensions, assess risks, and output a precise restructuring plan with rollback guidance.

When should I avoid automated restructuring workflows?

You should avoid automated restructuring when configuration drift involves high-risk dimension changes that lack a validated rollback path. The workflow requires explicit approval and traceability to ensure unsafe structural modifications are not executed without proper risk assessment.