One-click install
npx skills add https://github.com/benediktms/overmind --skill weaver-benediktms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weaver
Source: https://github.com/benediktms/overmind/tree/main/cli/claudecode-plugin/skills/weaver
Command: npx skills add https://github.com/benediktms/overmind --skill weaver-benediktms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides engineers through structured, behavior-preserving refactors, ensuring changes improve structure without altering observable results.

Core Features & Use Cases

  • Define and scope refactor tasks with clear file boundaries and without cross-team conflicts.
  • Enforce ownership and pre-claim checks to prevent overlapping efforts and racing for work.
  • Establish a behavior baseline by running the full test suite and capturing expected outcomes before any change.
  • Make smallest mechanical transformations (rename, extract, inline, move) to satisfy the task while preserving behavior.
  • Validate and hand off by re-running tests and documenting changes for peer review.

Quick Start

Submit a pending, unowned refactor task with a clear file scope to begin the cleanup.

Frequently Asked Questions about weaver

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

FAQPage Schema
How do I refactor code while preserving behavior?

Behavior-preserving refactoring applies minimal mechanical transformations like renaming, extracting, inlining, or moving code within a clear file scope, then validates changes by executing the test suite to confirm no observable behavior changes occur.

What is the best way to prevent ownership conflicts during code cleanup?

Preventing ownership conflicts during code cleanup requires enforcing pre-claim checks and clear file boundaries before starting, ensuring no overlapping efforts or racing for work occur across teams during the refactoring process.

How do I establish a behavior baseline before refactoring?

Establishing a behavior baseline involves running the full test suite and capturing expected outcomes before making any code changes, ensuring you have a verified reference point to validate that your refactor preserves behavior.

When do I need formal hand-off procedures for a refactor task?

Formal hand-off procedures are needed after validating your refactor by re-running tests and documenting changes for peer review, ensuring stability and traceability are maintained throughout the task lifecycle.

Can I use automated safeguards for cross-team refactoring tasks?

Automated safeguards support cross-team refactoring by enforcing scope conflict prevention, baseline verification, and ownership checks, ensuring overlapping efforts are avoided and structural improvements proceed without altering observable results.

What are the limitations of behavior-preserving refactoring?

Behavior-preserving refactoring is limited to minimal mechanical transformations within a clear file scope and requires a full test suite to establish a baseline, making it unsuitable for changes that intentionally alter observable program behavior.