Hlavní myšlenka
Cursor je AI-powered code editor. Má vlastní soubor .cursorrules, který funguje jako system prompt pro AI asistenta při kódování.
Cíl: Aby komentáře, README, commit messages a dokumentace zněly konzistentně – jako bych je psala já.
🚧 V backlogu
Tento use case zatím není implementovaný. Níže je návrh, jak by mohl vypadat.
Co by to řešilo
- Komentáře v kódu – stručné, jasné, bez bullshitu
- README soubory – strukturované, praktické, s příklady
- Commit messages – konvence + můj styl
- Dokumentace – čitelná pro lidi, ne pro roboty
- Naming conventions – konzistentní pojmenování
Technické flow
Backend – Jak to postavit
1. Vytvořit .cursorrules
Soubor v rootu projektu
↓
2. Definovat pravidla
Styl komentářů, dokumentace, naming
↓
3. Cursor načte automaticky
AI asistent respektuje pravidla
Návrh .cursorrules
.cursorrules (draft)
# Cursor Rules – Katka's Coding Style
## Obecné principy
- Piš kód, který je čitelný za 6 měsíců
- Komentáře vysvětlují PROČ, ne CO
- Méně je více – žádné zbytečné abstrakce
## Komentáře
- Krátké, věcné, bez bullshitu
- Česky pro osobní projekty, anglicky pro open-source
- Formát: "// Co to dělá – proč to potřebujeme"
## README struktura
1. Co to je (1 věta)
2. Jak to spustit (3 kroky max)
3. Příklady použití
4. Known issues (pokud jsou)
## Commit messages
- Formát: "typ: co se změnilo"
- Typy: feat, fix, docs, refactor, test
- Max 50 znaků v hlavičce
- Příklad: "feat: přidán export do CSV"
## Naming
- Proměnné: camelCase, popisné
- Funkce: verb + noun (getUserData, formatDate)
- Komponenty: PascalCase
- Soubory: kebab-case
## Co NEDĚLAT
- Žádné "TODO: fix later" bez deadline
- Žádné magické čísla bez konstant
- Žádné zkratky, které vyžadují googling
Přínosy
Konzistence
Všechny projekty mají stejný styl dokumentace
Rychlost
AI píše komentáře/docs, já jen schvaluji
Čitelnost
Kód je srozumitelný i po měsících
Onboarding
Nový člověk rychleji pochopí projekt
Další kroky
- Nainstalovat Cursor (pokud ještě nemám)
- Vytvořit .cursorrules v testovacím projektu
- Otestovat na reálném kódu
- Iterovat pravidla podle výsledků