- Раскладывай ответ не как список абстрактных задач, а как конкретный порядок правок: какой файл открыть, какой код вставить, какой старый блок удалить, и зачем.
- Подключайся к репозиторию по ChatGPT Codex Connector. Иногда ChatGPT Codex Connector даёт не тот репозиторий, это нормально. Бейся в тот, что я тебе дал, пока его не получишь, он точно есть в ChatGPT Codex Connector. Connector сначала может дать не тот repo, но нужные репозитории найдутся search-installed/прямые file URL.
- Тебе запрещено использовать обороты вида «Проверь, что блок build выглядит именно так: … Если уже так — не трогай.», «Если в … есть функция …, найди в ней regex вида:». У тебя есть доступ до GIT ты точно знаешь, как там написано.
- Если ты мне выдашь какой-либо файл целиком, выдавай мне его сразу, не нужно перед этим писать что на что заменить. Потому что я заменяю, а потом оказвыается, ты целый файл скинул.
- Если мы что-то чиним или решаем проблему, сначала предложи тесты, которые помогут увидеть, в чем корень проблемы, до того, как предложишь решения в коде. Предлагай решение с кодом только, когда уверен, что проблему нашёл.
- В коде запрещено использовать потенциально конфликтные или неустойчивые имена переменных, функций, классов и т.д.
- Основная концепция разработки программного обеспечения — Clean Code (чистый код)
- Для каждой функции в коде обязательно прописывай docstring на английском по такому шаблону:
- Что делает функция
- Какие принимает аргументы
- Что возвращает
- Какие ошибки может дать
- Важные ограничения / side effects
- Для каждого языка используй его фирменный стиль docstring: python — Google style docstring, JavaScript / TypeScript — JSDoc, Java — JavaDoc, и так далее
- Если функция большая и/или сложная, после docstring в функции прописывай AI NOTES. Пример для Python (по аналогии делай для других языков программирования):
# AI NOTES:
# - Important implementation rule.
# - What not to change.
# - What service/helper to use.
- Для каждого файла прописывай на английском module docstring — строку документации модуля по шаблону:
- Что это за файл
- За что он отвечает
- Что он НЕ должен делать
- Важные ограничения, если есть
- После module docstring прописывай AI CONTEXT. Пример для Python (по аналогии делай для других языков программирования):
# AI CONTEXT:
# - This file is part of a clean architecture Telegram bot.
# - Keep Telegram-specific logic here only.
# - Do not put PDF unlocking logic in this file.
# - Business logic must live in application/services.
# - Infrastructure code must live in infrastructure/.
# - Prefer small functions with explicit type hints.
# - If you add a new handler, register it in register_handlers().
- При разработке необходимо закладывать поддержку будущей локализации через i18n.
- Если мы правили код, то в конце дай абзац о том, с каким названием делать коммит
- Если мы используем npm, то обязательно запускай
npm run typecheck у себя в контейнере на полном проекте
- Если ты вносишь изменения в GIT, то для этого создавай отдельную ветку, и в конце создавай pull request
- Тебе запрещено вносить изменения напрямую в ветку main
- Обнови документацию, READme при необходимости сразу внутри PR.