Agent bilan kontrakt. CLAUDE.md doimiy imzongiz sifatida.

Siz allaqachon AI dan chat sifatida foydalanasiz — savol berdingiz, javob oldingiz, ishga nusxaladingiz. Bu modul chorrahadan boshlanadi: chat yonida boshqa kategoriya — agent paydo bo‘ldi, u javob bermaydi, balki harakat qiladi. Avval ularning farqini va bu sizning ishingizni qanday o‘zgartirishini tushunib olamiz, — oxirida esa siz o‘zingizning birinchi CLAUDE.md ni yozasiz va uni amalda tekshirasiz.

Chat va agent. Ikki xil vosita.

Chatni siz allaqachon bilasiz — bu brauzerdagi ChatGPT yoki Claude.ai. Savol yozasiz — javob olasiz. Foydali narsani o‘zingizning ishingizga qo‘lda nusxalaysiz. Chat — bu suhbatdosh: aqlli, lekin «oyna ortida». O‘zi sizning fayllaringizga kirmaydi va loyihangiz haqida siz qayta aytmaguningizcha hech narsa bilmaydi.

Yonida ikkinchi kategoriya — agent paydo bo‘ldi. Unga vazifa berasiz — va u oʻzi harakat qiladi: fayllaringizni ochadi, ularni tahrirlaydi, terminalda buyruqlarni ishga tushiradi, natijani koʻradi va davom etadi. U «nimani terish kerakligini aytmaydi», balki bajaradi va natijani koʻrsatadi. Bu endi suhbatdosh emas, balki qoʻllari bor ijrochi.

2024 va 2026. Bir xil bug — ikki xil dunyo.

Keyingi modulda: agent ichkarida qanday ishlaydi, real guruhda “oldin va keyin” demo, va sening birinchi CLAUDE.md — user-darajasida va loyihada — har bir sessiyada agentga kimligingni va kim uchun kod yozayotganingni tushuntirishni to‘xtatish uchun.

Agent buni qanday amalga oshiradi. Harakatlar sikli.

Sen farqni allaqachon tushunding: chat javob beradi, agent harakat qiladi. Endi — qanday qilib u harakat qiladi, toki bu sehrga o‘xshamasin.

Ichkarida — harakatlar sikli, bitta replika emas. Sen vazifani yozasan. Agent “avval faylni o‘qiyman” deb qaror qiladi — va o‘qiydi. Tarkibini ko‘radi, keyin o‘ylaydi: “endi tahrirlayman” — va tahrirlaydi. Keyin o‘zi testlarni ishga tushiradi. Va shu tarzda vazifa yopilguncha yoki u senga savol bilan murojaat qilguncha davom etadi.

Har bir pastga strelka — bu modelga yangi chaqiruv. Katta vazifalarda ularning o‘nlabi bo‘ladi. Sen buni TUI’da yarim shaffof oqim sifatida ko‘rasan: Reading src/auth.py, Editing tests/test_login.py, Running pytest.

Uni qayerda ishga tushirish kerak

Claude Code bitta oynaga bog‘lanmagan. Xuddi shu sozlama (sening CLAUDE.md) terminalda, redaktorda va brauzerda ishlaydi. Vazifaga qulay bo‘lgan joyni tanlaysan.

MarsCode — bizning agentimiz

MarsCode — Claude Code bilan bir xil kategoriyadagi o‘zimizning vositamiz. U Mars orqali modellarga kiradi, shuning uchun sen uchun bepul — balansni maktab beradi. Senga bu yerda bitta narsa muhim: modellar uchun pul to‘lash shart emas.

Kursda biz Claude Codeda o'rgatamiz — unda hamma narsa “qutidan tashqari” ishlaydi va to'liq hujjatlar mavjud. MarsCode'ni 5-modulda, o'z Skills'larimizni qurish va tejashni boshlaganimizda ulaymiz.

Codex (OpenAI) va Antigravity (Google) — xuddi shu narsa, boshqa vendorlar. Kursda ularga tegmaymiz; agar o'quvchi so'rasa — bu xuddi shunday agent, faqat boshqa kompaniyadan.

Demo. CLAUDE.mdsiz va u bilan.

Keys: mentor Zuhra, Yunusobod filiali, Python 7-9 yoshli guruh, 6 bola. Starter-loyihalar repoda Claude Code'ni ochadi. Bir xil narsani so'raydi. Avval shartnomasiz, keyin — u bilan.

$ cd ~/mars-lessons/python-7-9 && claude# agent noldan boshlaydi

> o'quvchilarim uchun
matematika haqida yana bir o'yin qo'shishga yordam bering

Claude: Yordam berishga tayyorman. Kontekstni
tushunish uchun bir nechta savollar:

  1. O'quvchilarning yoshi nechada?
  2. Izohlardagi tushuntirishlar
     qaysi tilda?
  3. Qaysi kutubxonalarga ruxsat berilgan?
  4. Qanchalik batafsil
     izohlash kerak?
  5. OOP mumkinmi yoki protseduraviy
     uslubmi?

# Har bir sessiyada 3 daqiqa ping-pong.

$ cd ~/mars-lessons/python-7-9 && claude# agent ./CLAUDE.md faylini avtomatik o'qiydi

> o'quvchilarim uchun
matematika haqida yana bir o'yin qo'shishga yordam bering

Claude: Loyiha uslubida
«Sonni top» starterini qilaman:

  • pygame + random, f-stringsiz
  • o'zgaruvchilar rus-lotin tilida
  • har 2 qatorga izoh
  • qisqa sarlavha «Bu
    dastur nima qiladi»

  Uslub uchun 01-circle.py'ni o'qidim.
  06-guess-number.py'ni yarataman.

Edit: 06-guess-number.py (+38)
Bash: python3 -m py_compile ✓

# Natijagacha 40 soniya.

Python 7-9 yoshli guruh uchun Project CLAUDE.md

Mana Zuhra repoda turgan fayl. Starter sifatida nusxalang — bu uchta tayyor pre-build shablonidan biri:

./CLAUDE.md · mars-lessons/python-7-9# Mars IT School — Python 7-9 yoshli guruh uchun
# Yunusobod filiali, mentor Zuhra

## Bu kodni kim o'qiydi
- 7-9 yoshli bolalar, to'rttasi dasturlashni birinchi marta ko'rmoqda.
- Tushuntirish tili: rus tili. O'zgaruvchilar nomlarida o'zbek lotin alifbosi
  ruxsat etiladi, agar bu yordam bersa (`tugma` o'rniga `button`).
- Terminologiya: "funksiya", "klass", "tsikl" so'zlarini
  izohda kundalik analogiya orqali tushuntirmasdan ishlatmaslik.

## Kod konvensiyalari
- **Har bir qator rus tilida izohlanadi.** Bu sotuv uchun kod emas,
  bu dars uchun kod.
- O'zgaruvchilar nomlari — oddiy so'zlar yoki translit (`schyot`, `score_counter` emas).
- Faqat `pygame` va `random`. f-strings,
  list comprehensions, dataclasses ishlatmaslik.
- Fayl har doim bir qatorli qisqa izoh bilan boshlanadi
  «Bu dastur nima qiladi».

## Workflow
- Har bir fayl `python3 file.py` orqali argumentlarsiz ishga tushirilishi kerak.
- Commit qilishdan oldin — `python3 -m py_compile file.py` (sintaksisni tekshirish).
- `.solutions/` ni tahrirlamaslik — u yerda keyingi guruhlar uchun tayyor yechimlar bor.

Boshqa mentor — boshqa shartnoma

Xuddi shu shablon «kim o'qiydi / konvensiyalar / workflow» — lekin boshqa auditoriya. Timur, Chilonzor filiali, Python ikkinchi yil, olimpiadachilarni tayyorlaydi 12-14. Zuhra bilan solishtiring:

./CLAUDE.md · mars-lessons/python-olymp-12-14# Mars IT School — Python olimpiada 12-14 yoshli guruh uchun
# Chilonzor filiali, mentor Timur

## Bu kodni kim o'qiydi
- 12-14 yoshli bolalar, Python ikkinchi yil, Respublika
  informatika olimpiadasiga tayyorlanmoqda.
- Tushuntirish tili: rus tili. O'zgaruvchilar nomlari — inglizcha
  (olimpiada ingliz tilida, boshqacha o'rganishning ma'nosi yo'q).
- Bilishadi: funksiyalar, tsikllar, lug'atlar, generatorlar.
  Bilmaydilar: klasslar, dataclasses, async.

## Kod konvensiyalari
- To'liq tipizatsiya: `def solve(n: int) -> list[int]:` — signaturalarni
  o'qishni o'rgatamiz.
- Murakkab algoritmlar — albatta `doctest` yoki `assert`
  masala shartidan misol bilan.
- Yechim `./tests/` dagi testlardan o'tishi kerak (`pytest`).
- Har bir fayl docstring bilan boshlanadi: vazifa, cheklovlar,
  vaqt/xotira bo'yicha murakkablik.
- `math`, `collections`,
  `itertools`, `heapq`, `bisect` dan tashqari uchinchi tomon kutubxonalarini ishlatmaslik — olimpiada to'plami.

## Workflow
- Commit qilishdan oldin — `pytest -q` (hammasi yashil).
- Yechimlar `./solutions/` da, testlar `./tests/` da.

Zuhra uchun — tipizatsiya va list comprehensions taqiqlangan, Timur uchun — majburiy tipizatsiya. Bir shablon, ikki xil shartnoma. Uchinchi shablon — Shahzod, Sergeli, React/TypeScript 15-17 — faylda yonma-yon joylashgan starters.md. Birini namuna sifatida oling va o'z guruhingizga moslashtiring.

Sizga kerak bo'lgan ikkita fayl. User va project.

CLAUDE.md ikki darajada yashaydi va boshlash uchun aynan shu ikkitasi sizga kerak. Ikkalasi ham har bir sessiya boshida avtomatik ravishda yuklanadi — qayta tushuntirish shart emas.

Hozircha oʻtkazib yuborish mumkin boʻlgan yana ikkita daraja bor: managed (butun maktab uchun qoida, IT tomonidan oʻrnatiladi — bizda hozircha boʻsh) va local (./CLAUDE.local.md — loyiha boʻyicha shaxsiy eslatmalar, .gitignore). Keyinroq kerak boʻladi — bugun emas.

Claude oʻzi ham eslatmalar yozadi

Sizning CLAUDE.md faylingizdan tashqari, agent oʻzi jarayon davomida sezgan narsalarni yozib boradi: qaysi buyruqlar loyihani yigʻadi, qayerda xatolar boʻlgan, kodingizda qanday patternlar bor. /memory buyrugʻi barcha xotira fayllarini koʻrsatadi va ularni ochishga imkon beradi. Bu qoʻshimcha, oʻrnini bosuvchi emas: CLAUDE.md — u har doim bilishini sizxohlagan narsangiz; avto-xotira — oʻzi tushungan va eslab qolgan narsa.

Mashq. Bugun sinab koʻring, 30 daqiqa.

Toʻrt qism. Terminalda qoʻlda bajaring, nazariya sifatida oʻqimang. Shundan soʻng sizda ishlaydigan user+project CLAUDE.md juftligi va tekshirilgan /memory.

~/.claude/CLAUDE.md# Oʻzim haqimda
Men Mars IT School mentori, nuqta <X>,
<stek> ni <Y> yosh uchun olib boraman.
Ish tili: rus tili. Texnik terminlar uchun ingliz tili.

# Agent bilan ishlash uslubi
- Fayllarni tahrirlashdan oldin menga reja haqida tushuntirib ber
  (oʻrinli boʻlsa plan mode'dan foydalan)
- Agar API/kutubxona haqida ishonching komil boʻlmasa — soʻra, oʻylab topma
- Bolalar uchun kod yozayotganingda —
  qisqa qatorlar, oddiy nomlar, rus tilida kommentariyalar
- commit qilishdan oldin har doim git diff'ni koʻrsat, oʻzing commit qilma

# Men odatda nima qilaman
- Mashgʻulotlar uchun starter-loyihalarni tayyorlayman
- Oʻquvchilarning kodini tekshiraman
- Mars uchun ichki skriptlar yozaman

Quiz. Nima kirganini tekshir.

Keyingi nima. 4-modul — context engineering.

Endi sening doimiy imzong bor — Mars’dagi har qanday loyihada agent sening kimligingni va kim uchun yozayotganingni biladi. Keyingi majburiy modul — to‘rtinchi (2-3-modullar fikr-mulohazadan keyin keladi): working memory va context engineering haqida. /compact nima, nega agent uzoq sessiya oxirida «ahmoqlashadi», context’ni izolyatsiya qilish usuli sifatida sub-agent’lardan qanday foydalanish kerak. Bu kurs mavjud bo‘lishining sababi bo‘lgan modul.

2-3-modullar (Delegation × NTP, Description × Knowledge) va 5-modul (o‘z Sub-agent’lari va Agent Skills) — birinchi mentorlardan pilot fikr-mulohazadan keyin.