large-scale-refactor

Core constraint: This skill activates when any task will touch 50 or more files, run for longer than one agent session, or be parallelized across multiple agent instances. Once active, the rules below are non-negotiable. The agent must not deviate from the defined task scope under any circumstances, including when it identifies what appears to be a related improvement opportunity.

§ 1 — BEFORE ANY WORK BEGINS: The Spec Gate

Large-scale refactors must begin with a written spec. No execution without a reviewed spec. This is not optional.

1.1 Required Spec Contents

The agent will produce a spec document (or use the provided one) that includes: