refactor

Detect configuration drift and generate risk-scored refactor plans with rollback guidance.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/shakedfb/deterministic-agentic-sdlc-workflow --skill refactor-shakedfb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/shakedfb/deterministic-agentic-sdlc-workflow/tree/main/.claude/skills/refactor
Command: npx skills add https://github.com/shakedfb/deterministic-agentic-sdlc-workflow --skill refactor-shakedfb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan vault restructuring with safe, auditable steps to align configuration and artifacts.

Core Features & Use Cases

  • Detect drift between config.yaml and derivation.md
  • Generate structured, risk-scored refactor plans
  • Apply changes with validation and rollback options

Quick Start

Trigger /refactor to compare configuration drift, view the plan, and approve the execution.

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

Detect configuration drift by comparing ops/config.yaml against ops/derivation.md to reveal dimension changes and feature flag differences. This comparison identifies mismatches between your expected and actual vault setup.

How do I plan a vault restructuring without breaking templates and hooks?

Assess impacted artifacts across notes, templates, context, MOC structure, and hooks during vault restructuring. Generate a detailed, risk-scored plan with content impact and timelines to ensure structural integrity.

What is the safest way to execute a vault refactor with rollback options?

Execute vault refactors safely by enforcing hard blocks, soft warnings, and cascade checks. This produces a validation-backed execution plan with rollback guidance to prevent data loss during structural changes.

Does the refactor process require manual validation after plan generation?

No manual validation is required post-generation. The system produces a validation-backed execution plan that automatically assesses content impact and timelines while enforcing safety through hard blocks and cascade checks.

Can I assess feature flag differences before applying structural changes?

Yes, assess feature flag differences before execution. The drift detection phase identifies these differences early, generating a risk-scored plan that evaluates content impact and timelines prior to any structural changes.

When should I use an automated refactor plan instead of manual restructuring?

Use an automated refactor plan when configuration drift impacts multiple artifacts like notes, templates, and MOC structure. It provides necessary cascade checks and rollback guidance that manual restructuring lacks.