clean-code

Apply explicit coding standards covering naming, function size, and structure rules. This Skill enforces KISS and YAGNI principles, limits functions to 20 lines, caps arguments at 3, and bans unnecessary helpers, factories, and obvious comments.

It enforces SRP, DRY, KISS, YAGNI, and the Boy Scout rule. It also mandates guard clauses over deep nesting, verb-noun function naming, question-form booleans, and SCREAMING_SNAKE constants.

Before editing any file, the agent must identify what imports it, what it imports, and which tests cover it. All dependent files must be edited in the same task so no broken imports or missing updates remain.

Yes, a mandatory self-check confirms the goal was met, all files were edited, code works, and lint and TypeScript checks pass. Agents must also run their designated verification scripts and summarize results before fixing anything.

Avoid rigid enforcement during rapid prototyping or exploratory spikes where speed matters more than structure. The standards target production-bound code where maintainability and readability are priorities.