Tujuan Pembelajaran

Mampu menulis .cursorrules yang efektif untuk Cursor IDE
Mampu menulis CLAUDE.md untuk Claude Code CLI
Memahami best practices untuk project-level AI rules

Analogi

Diagram


      .cursorrules = SOP Perusahaan:
Tanpa SOP: karyawan A pakai cara A, karyawan B pakai cara B -> tidak konsisten
Dengan SOP: "Untuk task X, prosedur Y. Output format Z." -> semua ikut standar

AI yang sama + aturan berbeda = hasil berbeda. Rules menentukan konsistensi.

.cursorrules seperti SOP perusahaan — memastikan output konsisten terlepas siapa (atau kapan) yang mengerjakan.

Penjelasan Konsep

.cursorrules (Cursor) dan CLAUDE.md (Claude Code) adalah file konfigurasi di root proyek yang menanamkan aturan spesifik proyek ke konteks AI. Setiap kali AI membaca codebase, rules otomatis diterapkan.

Komponen .cursorrules: (1) Project Overview — 1-2 kalimat tentang proyek + tech stack. (2) Conventions — struktur folder, component patterns, data fetching, error handling, form handling. (3) Database & API — naming convention, API route structure, response format. (4) Testing — file location, coverage, patterns. (5) Common Tasks — contoh menambah halaman, endpoint, komponen, migration.

Best practices: SPESIFIK bukan generik (“PascalCase untuk komponen” bukan “kode yang baik”), beri CONTOH, jangan terlalu panjang (context limit), iterasi (setiap AI salah berulang -> tambah aturan), version control (commit ke git), satu source of truth (jangan duplikasi rules).

Inti yang Perlu Dipahami

Bagian ini berfokus pada mampu menulis .cursorrules yang efektif untuk Cursor IDE., mampu menulis CLAUDE.md untuk Claude Code CLI., dan memahami best practices untuk project-level AI rules. Jangan terburu-buru menghafal istilahnya. Lebih penting untuk memahami peran setiap konsep dan kapan konsep itu muncul dalam pekerjaan web development.

Saat membaca Project Rules, gunakan tujuan belajar sebagai penanda arah. Kalau kamu sudah bisa menjelaskan tujuan itu dengan kata-katamu sendiri, berarti fondasinya mulai terbentuk.

Cara Membayangkannya

.cursorrules seperti SOP perusahaan — memastikan output konsisten terlepas siapa (atau kapan) yang mengerjakan. Analogi ini dipakai supaya konsep teknis tidak terasa melayang. Hubungkan setiap istilah dengan perannya: siapa yang meminta, siapa yang memproses, data apa yang berpindah, dan hasil apa yang diharapkan.

Kalau analoginya sudah terasa masuk akal, barulah lihat istilah teknisnya. Cara ini membuat materi lebih mudah dipahami daripada langsung menghafal definisi.

Saat Melihat Contoh Kode

Contoh kode pada chapter ini memakai bahasa markdown. Bacalah contoh kode sebagai ilustrasi alur, bukan sebagai bagian yang harus langsung dihafal. Rules paling efektif saat SPESIFIK. ‘Gunakan PascalCase untuk React components’ lebih baik dari ‘Tulis kode yang baik’. Beri contoh konkret untuk setiap aturan.

Perhatikan nama fungsi, urutan langkah, dan data yang berpindah. Biasanya tiga hal itu sudah cukup untuk memahami hubungan antara teori dan praktik.

Konteks dalam Perjalanan Belajar

Setiap konsep di platform ini dipilih karena dipakai di industri. Fokus pada pemahaman, bukan hafalan.

Kamu sudah di bagian lanjutan. Mulai pikirkan bagaimana konsep ini dipakai di dunia kerja — bukan hanya untuk belajar, tapi untuk membangun produk nyata.

Gunakan pertanyaan reflektif dan prompt AI di akhir chapter sebagai latihan aktif. Membaca saja tidak cukup — kamu perlu menjelaskan ulang dengan kata-katamu sendiri.

Contoh Kode

markdown

# .cursorrules
## Stack
Next.js 14 + TypeScript + Prisma + PostgreSQL
Monorepo: /apps/web, /apps/api, /packages/shared

## Conventions
- Named exports (no default exports)
- PascalCase.tsx for components, kebab-case.ts for utils
- Server Components by default, 'use client' only when needed
- Forms: React Hook Form + Zod
- API: RESTful, response { data, error? }

## Database
- snake_case tables and columns
- Always: id (uuid), created_at, updated_at
- Use Prisma migrations

## Do NOT
- Use 'any' type
- Hardcode secrets
- Skip error handling

Penjelasan Kode

Rules paling efektif saat SPESIFIK. 'Gunakan PascalCase untuk React components' lebih baik dari 'Tulis kode yang baik'. Beri contoh konkret untuk setiap aturan.

Prompt AI

Minta AI generate .cursorrules berdasarkan codebase-mu. Review: aturannya sesuai konvensi yang kamu inginkan? Ada yang kurang atau terlalu strict?

Pertanyaan Reflektif

Tulis .cursorrules untuk proyekmu. Setelah seminggu, review: kualitas output AI membaik? Frekuensi koreksi manual berkurang? Ada aturan yang perlu ditambah?