mirror of
https://github.com/walkinglabs/learn-harness-engineering.git
synced 2026-09-19 05:06:27 +08:00
devtulkin
414b3e471a
Adds a complete Uzbek (Latin script) translation under docs/uz/, following the existing multilingual pattern (en/zh/ko/vi/ru). Discussed with @sanbuphy in advance — contribution welcomed. Scope: - 12 lectures (full prose + code-sample docs) - 6 projects (overview pages) - Resources: templates, reference, openai-advanced pack - Skills overview - VitePress config: registered uz locale (nav, sidebar, outline labels) Translation discipline: - Uzbek Latin orthography normalized (oʻ/gʻ U+02BB, ʼ U+02BC, curly quotes “…” in prose, straight " inside HTML/mermaid syntax) - Project-wide glossary (docs/uz/GLOSSARY.md) — ~80 technical terms with consistent renderings; explicit anti-calque list for common idiom traps - Style guide (docs/uz/STYLE-GUIDE.md) — orthography rules, capitalisation conventions, common spelling pitfalls - Helper scripts under scripts/ to enforce orthography and spot-check terminology drift All 12 lectures went through translate → manual review → LQA review cycles with extensive native-speaker feedback applied. Note: feedback is welcome on terminology choices, especially for Uzbek renderings of newer terms (sprint contract, evaluator rubric, isometric model control, etc.). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
Uslub xaritasi (Method Map)
Ushbu jadval kod yozuvchi agentlarning uzoq davom etadigan muvaffaqiyatsizliklarini (failure modes) asosan ularni birinchi boʻlib hal qiluvchi artefakt yoki ishlash qoidalari (operating rule) bilan bogʻlaydi.
| Muvaffaqiyatsizlik rejimi (Failure mode) | Amaliyotda bu qanday koʻrinadi | Asosiy yechim | Yordamchi artefakt |
|---|---|---|---|
| Sovuq ishga tushishdagi chalkashlik (Cold-start confusion) | Yangi sessiya oʻz vaqtining asosiy qismini sozlamalar va holatni oʻrganishga sarflaydi | Repozitoriyni yagona haqiqat manbaiga (system of record) aylantiring | claude-progress.md |
| Skoupning yoyilib ketishi (Scope sprawl) | Agent bir nechta funksiyalarni boshlaydi va birortasini ham toza tugatmaydi | Faol ish koʻlamini (scope) cheklang | feature_list.json |
| Vaqtidan oldin tugatish (Premature completion) | Agent kod tahrirlangandan keyin, lekin ishlashga doir dalilsiz (runnable proof) yakunlanganini eʼlon qiladi | Tugatishni dalil bilan bogʻlang | clean-state-checklist.md |
| Moʻrt ishga tushish (Fragile startup) | Har bir sessiya loyihani qanday ishga tushirishni (boot) qaytadan oʻrganadi | Oʻrnatish va tekshirishni (verification) standartlashtiring | init.sh |
| Kuchsiz topshirish (Weak handoff) | Keyingi sessiya nima tasdiqlanganini, buzilganini yoki keyingi nima ekanini bilolmaydi | Aniq topshiriq xati (handoff) bilan tugating | session-handoff.md |
| Subyektiv baholash | Sifatni baholash did yoki xotiraga tayanib qoladi | Natijalarni belgilangan kategoriyalar boʻyicha baholang | evaluator-rubric.md |
Ishlash tamoyili (Operating Principle)
Kuzatilgan muvaffaqiyatsizlik (failure mode) ni bevosita hal qiladigan eng kichik artefaktni qoʻshing. Barcha ishonchlilik muammolarini bitta global yoʻriqnoma fayliga juda koʻp matn tiqish orqali hal qilishdan qoching.