coding-reorg-functions

Reorganize the Python functions in a file

SKILL.md

GitHub

Reorganize Python Functions Within a File

  • Reorganize the Python functions in the user-provided file per the general rules in coding.rules.md

    • Follow ## Organize Functions Into Logical Layers in .claude/skills/coding.rules.md
    • Follow ## Order Layers by Abstraction Level in .claude/skills/coding.rules.md
    • Follow ## Order Functions Within Each Layer in .claude/skills/coding.rules.md
    • Follow ## Keep Related Functions Together in .claude/skills/coding.rules.md
    • Follow ## Mark Private Functions in .claude/skills/coding.rules.md

Additional Guidance

  • Avoid circular ordering where possible
  • Preserve existing comments and docstrings
  • Keep public entry points easy to locate near the end of the file
  • Prefer cohesion and readability over strict categorization

Constraints

Preserve Behavior Exactly

  • Do not modify functionality, logic, signatures, control flow, side effects, or semantics
  • The resulting code must behave identically to the original

Move Code Only

  • The refactor must be structural only
  • Allowed changes:
    • Reordering functions
    • Adding section headers
    • Renaming internal/private functions consistently
  • Disallowed changes:
    • Rewriting logic
    • Simplifying implementations
    • Changing APIs
    • Changing imports unnecessarily
    • Modifying formatting beyond what is required for reorganization

Verification

  • Confirm every function from the original file is still present
  • Run the file's unit tests to confirm behavior is unchanged