Границы задачи
Опишите поведение, которое должен получить пользователь, и способ его проверить.
Проверено 9 ноября 2026 г.Стандарты
AI-разработки
Понятные правила для людей и AI-агентов. С примерами, причинами и условиями применения.
Разница видна сразу
Одна ситуация. Два подхода. Понятная причина.
HTTP-статусы
Плохо
HTTP/1.1 200 OK
Content-Type: application/json
{"status": 404, "message": "Не найдено"}
Хорошо
HTTP/1.1 404 Not Found
Content-Type: application/problem+json
{"type":"about:blank","title":"Не найдено","status":404}
Поле status в JSON допустимо. Оно дополняет HTTP-статус и совпадает с ним.
Выберите раздел
15Основы и архитектура
Как договориться о результате и устройстве проекта.
Работа с AI-агентами
Контекст, полномочия и проверка результата ИИ.
Совместная разработка
Как людям и агентам менять проект вместе.
Базы данных
Идентификаторы, связи, данные и безопасные изменения.
API
Понятные запросы, честные статусы и совместимость.
Backend
Бизнес-правила, ошибки и работа сервера.
Frontend
Компоненты, серверные данные и границы выполнения.
Фреймворки и CMS
Laravel, 1С-Битрикс, Bitrix24 и другие платформы: правила и примеры применения.
Интеграции
Внешние сервисы, OAuth, MCP и файлы.
Кеш и фоновые задачи
Свежесть данных, очереди и безопасные повторы.
Безопасность
Права, секреты и защита данных.
Тестирование
Проверки, которым можно доверять.
Выпуск и эксплуатация
Релизы, наблюдение и восстановление.
Мобильные приложения
Хранение, офлайн-работа и обновления.
Платежи
Подтверждение оплаты и точность состояния денег.
С чего начать
Технологии и платформы
Правила для вашего стека
Laravel
PHP-фреймворк
3 правила →
1С-Битрикс
CMS · Bitrix Framework
3 правила →
Bitrix24
CRM · REST API
2 правила →
React
UI-библиотека
6 правил →
Next.js
React-фреймворк
3 правила →
Vue
UI-фреймворк
2 правила →
Nuxt
Vue-фреймворк
1 правило →
SvelteKit
Web-фреймворк
1 правило →
Django
Python-фреймворк
1 правило →
FastAPI
Python-фреймворк
2 правила →
NestJS
Node.js-фреймворк
1 правило →
WordPress
CMS
1 правило →
PostgreSQL
База данных
6 правил →
Redis
Хранилище данных
2 правила →
TypeScript
Язык
5 правил →
Python
Язык
5 правил →
Go
Язык
5 правил →
PHP
Язык
7 правил →Человек и AI-агент
Человек
Цель, бизнес-ограничения, полномочия и приёмка результата.
AI-агент
Исследование, реализация, проверки и отчёт с доказательствами.
В каждом правиле — отдельные действия для обеих ролей.
Правила 111
Единый источник истины
Сайт, документация и инструкции агента должны собираться из одного оригинала.
Проверено 9 ноября 2026 г.Контракты компонентов
Опишите вход, выход, ошибки и права, когда несколько частей системы взаимодействуют.
Проверено 9 ноября 2026 г.Вертикальный сценарий
Связывайте интерфейс, данные и проверки небольшими законченными изменениями.
Проверено 9 ноября 2026 г.Зависимости проекта
Новый сервис или пакет должен решать измеримую задачу и иметь понятную поддержку.
Проверено 9 ноября 2026 г.Критерии готовности
Разделяйте готовый шаблон, работающий сервис и реально выполненные проверки.
Проверено 9 ноября 2026 г.Контекст проекта
Инструкции проекта должны объяснять активный стек, важные ограничения и команды проверок.
Проверено 9 ноября 2026 г.Prompt injection
Страница, письмо или комментарий могут содержать команды злоумышленника.
Проверено 9 ноября 2026 г.Минимальные привилегии
Разрешения инструмента должны соответствовать действию, которое поручил пользователь.
Проверено 9 ноября 2026 г.Полномочия агента
Перед оплатой, удалением или публикацией должны быть понятны точные данные и полномочия.
Проверено 9 ноября 2026 г.Доказательства выполнения
Отчёт агента должен отражать фактический ответ системы и выполненные проверки.
Проверено 9 ноября 2026 г.Pull request
Ревьюеру проще проверить изменение с одной целью и воспроизводимой проверкой.
Проверено 9 ноября 2026 г.Распределение изменений
Договоритесь, кто меняет общий контракт и какие файлы затрагивает каждый участник.
Проверено 9 ноября 2026 г.Рабочее дерево Git
Перед началом проверьте рабочее дерево и отделите собственные изменения.
Проверено 9 ноября 2026 г.Code review
Ревью должно находить нарушения требований, а не только обсуждать стиль.
Проверено 9 ноября 2026 г.Передача результата
В конце задачи укажите, что изменилось, как проверено и что осталось неизвестным.
Проверено 9 ноября 2026 г.Architecture Decision Record
Сохраните причину выбора, альтернативы и последствия там, где их найдёт команда.
Проверено 9 ноября 2026 г.Идентификаторы: UUID и bigint
UUID удобен для независимого создания записей и публичных идентификаторов. Имя поля и его тип — разные решения.
Проверено 9 ноября 2026 г.Имена таблиц и полей
Из имени поля должно быть понятно, какую связь оно хранит.
Проверено 9 ноября 2026 г.Ограничения целостности
Проверка в приложении не защищает от конкурирующих запросов и другого клиента БД.
Проверено 9 ноября 2026 г.Внешние ключи
Внешний ключ не позволяет хранить ссылку на несуществующую запись.
Проверено 9 ноября 2026 г.Транзакции
Связанные операции должны завершиться вместе или вместе отмениться.
Проверено 9 ноября 2026 г.Миграции схемы
Выпускайте несовместимые изменения в несколько совместимых этапов.
Проверено 9 ноября 2026 г.Индексы PostgreSQL
Индекс ускоряет выбранное чтение и увеличивает стоимость записи.
Проверено 9 ноября 2026 г.Дата и время: timestamptz
Момент времени и местное расписание — разные данные. PostgreSQL `timestamptz` хранит момент, но не исходное название часового пояса.
Проверено 9 ноября 2026 г.JSONB и реляционные поля
Поля, участвующие в доступе, связях и частом поиске, нуждаются в явной модели.
Проверено 9 ноября 2026 г.История и удаление данных
Мягкое удаление, история версий и аудит решают разные задачи.
Проверено 9 ноября 2026 г.HTTP-статусы
Клиент, прокси и мониторинг должны видеть результат запроса без разбора произвольного JSON.
Проверено 9 ноября 2026 г.HTTP-методы
GET и HEAD читают; изменение бизнес-состояния должно иметь соответствующий метод.
Проверено 9 ноября 2026 г.Problem Details
Ошибка должна помогать исправить запрос без раскрытия внутреннего устройства сервера.
Проверено 9 ноября 2026 г.OpenAPI-контракт
В контракте должны быть реальные методы, схемы, ошибки, доступ и примеры.
Проверено 9 ноября 2026 г.Идемпотентность API
После потери ответа повторный запрос не должен создавать вторую оплату или заказ.
Проверено 9 ноября 2026 г.Оптимистическая блокировка
Проверяйте версию записи перед сохранением, если пользователь может перезаписать чужую работу.
Проверено 9 ноября 2026 г.Совместимость API
Удаление поля или изменение его смысла требует совместимости со старыми клиентами.
Проверено 9 ноября 2026 г.HTTP-заголовки
Статус, формат содержимого и кеширование описываются стандартными средствами HTTP.
Проверено 9 ноября 2026 г.Границы backend
Обработчик переводит запрос в вызов приложения, а доменная логика остаётся переиспользуемой.
Проверено 9 ноября 2026 г.Go context
Запрос к БД или внешнему сервису должен завершаться при отмене родительской работы.
Проверено 9 ноября 2026 г.Обработка ошибок
Сохраняйте причину ошибки внутри системы и возвращайте безопасное объяснение наружу.
Проверено 9 ноября 2026 г.Ограничение параллелизма
Каждая запущенная задача должна иметь предел, отмену и понятное завершение.
Проверено 9 ноября 2026 г.Валидация типов
Типы помогают разработчику, а проверка входа защищает работающую систему.
Проверено 9 ноября 2026 г.Читаемость кода
Разделяйте независимые обязанности и сохраняйте объяснения неочевидных решений.
Проверено 9 ноября 2026 г.Server и Client Components
В Next.js загружайте серверные данные на сервере, а интерактивные части выделяйте отдельно.
Проверено 9 ноября 2026 г.Серверные данные
Общий клиент или серверный модуль должен задавать типы, ошибки и политику кеша.
Проверено 9 ноября 2026 г.Производное состояние
Если значение полностью определяется текущими данными, вычислите его при отображении.
Проверено 9 ноября 2026 г.Черновики и серверное состояние
У полученных данных и редактируемой формы должны быть понятные владельцы.
Проверено 9 ноября 2026 г.Состояние в URL
Поиск и фильтры, которыми делятся, должны восстанавливаться по ссылке.
Проверено 9 ноября 2026 г.Состояния интерфейса
Пользователь должен понимать, идёт ли работа и как продолжить после сбоя.
Проверено 9 ноября 2026 г.Web performance
Оптимизируйте задержку, скачки макета и объём загрузки на целевых устройствах.
Проверено 9 ноября 2026 г.Тайм-ауты интеграций
У каждого сетевого вызова должен быть срок ожидания и понятный результат при сбое.
Проверено 9 ноября 2026 г.Retry и backoff
Повторы ограничиваются числом попыток, общим временем и возможностью дублирования действия.
Проверено 9 ноября 2026 г.OAuth и PKCE
Для делегированного доступа проверяйте получателя токена и связывайте ответ с начатой авторизацией.
Проверено 9 ноября 2026 г.Подпись вебхуков
Не считайте входящий JSON достоверным только потому, что он похож на событие провайдера.
Проверено 9 ноября 2026 г.Авторизация MCP
Описание инструмента помогает модели, но разрешение операции проверяет сервер.
Проверено 9 ноября 2026 г.Загрузка файлов
Имя и Content-Type от клиента не доказывают безопасность содержимого.
Проверено 9 ноября 2026 г.Источник истины кеша
Кеш ускоряет чтение и должен быть воспроизводим из основного источника.
Проверено 9 ноября 2026 г.TTL и инвалидация
Укажите допустимую задержку, ключ версии и поведение при недоступном источнике.
Проверено 9 ноября 2026 г.Изоляция кеша
Ключ кеша и HTTP-политика должны учитывать пользователя, организацию и права.
Проверено 9 ноября 2026 г.Идемпотентность worker
Повтор сообщения не должен повторять необратимый эффект.
Проверено 9 ноября 2026 г.Transactional outbox
Свяжите запись бизнеса и событие, чтобы сбой не потерял отправку.
Проверено 9 ноября 2026 г.Dead-letter queue
После ограниченных попыток сохраняйте причину и возможность безопасного разбора.
Проверено 9 ноября 2026 г.Управление секретами
Используйте управляемую конфигурацию и ограниченный доступ вместо ключей в репозитории.
Проверено 9 ноября 2026 г.SSRF-защита
Проверяйте адрес назначения, перенаправления, DNS и объём ответа.
Проверено 9 ноября 2026 г.Маскирование секретов в логах
Записывайте идентификаторы операций и безопасные признаки вместо полного содержимого.
Проверено 9 ноября 2026 г.Software supply chain
Фиксируйте воспроизводимый набор зависимостей и обновляйте его с проверками.
Проверено 9 ноября 2026 г.Лимиты ресурсов
У запросов должны быть пределы размера, частоты и сложности.
Проверено 9 ноября 2026 г.Тестирование по риску
Проверяйте наблюдаемое поведение, которое действительно может сломаться.
Проверено 9 ноября 2026 г.Регрессионные тесты
Для исправления бага полезно сначала воспроизвести неправильное поведение.
Проверено 9 ноября 2026 г.Интеграционные тесты
Изолированные тесты не заменяют проверки SQL, миграций и форматов взаимодействия.
Проверено 9 ноября 2026 г.End-to-end тесты
Небольшой набор сквозных тестов должен покрывать основные пользовательские действия.
Проверено 9 ноября 2026 г.Детерминизм тестов
Управляйте временем, случайностью и внешними зависимостями в тестах.
Проверено 9 ноября 2026 г.Correlation ID
Используйте идентификатор запроса и трассы, чтобы найти связанные события.
Проверено 9 ноября 2026 г.HTTP spans
В OpenTelemetry успешный HTTP-ответ обычно оставляет статус span неустановленным.
Проверено 9 ноября 2026 г.Observability
Каждый сигнал должен помогать обнаружить или объяснить проблему.
Проверено 9 ноября 2026 г.SLO и error budget
Определите, что считается успешным обслуживанием пользователя и за какой период.
Проверено 9 ноября 2026 г.Неизменяемый артефакт
Одна версия должна связывать исходники, сборку и работающий сервис.
Проверено 9 ноября 2026 г.Rollback
До переключения определите, как вернуть сервис и что произойдёт с данными.
Проверено 9 ноября 2026 г.Backup и restore
Резервная копия полезна, если из неё можно восстановить нужные данные за допустимое время.
Проверено 9 ноября 2026 г.Конфигурация окружения
Один модуль конфигурации должен проверять обязательные значения до приёма запросов.
Проверено 9 ноября 2026 г.Incident runbook
Дежурный должен знать, как оценить проблему, ограничить последствия и восстановить сервис.
Проверено 9 ноября 2026 г.Keychain и Keystore
Обычное локальное хранилище приложения не подходит для секретов.
Проверено 9 ноября 2026 г.Deep links
Ссылка должна соответствовать разрешённому маршруту и начатой операции.
Проверено 9 ноября 2026 г.Офлайн-синхронизация
Локальная очередь должна знать идентичность операции и версию изменяемой записи.
Проверено 9 ноября 2026 г.Мобильный релиз
Изменение нативных возможностей требует соответствующей сборки приложения.
Проверено 9 ноября 2026 г.Подтверждение оплаты
Возврат пользователя на страницу успеха не доказывает получение денег.
Проверено 9 ноября 2026 г.Платёжные события
Повторный или запоздалый вебхук не должен повторять списание и ломать состояние заказа.
Проверено 9 ноября 2026 г.Платёжные данные
Используйте платёжную форму или компоненты провайдера и храните его идентификаторы.
Проверено 9 ноября 2026 г.Платёжная сверка
Периодически находите несовпадения между локальной системой и провайдером.
Проверено 9 ноября 2026 г.Платёжные окружения
Используйте разные ключи, события и явную проверку окружения.
Проверено 9 ноября 2026 г.Деньги: bigint, numeric и валюта
Сумма хранится вместе с валютой и единицей измерения. Для расчётов используйте целые минимальные единицы или точный десятичный тип.
Проверено 9 ноября 2026 г.Laravel: Form Request и Policy
Валидируйте вход и отдельно проверяйте право на объект. В модель передавайте только разрешённые поля.
Проверено 9 ноября 2026 г.Laravel: транзакция и afterCommit
Задание, которое читает новую запись, отправляйте после фиксации транзакции.
Проверено 9 ноября 2026 г.Laravel: Eloquent и N+1
Загружайте нужные связи списком и ограничивайте размер выдачи.
Проверено 9 ноября 2026 г.1С-Битрикс: /local и расширения
Собственный код размещайте в /local, используя расширения и шаблоны компонентов.
Проверено 9 ноября 2026 г.1С-Битрикс: D7-транзакции
Связанные изменения БД фиксируйте одной транзакцией и проверяйте Result каждого вызова.
Проверено 9 ноября 2026 г.1С-Битрикс: ключ кеша и инвалидация
Ключ кеша должен различать варианты данных, а изменение источника — очищать соответствующий кеш.
Проверено 9 ноября 2026 г.Bitrix24: серверный вебхук
URL входящего вебхука содержит секрет доступа. Вызывайте Bitrix24 со своего сервера.
Проверено 9 ноября 2026 г.Bitrix24: лимиты и повтор запросов
Ограничивайте поток запросов к порталу и обрабатывайте коды ошибок Bitrix24.
Проверено 9 ноября 2026 г.Django: atomic и on_commit
Сохранение связанных объектов выполняйте атомарно; зависимое внешнее действие запускайте после commit.
Проверено 9 ноября 2026 г.FastAPI: async и блокирующий I/O
В async-обработчике используйте неблокирующий клиент. Обычный def-обработчик подходит для синхронной библиотеки.
Проверено 9 ноября 2026 г.NestJS: ValidationPipe и DTO
Runtime-валидация требует классов DTO с правилами. TypeScript-интерфейс не проверяет входящий JSON.
Проверено 9 ноября 2026 г.Vue: computed и производное состояние
Значение, выводимое из реактивных данных, вычисляйте через computed без побочных эффектов.
Проверено 9 ноября 2026 г.Nuxt: useAsyncData и SSR
Для данных страницы используйте SSR-aware composable с устойчивым ключом.
Проверено 9 ноября 2026 г.SvelteKit: server-only modules
Секреты и доступ к БД держите в серверных модулях; клиенту возвращайте только разрешённые поля.
Проверено 9 ноября 2026 г.WordPress: capabilities и nonce
Проверяйте право на действие и CSRF-защиту отдельно. Nonce не заменяет авторизацию.
Проверено 9 ноября 2026 г.Redis: persistence и восстановление
Настройте восстановление Redis в соответствии с ролью данных. Кеш и единственная копия задания требуют разных гарантий.
Проверено 9 ноября 2026 г.