Keskitaso15 min

Cursor Rules: Projektikohtaiset ohjeet

Cursor Rules on tehokas tapa antaa AI:lle projektikohtaisia ohjeita. .cursorrules-tiedosto projektin juuressa ohjaa AI:n käyttäytymistä juuri sinun projektissasi.

Edellytykset: Cursor: Asennus ja aloitus, Cursor Composer: Tehokas käyttö

Mikä on .cursorrules?

.cursorrules on tekstitiedosto projektin juurikansiossa, joka antaa AI:lle ohjeita:

Hyödyt: - AI noudattaa projektin koodaustyyliä - Vähemmän korjattavaa AI:n tuotoksissa - Yhtenäinen koodi koko projektissa - Tiimille jaettavat säännöt

Toimintaperiaate: Cursor lukee .cursorrules-tiedoston automaattisesti ja sisällyttää sen AI:n kontekstiin. Jokainen prompti saa nämä ohjeet taustalle.

Tiedoston luominen

Luo tiedosto projektin juurikansioon:

1. Avaa projekti Cursorissa 2. Luo uusi tiedosto: .cursorrules 3. Kirjoita ohjeesi 4. Tallenna

Tiedosto on heti käytössä - ei tarvitse käynnistää uudelleen.

// Projektin rakenne:
my-project/
├── .cursorrules    // <-- Tämä tiedosto
├── src/
├── package.json
└── ...

Vinkki: Lisää .cursorrules versionhallintaan, niin tiimisi saa samat säännöt.

Perusrakenne

Hyvä .cursorrules sisältää:

1. Projektin kuvaus 2. Teknologiat ja versiot 3. Koodaustyylit 4. Tiedostorakenne 5. Kiellot ja varoitukset

# Projektin kuvaus
Tämä on Next.js 14 blogi-sovellus TypeScriptillä.

# Teknologiat
- Next.js 14 App Router
- TypeScript strict mode
- Tailwind CSS
- Supabase (tietokanta ja auth)

# Koodaustyyli
- Käytä funktionaalisia komponentteja
- Käytä TypeScript-tyyppejä kaikkialle
- Nimeä muuttujat englanniksi, camelCase
- Komponenttien nimet PascalCase
- Käytä async/await, ei .then()

# Tiedostorakenne
- Komponentit: src/components/
- Sivut: src/app/
- Utilityt: src/lib/
- Tyypit: src/types/

# Älä koskaan
- Käytä any-tyyppiä
- Käytä var-avainsanaa
- Jätä console.log:eja tuotantokoodiin

Edistyneet ohjeet

Voit antaa hyvin spesifisiä ohjeita:

# Virheenkäsittely
Käytä aina try-catch API-kutsuissa.
Palauta { success: boolean, data?, error? } objekti.

# Komponenttirakenne
Komponentit tässä järjestyksessä:
1. Tyyppimäärittelyt
2. Props-interface
3. Komponentin funktio
4. Paikalliset tyylit (jos tarvitaan)

# Nimeämiskäytännöt
- Hookit: use-prefix (useAuth, useProducts)
- Utilityt: verbi-alku (formatDate, calculateTotal)
- Tyypit: -Type suffix (UserType, ProductType)
- Enumit: SCREAMING_SNAKE_CASE

# Testaus
Kirjoita testit __tests__ kansioon.
Käytä describe/it/expect syntaksia.
Testaa edge caset ja virhetilanteet.

# Git
Commit viestit englanniksi.
Käytä conventional commits: feat:, fix:, docs:

Esimerkkitiedostoja

Tässä erilaisia esimerkkejä eri projektityypeille:

# Next.js App Router projekti
---
# Projekti
Next.js 14 App Router sovellus Supabase-backendillä.

# Stack
- Next.js 14, TypeScript, Tailwind CSS
- Supabase (auth, database, storage)
- React Query datanhakuun
- Zod validointiin

# Käytännöt
- Server Components oletuksena
- "use client" vain kun tarvitaan
- API Routes: src/app/api/
- Supabase-klient: src/lib/supabase/

# Validointi
Käytä Zod-schemoja:
- API inputille
- Lomakkeille
- Ympäristömuuttujille

---

# React Native projekti
---
# Projekti
React Native Expo sovellus.

# Stack
- Expo SDK 50
- TypeScript
- NativeWind (Tailwind)
- React Navigation

# Käytännöt
- Käytä Expo SDK:n komponentteja
- Screens: src/screens/
- Navigation: src/navigation/
- Testaa iOS ja Android

---

Vinkki: Pidä rules-tiedosto kohtuullisen lyhyenä. Liian pitkä tiedosto vie kontekstitilaa.

Yleiset virheet

Vältä näitä:

1. Liian pitkä tiedosto - Pidä alle 500 sanaa - Keskity olennaiseen

2. Ristiriitaiset ohjeet - Tarkista ettei ole päällekkäisyyksiä - Yksi tyyli per asia

3. Liian yleiset ohjeet - "Kirjoita hyvää koodia" ei auta - Ole spesifinen

4. Vanhentunut tieto - Päivitä kun stack muuttuu - Poista käyttämättömät ohjeet

5. Ohjeet jotka AI ei voi noudattaa - "Testaa aina selaimessa" - AI ei voi - Pidä ohjeet koodiin liittyvinä

Yhteenveto

.cursorrules tiedosto projektin juureen ohjaa AI:ta
Sisällytä teknologiat, koodaustyyli ja kiellot
Pidä tiedosto lyhyenä ja spesifisenä
Lisää versionhallintaan tiimin käyttöön

Usein kysytyt kysymykset

Lukeeko Cursor .cursorrules automaattisesti?

Kyllä, Cursor lukee tiedoston automaattisesti kun se on projektin juuressa. Ei tarvitse konfiguroida erikseen.

Voinko käyttää useita rules-tiedostoja?

Cursor lukee vain yhden .cursorrules-tiedoston projektin juuresta. Voit kuitenkin jakaa ohjeet osioihin tiedoston sisällä.

Kuinka pitkä tiedosto voi olla?

Teknisesti rajaa ei ole, mutta pitkä tiedosto vie kontekstitilaa AI:lta. Suositus on alle 500 sanaa.

Seuraavaksi