Custom Pine Script Indicator

I want a tailor-made indicator coded in Pine Script for the TradingView platform. The script should follow best practices—clean, well-commented logic, no repainting, and full Pine v5 compatibility—so I can later tweak parameters without digging through cryptic code.

I’ll provide the precise entry, exit, and alert rules once we start. For now, assume it will run on standard price candles and must expose key settings in the user interface. My end goal is a finished .pinescript file that compiles without errors, plots as expected, and includes a short note explaining how to modify inputs and enable alerts.