Refactor Safely

Plan and execute safe refactoring using dependency analysis

theexperiencecompany Updated

File contents

Refactor Safely

Use the knowledge graph to plan and execute refactoring with confidence.

Steps

  1. Use refactor_tool with mode="suggest" for community-driven refactoring suggestions.
  2. Use refactor_tool with mode="dead_code" to find unreferenced code.
  3. For renames, use refactor_tool with mode="rename" to preview all affected locations.
  4. Use apply_refactor_tool with the refactor_id to apply renames.
  5. After changes, run detect_changes to verify the refactoring impact.

Safety Checks

  • Always preview before applying (rename mode gives you an edit list).
  • Check get_impact_radius before major refactors.
  • Use get_affected_flows to ensure no critical paths are broken.
  • Run find_large_functions to identify decomposition targets.

theexperiencecompany/gaia/tree/main/.agents/skills/refactor-safely commit 6d0bdd637e

Frequently asked questions

npx skillmds@latest add theexperiencecompany/refactor-safely