# localzet/console: работа с кодом Семейство: PHP CLI. Общая принадлежность не разрешает перенос кода или публикацию закрытых компонентов. ## Рабочий цикл Общение — по-русски; комментарии в коде — краткие английские. Перед изменениями прочитай ближайшие вложенные AGENTS.md, проверь ветку, diff и индекс. Сохраняй чужой WIP; добавляй в commit только свои файлы/изменения. Коммиты — Conventional Commits, author и committer Ivan Zorin <[email protected]>. Push и deployment выполняй только в рамках текущего разрешения пользователя; этот файл сам по себе их не разрешает. Начинай с затронутого entry point, вызывающего кода и тестов, а не чтения всего репозитория. Используй rg с узким путём; исключай зависимости и build-артефакты. Для сложного изменения кратко зафиксируй границы и план; выполняй по одному проверяемому шагу. Не повторяй успешные проверки без изменения кода или новой причины. Реальную неоднозначность публичного контракта уточняй; обычные локальные решения принимай самостоятельно. Следуй стандартам языка, SOLID/DRY/KISS/YAGNI и текущим границам модулей. Сначала используй существующий механизм; не вводи новую абстракцию, зависимость, сервис или слой без конкретной необходимости. Сохраняй совместимость API и форматов; изменения схем/протоколов сопровождай миграцией и проверкой старых клиентов. Значимый архитектурный долг объясняй отдельно, без попутного переписывания проекта. Проверяй права на сервере, валидацию входа, таймауты, освобождение ресурсов и обработку ошибок; внешние побочные эффекты делай ограниченными и повторяемыми там, где это необходимо. Не читай и не печатай секреты, env, дампы и пользовательские данные без необходимости. Не меняй production, лицензии, исходное авторство или visibility репозитория попутно. Документацию сверяй с реализацией и выполняемым примером: README, типы и сигнатуры сами по себе не подтверждают поведение. Для библиотек EN + RU, продуктов RU + EN, исследований Axiom — RU. Не выдавай импортированный текст, проектное намерение или green build за полную проверку продукта. Перед завершением проверь свой diff, исполни подходящие тесты и проверки изменённого слоя. Для исправления поведения добавь регрессионный тест; для простого текста достаточно проверки ссылок/формата. В отчёте укажи результат, выполненные проверки и существенные ограничения; отличай локальную проверку, CI и production. ## Карта проекта и проверки Код и опорные каталоги: `src/`. Опорные файлы: `README.md`, `.github/CONTRIBUTING.md`. `composer.json`: localzet/console. Именованных test/lint/build-скриптов в проверенных JSON-манифестах нет. Перед запуском выбери существующую команду из CI, конфигурации тестов или Makefile; не выдавай предполагаемую команду за проверенную. Команды выше найдены в манифестах, а не проверены запуском. Перед выполнением прочитай их реализацию, нужные переменные и внешние зависимости. Не запускай нагрузочные, сетевые, deploy/migration-задачи или полный train как обычный smoke test. ### Ограничения реализации PHP: соблюдай PSR и ограничения PHP из composer.json; публичные namespace/сигнатуры и PSR-4 — контракт. Не редактируй vendor и сгенерированные классы. Проверяй nullability, исключения и совместимость зависимостей. ## Границы семейства Не смешивай парсинг аргументов, прикладную операцию и терминальный вывод. Сохраняй exit codes, stderr/stdout и неинтерактивный режим; опасные операции проверяй на временном каталоге.

localzet/console: работа с кодом

Семейство: PHP CLI. Общая принадлежность не разрешает перенос кода или публикацию закрытых компонентов.

Рабочий цикл

Общение — по-русски; комментарии в коде — краткие английские. Перед изменениями прочитай ближайшие вложенные AGENTS.md, проверь ветку, diff и индекс. Сохраняй чужой WIP; добавляй в commit только свои файлы/изменения. Коммиты — Conventional Commits, author и committer Ivan Zorin [email protected]. Push и deployment выполняй только в рамках текущего разрешения пользователя; этот файл сам по себе их не разрешает.

Начинай с затронутого entry point, вызывающего кода и тестов, а не чтения всего репозитория. Используй rg с узким путём; исключай зависимости и build-артефакты. Для сложного изменения кратко зафиксируй границы и план; выполняй по одному проверяемому шагу. Не повторяй успешные проверки без изменения кода или новой причины. Реальную неоднозначность публичного контракта уточняй; обычные локальные решения принимай самостоятельно.

Следуй стандартам языка, SOLID/DRY/KISS/YAGNI и текущим границам модулей. Сначала используй существующий механизм; не вводи новую абстракцию, зависимость, сервис или слой без конкретной необходимости. Сохраняй совместимость API и форматов; изменения схем/протоколов сопровождай миграцией и проверкой старых клиентов. Значимый архитектурный долг объясняй отдельно, без попутного переписывания проекта.

Проверяй права на сервере, валидацию входа, таймауты, освобождение ресурсов и обработку ошибок; внешние побочные эффекты делай ограниченными и повторяемыми там, где это необходимо. Не читай и не печатай секреты, env, дампы и пользовательские данные без необходимости. Не меняй production, лицензии, исходное авторство или visibility репозитория попутно.

Документацию сверяй с реализацией и выполняемым примером: README, типы и сигнатуры сами по себе не подтверждают поведение. Для библиотек EN + RU, продуктов RU + EN, исследований Axiom — RU. Не выдавай импортированный текст, проектное намерение или green build за полную проверку продукта.

Перед завершением проверь свой diff, исполни подходящие тесты и проверки изменённого слоя. Для исправления поведения добавь регрессионный тест; для простого текста достаточно проверки ссылок/формата. В отчёте укажи результат, выполненные проверки и существенные ограничения; отличай локальную проверку, CI и production.

Карта проекта и проверки

Код и опорные каталоги: src/.

Опорные файлы: README.md, .github/CONTRIBUTING.md.

composer.json: localzet/console.

Именованных test/lint/build-скриптов в проверенных JSON-манифестах нет. Перед запуском выбери существующую команду из CI, конфигурации тестов или Makefile; не выдавай предполагаемую команду за проверенную.

Команды выше найдены в манифестах, а не проверены запуском. Перед выполнением прочитай их реализацию, нужные переменные и внешние зависимости. Не запускай нагрузочные, сетевые, deploy/migration-задачи или полный train как обычный smoke test.

Ограничения реализации

PHP: соблюдай PSR и ограничения PHP из composer.json; публичные namespace/сигнатуры и PSR-4 — контракт. Не редактируй vendor и сгенерированные классы. Проверяй nullability, исключения и совместимость зависимостей.

Границы семейства

Не смешивай парсинг аргументов, прикладную операцию и терминальный вывод. Сохраняй exit codes, stderr/stdout и неинтерактивный режим; опасные операции проверяй на временном каталоге.