Generator .cursorrules
Reguły pod Twój stack w 30 sekund — wybierz stack i preferencje, a gotowy plik skopiujesz albo pobierzesz.
# Kontekst: pracujemy nad Next.js (App Router) + TypeScript + React. Zasady ogólne - Zanim napiszesz kod, w 1 zdaniu powiedz, co zamierzasz zrobić. - Trzymaj się istniejących konwencji repo. Nie przepisuj działającego kodu bez powodu. - Nie dodawaj bibliotek bez potrzeby — najpierw sprawdź, co już jest. Stack i architektura - Używaj App Router (folder `app/`), Server Components domyślnie; `'use client'` tylko gdy potrzebny stan/interakcja. - Data fetching w komponentach serwerowych; unikaj `useEffect` do pobierania danych. - Trzymaj się konwencji Next: `page.tsx`, `layout.tsx`, `loading.tsx`, `error.tsx`. Styl kodu i preferencje - Włącz `strict: true` w tsconfig. Zero błędów typów. - Pisz testy dla logiki (Vitest/Jest lub pytest). Nowa funkcja = test. - Małe pliki i funkcje. Jedna odpowiedzialność. Jeśli plik rośnie — dziel. - Komentarze i opisy pisz po polsku, poprawnie (z polskimi znakami). - Dbaj o dostępność: semantyczny HTML, `alt`, focus, kontrast (WCAG AA). Bezpieczeństwo - Sekrety i klucze API tylko z env / secretów. Nigdy w kodzie ani w repo. - Waliduj i sanityzuj dane wejściowe od użytkownika. Czego nie robić - Nie commituj `node_modules`, `.env`, plików build. - Nie zostawiaj `console.log`/`print` w kodzie produkcyjnym. - Nie zmyślaj API — jeśli nie masz pewności, powiedz to.
Generator działa w całości w Twojej przeglądarce — nic nie wysyłamy na serwer. Reguły to dobry punkt wyjścia; dopisz własne zasady specyficzne dla projektu.
Po co Ci dobre .cursorrules
Bez reguł AI zgaduje konwencje Twojego projektu — miesza style, biblioteki i wzorce. Plik .cursorrules to stały kontekst: opisujesz w nim stack (np. Astro + TypeScript), zasady formatowania, preferowane biblioteki i rzeczy, których agent ma unikać. Efekt: mniej poprawiania po AI.
Jak korzystać z generatora
Wybierz format pliku, swój stack i backend, zaznacz preferencje (np. TypeScript strict, testy, komentarze po polsku) i opcjonalnie wpisz nazwę projektu. Podgląd po prawej aktualizuje się na żywo — na końcu kliknij Kopiuj albo Pobierz i wrzuć plik do katalogu głównego repozytorium.
Chcesz zobaczyć reguły w akcji? Zajrzyj do poradnika o workflow z agentami.
Najczęstsze pytania
Co to jest plik .cursorrules?
To plik z regułami, który Cursor (i podobne edytory) wczytuje jako stały kontekst. Opisujesz w nim swój stack, konwencje kodu i zasady, żeby AI generowało kod spójny z Twoim projektem.
Czym różni się .cursorrules od AGENTS.md i CLAUDE.md?
.cursorrules jest natywny dla Cursora, AGENTS.md to uniwersalna konwencja czytana m.in. przez Codex i inne agenty, a CLAUDE.md czyta Claude Code. Treść reguł jest podobna — opis projektu i zasady pracy — więc generator składa ją w wybranym formacie.
Czy coś wysyłacie na serwer?
Nie. Generator działa w całości w Twojej przeglądarce (jako Astro Island). Nazwa projektu i wybory nie opuszczają Twojego komputera — plik składamy lokalnie.
Czy reguły wystarczą do dobrego kodu?
To solidny punkt startowy, nie komplet. Dopisz zasady specyficzne dla swojego projektu: nazwy modułów, zakazane biblioteki, wzorce architektury. Im konkretniej, tym mniej poprawiania po AI.