Modelith: Kod bilan Gaplashish Yo'li

Keling, rost bo'laylik — ko'pchilik loyihalar yaxshi niyat bilan boshlanadi. Kimdir doskada domain model chizadi, hamma boshini chachgartadi, keyin... hujjatlar tizimida unutilib qoladi.

Muammo domain modeling g'oyasida emas. Asl muammo shunda:

• Bir marta yoziladi va unutiladi
• Koddan alohida saqlanadi
• Maxsus toollarsiz o'qib bo'lmaydi
• Avtomatik tekshirish qiyin

Modelith boshqacha yondashadi. Domain modelni bir marta yozib arxivga qo'yadigan narsa sifatida emas, balki kod yanayingizda yashaydigan, suhbat orqali yoziladigan va CI'da avtomatik tekshiriladigan tirik artifact sifatida ko'radi.

Domain Model Deganda Nima Tushuniladi?

Domain model — bu sizning sistemanizing konseptual xaritasi. Entitylar (nouns), ularning bog'lanishlari, va qoidalar. Bu database schema emas, API spec emas. Bu sizning sistemanizing oddiy tilda yozilgan kanonik ifodasi.

Buni butun jamoa foydalanadigan lug'at sifatida tasavvur qiling. Hammasi bir modeldan o'qisa, muloqotlar aniq bo'ladi, yangi odamlarni o'rgatish tezlashadi, yangi servicelarni qo'shish esa qadimgi kodni qazishga aylanmaydi.

Modelith Ishlash Tartibi: Tavsifla, Yarat, Tekshir, Ko'rsat

Bu yerda qiziq qismi boshlanadi. Modelith'da siz YAML yozmaysiz. Hatto YAML haqida o'ylamaysiz ham. Oddiy tilda domain tushunchalarini AI agentga aytasiz, agent esa siz uchun YAML yaratadi.

Jarayon shunaqa ko'rinadi:

1. Tavsifla — Siz domain haqida oddiy ingliz tilida gapirasiz. "Bizda mijozlar bor, ular buyurtma berishi mumkin, buyurtmada bir nechta mahsulot bo'ladi, lekin mijozda faqat uchta active buyurtma bo'lishi mumkin."

2. Yarat — Claude Code plagini sizning tavsifingizni modelith.yaml faylga aylantiradi, tekshirib boradi.

3. Tekshir — modelith lint buyrug'ini ishga tushiring. Bu CI gate sifatida ishlaydi.

4. Ko'rsat — modelith render buyrug'i Markdown va Mermaid diagramlar yaratadi. Buni YAML bilan birga commit qiling.

Render qilingan Markdown — maxsus toolshiz o'qisa bo'ladigan hujjat. YAML — mashina o'qiydigan haqiqat manbai. CI esa ularning bir-biridan uzoqlashmasligini ta'minlaydi. Bu generated code tekshirishga o'xshaydi, lekin domain model uchun.

Nima Uchun Bu Yondashuv Ishlaydi

Oddiy til to'siqni past qiladi

Har kim JSON Schema yoki UML diagram o'qiy olmaydi. Lekin har kim oddiy ingliz tilni o'qiydi. Modelith domain modelingni demokratlashtiradi. Sizning product manageringiz hissa qo'shishi mumkin. QA injeneringiz tekshira oladi. Junior developeringiz umumiy manzarani tushunadi.

AI zerikarli ishlarni oladi

Qo'lda YAML yozish — xatoga yo'l qo'yish oson va zerikarli. AI agentga tavsifingizdan to'g'ri YAML yaratishni ishonib qo'ysangiz, fikr yuritish og'irligini yuklab olishingiz mumkin, aniqlikni yo'qotmaysiz.

CI tekshirishi siljishishga yo'l qo'ymaydi

Bu jamoalar uchun asosiy xususiyat. Domain modelingiz development workflow'da to'liq ishtirok etadi. Domainni o'zgartiradigan har bir PR avtomatik tekshiriladi. Kimdir YAML'ni yangilab, docs'ni qayta generatsiya qilishni unutsa, CI tutadi.

Model kod yanida qoladi

Domain modelingiz kod bilan birga repository'da bo'lsa, u dolzarb qoladi. PR'larda ko'riladi. Feature'lar o'zgarganda yangilanadi. Boshqa tizimda eskirgan hujjat bo'lib qolmaydi.

Boshlash

Modelith o'rganish oson qilib yaratilgan. Hammasini birdaniga tushunish shart emas. Kichik boshlashingiz mumkin:

• Claude Code plaginini o'rnating
• Domain'dan bir nechta asosiy tushunchani tavsiflang
• AI'ga YAML draft qilishiga ruxsat bering
• modelith lint ishga tushiring, nimaga kamchilik borligini ko'ring
• Takrorlang

Loyihada misollar bor — parking garaj misoli yaxshi boshlang'ich nuqta.

Kattaroq Rasm

Modelith — AI-assisted development'dagi kengroq trendning namoyonishi: tabiiy til interfeys qatlami, mashinani o'qiydigan artifactlar esa ostida. Siz o'zingiz xohlaganni yozasiz, tooling esa mos kelish va tekshirishni ta'minlaydi.

Murakkab sistemalar qurayotgan jamoalar uchun — ayniqsa vocabularу muhim bo'lgan sohalarda (fintech, healthcare, logistics, business rules ko'p bo'lgan joylarda) — bu yondashuv o'zgartiruvchi bo'lishi mumkin. Umumiy, tekshiriladigan, tirik domain model — kamroq tushunmovchilik, tezroq o'rgatish, yaxshiroq dizayn.

Tool hali rivojlanmoqda, lekin asosiy g'oya puxta. Domain modelingiz kickoff'dan qolgan eski hujjat bo'lmasligi kerak. U kod bilan birga rivojlanadigan tirik hujjat bo'lishi kerak, suhbat orqali yoziladigan, CI'da avtomatik tekshiriladigan.

Agar domain modelarni loyihalaringizda dolzarb qilishga qiynalgan bo'lsangiz, Modelith'ni ko'rib chiqishga arzigulik. Ba'zan eng yaxshi tooling — eng kuchli emas, balki to'g'ri xulq-atvorni eng oson qiladigan tool.

modelith.sh saytini ko'rib chiqing.