Clean Code

Cursor-Regel nach Clean-Code-Prinzipien: kurze Funktionen, klare Namen, keine Duplikation — sprachübergreifend einsetzbar.

Original-Beschreibung der Autoren: Guidelines for writing clean, maintainable, and human-readable code. Apply these rules when writing or reviewing code to ensure consistency and quality.

Die Regel

---
description: Guidelines for writing clean, maintainable, and human-readable code. Apply these rules when writing or reviewing code to ensure consistency and quality.
globs: ["**/*"]
alwaysApply: false
---
# Clean Code Guidelines

## Constants Over Magic Numbers
- Replace hard-coded values with named constants
- Use descriptive constant names that explain the value's purpose
- Keep constants at the top of the file or in a dedicated constants file

## Meaningful Names
- Variables, functions, and classes should reveal their purpose
- Names should explain why something exists and how it's used
- Avoid abbreviations unless they're universally understood

## Smart Comments
- Don't comment on what the code does - make the code self-documenting
- Use comments to explain why something is done a certain way
- Document APIs, complex algorithms, and non-obvious side effects

## Single Responsibility
- Each function should do exactly one thing
- Functions should be small and focused
- If a function needs a comment to explain what it does, it should be split

## DRY (Don't Repeat Yourself)
- Extract repeated code into reusable functions
- Share common logic through proper abstraction
- Maintain single sources of truth

## Clean Structure
- Keep related code together
- Organize code in a logical hierarchy
- Use consistent file and folder naming conventions

## Encapsulation
- Hide implementation details
- Expose clear interfaces
- Move nested conditionals into well-named functions

## Code Quality Maintenance
- Refactor continuously
- Fix technical debt early
- Leave code cleaner than you found it

## Testing
- Write tests before fixing bugs
- Keep tests readable and maintainable
- Test edge cases and error conditions

## Version Control
- Write clear commit messages
- Make small, focused commits
- Use meaningful branch names

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Allgemeine Cursor-Regel nach den Clean-Code-Prinzipien (Robert C. Martin): kurze Funktionen, aussagekräftige Namen, Vermeidung von Duplikation und Kommentare, die nur erklären statt kompensieren. Anders als frameworkspezifische Regeln in der Sammlung wirkt sie sprachübergreifend und sollte in praktisch jedem Projekt ergänzend zu einer Tech-Stack-Regel eingesetzt werden. Der Nutzen zeigt sich vor allem in Teams mit mehreren Cursor-Nutzern, wo sonst jeder unterschiedliche Stilvorstellungen in generierten Code einbringt. Wichtig: Clean-Code-Regeln können bei falscher Anwendung zu Overengineering führen — in Kombination mit einer Anti-Overengineering-Regel lässt sich das ausbalancieren.

Praxis-Tipp

Kombiniere die Regel mit einer Framework-Regel (z. B. Astro TypeScript) und prompte normal — Cursor achtet dann automatisch zusätzlich auf kurze Funktionen und sprechende Namen, ohne das extra erwähnen zu müssen.

Siehe auch

• Anti Overengineering
• Anti Sycophancy Code Discipline

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …