adv-refactor

Detect drift between stale engineering proposals and current codebases.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Sharper-Flow/Advance --skill adv-refactor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adv-refactor
Source: https://github.com/Sharper-Flow/Advance/tree/main/skills/adv-refactor
Command: npx skills add https://github.com/Sharper-Flow/Advance --skill adv-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the disconnect between outdated engineering proposals and the current state of the codebase, preventing scope drift and ensuring that documentation remains a reliable source of truth.

Core Features & Use Cases

  • Staleness Analysis: Automatically detects drift between proposal requirements and actual implementation using hash matching and fuzzy similarity.
  • Batch Refactoring: Efficiently processes multiple stale changes, prioritizing the oldest items to maintain project momentum.
  • Conflict Resolution: Identifies overlaps with archived changes and flags obsolete requirements, ensuring that refactoring efforts are focused and safe.

Quick Start

Run the adv-refactor skill to refresh the stalest active proposals and align them with the current implementation.

Frequently Asked Questions about adv-refactor

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

FAQPage Schema
How do I reconcile stale engineering proposals with current code?

To reconcile stale engineering proposals with current code, you need to perform drift scanning and obsolescence detection against historical archives. This process aligns outdated proposal requirements with actual implementation evidence using hash matching and fuzzy similarity.

What is the best way to detect proposal drift in an active codebase?

The best way to detect proposal drift is to scan active change sets by comparing proposal requirements against the actual implementation evidence. Hash matching and fuzzy similarity identify overlaps with archived changes and flag obsolete requirements.

How do I batch refactor multiple stale proposals safely?

To batch refactor multiple stale proposals safely, process active change sets by prioritizing the oldest items first. This maintains project momentum while dependency verification and conflict resolution identify overlaps with archived changes to keep efforts focused.

Can I use dependency verification to prevent scope drift during proposal refresh?

Yes, dependency verification prevents scope drift during a proposal refresh by validating structured state mutations. It ensures that proposal requirements align with actual implementation evidence before changes are applied to the codebase.

When should I not use automated proposal reconciliation?

You should avoid automated proposal reconciliation when structured state mutation and validation logic cannot be applied to your active change sets. Without historical archives and dependency verification, automated staleness analysis may incorrectly flag or overwrite valid implementation evidence.

Does proposal refresh require structured state mutation logic to work?

Yes, proposal refresh requires structured state mutation and validation logic to function correctly. This logic ensures that detected obsolescence and drift scanning results accurately align proposal requirements with the actual implementation evidence.