clean-code

Apply explicit constraints like YAGNI and KISS principles that forbid unused abstractions, factories for few objects, and single-function utility files. This Skill instructs the AI to write the simplest working solution and inline small helpers instead of creating extra files.

Core standards include SRP, DRY, KISS, YAGNI, and the Boy Scout rule. Functions should stay under 20 lines with at most 3 arguments, use intention-revealing names, avoid deep nesting beyond 2 levels, and rely on guard clauses instead of comments.

Instruct the AI that code should self-document through clear naming, and that any comment explaining a name means the name should be changed. Obvious line-by-line comments and narrative preambles like "First we import..." are explicitly banned.

Yes, the principles are language-agnostic since they cover naming conventions, function size, structure, and abstraction levels rather than syntax. Examples reference TypeScript-style files, but the rules apply to any codebase.

Edits break dependents when the AI changes a file without checking what imports it. This Skill mandates checking importers, imported interfaces, and test coverage before editing, and updating all dependent files in the same task.