Cheat-Sheet: CLAUDE.md Yozish Qo‘llanmasi

Modul 5, Dars 5.1 uchun beriladigan fayl. Har yangi loyihada shu shablondan boshlang.

5 bo‘limli shablon

# Loyiha qoidalari — <Loyiha nomi>

## Texnologiyalar
- <til/framework va versiya; ruxsat etilgan kutubxonalar>
- <taqiqlangan muqobillar — aniq nom bilan>

## Buyruqlar
- Test: `npm run test`
- Typecheck: `npm run typecheck`
- Ishga tushirish: `npm run dev`

## Kod uslubi
- <naming: klasslar/metodlar/fayllar>
- <izohlar tili va qachon yozilishi>
- <tip qoidalari: masalan "any taqiqlanadi">

## Arxitektura
- <qatlamlar va ularning chegaralari>
- <config/env qoidasi>

## Taqiqlar
- <hech qachon qilinmaydigan narsalar — eng qat'iy ro'yxat>

Yaxshi qoida vs yomon qoida

Aniq (tekshirsa bo‘ladi)	Umumiy (o‘lchab bo‘lmaydi)
"Faqat App Router. Pages Router taqiqlanadi."	"Zamonaviy Next.js yoz"
"`any` taqiqlanadi"	"Tiplarni to‘g‘ri ishlat"
"Izohlar o‘zbek tilida (lotin)"	"Kodni izohla"
"Har o‘zgarishdan keyin `npm run typecheck`"	"Xatolarni tekshir"

Sinov: qoida buzilganini bir qarashda ayta olasizmi? Yo‘q bo‘lsa — qayta yozing.

Fayl qancha uzun bo‘lsin (token narxi!)

CLAUDE.md har sessiyada o‘qiladi → har ortiqcha qator doimiy xarajat.
Mo‘ljal: 30–60 qator. 100+ qator bo‘lsa — retseptlarni Skill'larga ko‘chiring.
Formula: qoida → CLAUDE.md · retsept → Skill.

Ierarxiya

Fayl	Qamrov	Nima uchun
`~/.claude/CLAUDE.md`	Barcha loyihalaringiz	Shaxsiy odatlar (til, uslub)
`<loyiha>/CLAUDE.md`	Bitta loyiha (git'da)	Jamoa standartlari

Oltin qoidalar

Qoida — buzilganini aniq aytib bera oladigan jumla.

CLAUDE.md — konstitutsiya (qisqa), Skill — qo‘llanma (batafsil).

Yangi qoidani darrov sinang: ataylab teskari vazifa berib, agent sizni to‘g‘rilashini ko‘ring.