refactor-chain

Installation
SKILL.md

refactor-chain — the self-diagnosing, self-healing fix-it pipeline

One calm door to the whole refactor-* skill family. It detects what's needed, plans in plain words, does the work in small verified steps, reviews, and writes up what changed. Everything is behavior-preserving unless the user opts into an advisory redesign. Detection and state are single-sourced from the harness.

Harness dir: DIR="$HOME/.claude/skills/refactor-chain/scripts" (or ${CLAUDE_PLUGIN_ROOT}/scripts). diagnose.mjs classifies; orchestrate.mjs holds the run state at <project>/.refactor-chain/state.json (resumable across turns/compaction).

Modes (the user decides; default = ask-once)

  • careful — when unsure, ask ONE plain "did you mean A or B?"; pause before risky steps.
  • autopilot — proceed on the best guess; pause only for destructive actions.
  • ask-once — ask "careful or fast?" once at the start, then remember. Pass --mode careful|autopilot|ask. Every message is plain-language by default; offer "show technical details" for the depth.

The 9-phase pipeline

Installs
6
GitHub Stars
3
First Seen
Jul 2, 2026
refactor-chain — ahmedbenaw/refactor-chain