Agent bilan shartnoma. CLAUDE.md sizning doimiy imzongiz sifatida.

Mars mentorlari uchun kursning birinchi moduli. AI bilan chat haqida emas — agentic coding tool: terminalda Claude Code, MarsCode (bizning fork), va nima uchun loyihadagi bitta markdown-fayl hamma narsani o'zgartiradi.

2024 va 2026. Boshqa toifadagi vosita.

Bu modulda — agentic coding tool nima ekanligi, u chatdan qanday farq qiladi va o'zingizning birinchi CLAUDE.md (foydalanuvchi darajasida va Mars loyihasida) qanday yozish kerakligi, shunda har bir sessiyada agentga kimligingizni va kim uchun kod yozayotganingizni tushuntirishni to'xtatasiz.

Mental model. Agentic coding tool nima.

Anthropic buni bir jumla bilan ta'riflaydi:

Chatdan asosiy farqi — loop of tool calls, bitta replika emas. Siz vazifani yozasiz. Model hal qiladi: “avval faylni o‘qiyman”. Read vositasini chaqiradi. Tarkibini oladi. Keyin o‘ylaydi. Hal qiladi: “endi tahrirlayman”. Editni chaqiradi. Keyin testlar uchun Bash. Va shu tarzda vazifa yopilmaguncha yoki sizga savol tug‘ilmaguncha davom etadi.

Har bir pastga qarab strelka — bu modelning yangi chaqiruvi. Katta vazifalarda ularning soni o‘nlab bo‘ladi. Siz buni TUI’da yarim shaffof oqim sifatida ko‘rasiz: Reading src/auth.py, Editing tests/test_login.py, Running pytest.

Surfaces — agent yashaydigan joy

Claude Code bitta oynaga bog‘lanmagan. Bu bir xil konfiguratsiya (CLAUDE.md, settings, MCP) bir nechta surface’larda. Vazifaga qarab tanlaysiz, odatga qarab emas.

MarsCode — bizning fork’imiz

Mars o‘z agentini ushlab turadi — MarsCode, fork of sst/opencode. OpenAI-mos API, Mars Token Factory orqali ishlaydi — bu bizning Mars coin’larida hamyoni bo‘lgan LLM-proksi. Nima uchun fork: Anthropic-only stek o‘quvchilarga ommaviy tarqatishda qimmat, MarsCode token-factory orqali arzon modellarga yo‘naltiriladi. Mentorlarga balans beramiz.

MVP-kursda biz Claude Code (baseline, Anthropic hujjatlari 100% qamrab oladi) bo‘yicha o‘rgatamiz. MarsCode — hozircha eslatma, 5-modulda (o‘z Skill’larimizni qurayotganimizda va tejashni istaganimizda) o‘tish.

Codex (OpenAI), Antigravity (Google) — xuddi shu toifadagi parallellar. Kursda o‘rgatmaymiz, lekin mentorlar nomlarini eshitishlari kerak. Agar o‘quvchi “Codex haqida nima deysiz” deb so‘rasa — bu xuddi shu tool use loop, boshqa vendor.

Demo. CLAUDE.mdsiz va u bilan.

Keys: mentor Zuhra, Yunusobod nuqtasi, Python 7-9 yoshli guruh, 6 bola. Starter-proyektlar repoda Claude Code’ni ochadi. Bir xil narsani so‘raydi. Avval kontraktlarsiz, keyin — u bilan.

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

> o‘quvchilarim uchun yana bitta
  matematika o‘yinini qo‘shishga yordam bering

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

  1. O‘quvchilarning yoshi nechida?
  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 yana bitta
  matematika o‘yinini qo‘shishga yordam bering

Claude: Loyiha uslubida "Sonni top" starterini yarataman:

  • pygame + random, f-stringsiz
  • o'zgaruvchilar rus-lotin tilida
  • har 2 qatorga izoh
  • qisqa sarlavha "Bu dastur
    nimani bajaradi"

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

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

# Natijaga 40 soniya qoldi.

7-9 yoshli Python guruhi uchun CLAUDE.md loyihasi

Mana Zuhra repoda turgan fayl. Uni starter sifatida nusxalab oling — bu uchta tayyor pre-build shablonlaridan biri:

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

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

## Kod konvensiyalari
- **Har bir qator rus tilida izohlanadi.** Bu sotish 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 kerak.
- Fayl har doim "Bu dastur nimani bajaradi" degan qisqa izoh bilan
  1 qatorda boshlanadi.

## 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 tahrirlamang — u yerda keyingi guruhlar uchun tayyor yechimlar mavjud.

Boshqa mentor — boshqa shartnoma

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

./CLAUDE.md · mars-lessons/python-olymp-12-14# Mars IT School — 12-14 yoshli guruh uchun Python olimpiadasi
# 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 — ingliz tilida
  (olimpiada ingliz tilida, boshqacha o'rganishning ma'nosi yo'q).
- Bilishadi: funksiyalar, tsikllar, lug'atlar, generatorlar.
  BILMASLIGI KERAK: 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: masala, cheklovlar,
  vaqt/xotira bo'yicha murakkablik.
- `math`, `collections`,
  `itertools`, `heapq`, `bisect` dan tashqari uchinchi tomon kutubxonalarini ishlatmaslik kerak — 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.

Ierarxiya. Managed, user, project, local.

CLAUDE.md bir nechta joyda yashaydi. Har bir daraja — o'z scope'i. "Kengdan torga" tartibida yuklanadi va kontekstga birlashtiriladi. Torroq scope oldindagisini to'ldiradi, va ziddiyat yuzaga kelsa odatda g'alaba qozonadi — chunki u kontekstda oxirgi bo'lib paydo bo'ladi va model uni dolzarbroq deb biladi.

@-import: boshqa fayllarni tortib olamiz

CLAUDE.md boshqa fayllarni @path sintaksisi orqali qoʻshishni biladi. Rekursiya chuqurligi — 4 darajagacha. README, package.json, boshqa repozitoriyadan konvensiyalar yoki home’dan shaxsiy preferensiyalarni tortib olish kerak boʻlganda qulay.

./CLAUDE.md · fragment# Project overview
See @README.md for context and @package.json for npm scripts.

# Git workflow
- @docs/git-instructions.md ga amal qil
- mening shaxsiy preferensiyalarim: @~/.claude/my-mars-preferences.md

AGENTS.md — turli agentlar uchun umumiy fayl

Claude Code CLAUDE.mdni oʻqiydi, AGENTS.mdni emas. Lekin AGENTS.md — bu turli AI-agentlar uchun format (2026 yilga kelib — Cursor, opencode, MarsCode va boshqalar, qayta tekshirish kerak): bitta fayl bilan bir nechta vositani sozlash mumkin. Agar repoda allaqachon AGENTS.md mavjud boʻlsa, import orqali ustiga yupqa CLAUDE.md qilamiz:

./CLAUDE.md · AGENTS.md ustidan@AGENTS.md

## Claude-specific
- Use plan mode for changes under `src/billing/`.

Shunda Claude AGENTS.md ni oʻz shartnomasining bir qismi sifatida oʻqiydi va oʻz nuanslarini qoʻshadi. Mars uchun: MarsCode-fork faol ishda ekan — AGENTS.md yozib, CLAUDE.md → @AGENTS.md qilish, toki ikkala vosita ham bitta faylga qarasin.

Alternativa — simlink (ln -s AGENTS.md CLAUDE.md). Ishlaydi, lekin Windowsda Developer Mode talab qiladi. Import ishonchliroq.

Auto memory — Claude oʻzi nima yozadi

Qoʻshimcha ravishda agentning oʻzi ~/.claude/projects/<project>/memory/MEMORY.mdda eslatmalar yuritadi. Build buyruqlari, debug insights, sen bilan ishlashda sezgan naqshlar. Har bir sessiyada dastlabki 200 qator (yoki 25KB) avtomatik ravishda yuklanadi.

Bu CLAUDE.md ni toʻldiradi, oʻrnini bosmaydi. CLAUDE.md — bu sen agent har doim bilishini istagan narsa. Auto memory — bu uning oʻzi ish jarayonida bilib olgan va eslab qolishga qaror qilgan narsa. /memory buyrugʻi ikkalasini ham koʻrsatadi va tahrirlash uchun ochish imkonini beradi.

Mashq. Bugun sinab koʻr, 30 daqiqa.

Toʻrt qism. Terminalda qoʻlda bajar, nazariya sifatida oʻqima. Shundan soʻng sening ishlaydigan user+project CLAUDE.md juftliging va tekshirilgan /memory.

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

# Agent bilan ishlash uslubi
- Fayllarni tahrirlashdan oldin menga rejani tushuntiring
  (o'rinli bo'lganda plan mode'dan foydalaning)
- Agar API/kutubxonaga ishonchingiz komil bo'lmasa — so'rang, o'ylab topmang
- Bolalarga mo'ljallangan kod yozayotganda —
  qisqa qatorlar, oddiy nomlar, rus tilida kommentariyalar
- Commit qilishdan oldin har doim git diff'ni ko'rsating, o'zingiz commit qilmang

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

Quiz. Nima kirganini tekshiring.

Keyingisi. 4-modul — context engineering.

Endi sening doimiy imzong bor — Mars’dagi har qanday loyihada agent sen kimsan va kim uchun yozayotganingni biladi. Keyingi majburiy modul — toʻrtinchi (2-3-modullar fikr-mulohazadan keyin keladi): working memory va context engineering haqida. Bu nima /compact, nega agent uzoq sessiya oxiriga borib «ahmoqlashadi», sub-agentlardan kontekstni ajratish usuli sifatida qanday foydalanish kerak. Bu kurs aynan shu modul uchun mavjud.

2-3-modullar (Delegation × NTP, Description × Knowledge) va 5-modul (o‘z Sub-agentlari va Agent Skills) — birinchi mentorlardan olingan pilot fikr-mulohazadan so‘ng.