agentsclimarketplace

Build refactor

Skill sh-ai-x/dev-harness-kit/skills/build-refactor

4-pass cleanup (dead → dup → naming → coverage). No cleanup without regression test (MUST-L1 + L4).From its SKILL.md

Install
npx -y skills add sh-ai-x/dev-harness-kit --skill build-refactor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.9 KB, as published. Nobody here has run it

← Skills index

build-refactor — 4-Pass Cleanup

Previously named build-simplify. Renamed to match the parent /dev-kit:refactor skill. For actual code deletion (slop, dead features, orphan code), see the sibling /dev-kit:prune skill — its 3-pass deletion sweep (orphan-code → dead-feature → slop-pattern) is inlined into skills/prune/SKILL.md as "Phase 2".

Iron Law

No cleanup without regression test. Pass 1 = dead code removal — confirm all affected tests pass before next pass.

Optional Linear preflight

At the start of a new refactor task, invoke /dev-kit:linear once when Linear is enabled or available. Continue normally on LINEAR_SKIP or an implicit LINEAR_ERROR; do not invoke it per cleanup pass. See skills/linear/SKILL.md for the reconciliation contract.

4 Passes (separate calls)

[1/4] DEAD CODE   → unused exports / dead branches / commented-out blocks
       (Grep with permission to find all references first)
       ↓ regression test green
[2/4] DUPLICATION → same logic in 2+ places. extract helper / module
       ↓ regression test green
[3/4] NAMING      → variable / function / file / module names clear
       ↓ regression test green
[4/4] COVERAGE    → boost weak tests. hot path + edge cases
       ↓ full test suite green

Rules

  • Do not bundle 4 passes into one cycle (MUST-NO-LOOP).
  • One pass = one kind. Confirm regression test pass after each.
  • ❌ guess. Measure first (e.g., coverage report --include=src/lib).
  • This skill refactors (rewrites / extracts / renames). It does not delete whole files or features. For deletion, dispatch /dev-kit:prune (3-pass sweep inlined into its Phase 2 section).

Hook integration

Build stage active. During cleanup edits, tdd-guard passes if test changes accompany (helps rename).

Red Flags

ThoughtReality
"Do all 4 passes at once"Can't tell which pass caused regression
"Leave tests as-is"L1 violation
"Comment out to disable"L4 violation
"Verify later"L3 violation
"Delete the whole unused module"Out of scope. Use /dev-kit:prune (its Phase 2 3-pass sweep).

Hand-off

Previous (read first): /dev-kit:inspect — produces the report that prioritizes which passes to run.

After 4 passes, state_codec.append_hand_off(root, "build", "review", "..."). Next: /dev-kit:review.

If passes surface whole-file deletion candidates, hand off to /dev-kit:prune for the deletion pass rather than continuing here.

Keep looking

Skills are one crate of 608,666. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.