Refactoring Hint Comment

Copilot's autocomplete engine uses surrounding comments to predict the next edit. This structured refactoring hint tells Copilot exactly where to extract, what to name it, and where to put it — turning a manual refactor into a single Tab accept.

// REFACTOR: Extract the {{logicDescription}} below into a pure function
// called {{newFunctionName}}({{params}}): {{returnType}}
// Move to {{targetFile}}
// Reason: {{reason}}
// Keep the call site here, just replace inline logic with the function call