Довідник

27 конвенцій, відточених вручну

Наша філософія та що покриває бібліотека конвенцій.

Філософія

Ми відштовхуємося від того, як насправді ламається згенерований ШІ код: мовчазні any-типи, проковтнуті помилки, недопустимі стани, досяжні через необов’язкові поля, рантайм-збої через невалідований ввід. Кожне правило написане так, щоб відштовхнути модель від одного з цих сценаріїв збою — і залишається в бібліотеці, лише якщо помітно покращує код, який пишуть агенти.

Кожне правило коротке, з чіткою позицією та самодостатнє. Ваш агент читає одне з них тоді, коли збирається зробити відповідну зміну — а не всі одразу на початку сесії. Це означає менші промпти, менші рахунки та правила, які модель справді здатна тримати в робочій пам’яті, поки пише код.

Що в бібліотеці

Поточна бібліотека містить 27 конвенцій, що покривають ділянки, де згенерований ШІ TypeScript найчастіше дає збій: суворість типів, обробка помилок, рантайм-валідація на межах довіри, іменування та структура модулів, потік керування, а також патерни конкретних фреймворків (наприклад, форма props React-компонентів, конвенції моделей Prisma).

Конкретні правила доступні підписникам через MCP-сервер — повний перелік ми тут не публікуємо. Оформіть підписку, щоб отримати доступ до корпусу.

Оновлення

Ми додаємо й уточнюємо конвенції в міру того, як розвиваються інструменти та поведінка моделей. Оновлення доходять миттєво: вам нічого не треба передеплоювати. Про значні зміни ми повідомляємо підписникам електронною поштою.