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.