ИИ и разработчику: карта работы

Техническая точка входа для работы в /home/aleksey/projects/android. Пользовательские инструкции находятся в отдельном разделе. Эта страница маршрутизирует к каноническим источникам; она не заменяет ближайший AGENTS.md, текущую задачу и фактическое состояние приложения.

Для машинного поиска входных страниц доступен компактный индекс llms.txt. Он содержит ссылки, а не отдельную копию правил.

Начало сессии

1. Определить app root и прочитать цепочку AGENTS.md, workspace README, локальный README и текущую запись проверки приложения.
2. Проверить дерево изменений. В корне workspace общего Git нет; не создавать его автоматически и не приписывать себе чужую работу.
3. Зафиксировать один результат, границу изменений, владельцев ресурсов и проверку, которая докажет готовность.
4. Выбрать маршрут из таблицы. Сначала локальные факты, затем минимальная диагностика; история успешной сборки не доказывает состояние текущего дерева.

Маршруты

Задача	Читать	Исполняемый вход
Новое native-приложение	Паспорт и выбор stack, шаблон	npm run apk:new -- --name <app> --package-id <id>
Приложение из PWA	Подготовка Capacitor	npm run apk:pwa-check -- <app> после создания оболочки
Сборка и доработка	Цикл APK	npm run apk:iterate -- <app> --lane native или --lane capacitor
Среда Android	Linux setup, workspace promt.md	npm run android:doctor
Стандарты агента	Workflow, шаблон AGENTS	Ближайший AGENTS.md и project verify
Skills и hooks	Android plugin	Source в codex/plugins/android-development
Evidence и продолжение	Контракт, ledger	bash scripts/automation/evidence-check.sh --phase-b-contract
Тестовый APK	Реестр и публикация	releases/test-builds.json, затем verify и publish
Магазины и подпись	Release runbook, policy preflight	Отдельный release scope, без догадок о юридических фактах

Все npm run apk:* выше вызываются из workspace root. Команды приложения выполняются из его root и его средой. Новый PWA-проект не копирует SDK/cache Arcade; новый native-проект не наследует evidence шаблона.

Контракт итерации

outcome: одно наблюдаемое изменение
app_root / lane: конкретный проект и native или capacitor
reproduction: шаги исходной ошибки или сценарий новой функции
gate: целевая проверка, полный verify и применимые device-сценарии
owners: один writer для исходников, cache, device и evidence
result: точная команда, exit status, identity исходников и артефактов
residual: что не проверено и почему
next_action: одна конкретная следующая команда или недостающий факт владельца

При ошибке сначала классифицировать её как CODE, TEST, ENVIRONMENT, BASELINE, TRANSIENT, POLICY или OWNER. Менять гипотезу на основании новых данных. Третий одинаковый сбой без новых данных завершает повторения, а не открывает ещё один круг очистки кеша и переустановки SDK.

Границы автоматизации

• Быстрая сборка, полный verify, device smoke и публикация — отдельные результаты.
• Устройство выбирается явно. Удаление приложения, очистка данных и AVD wipe требуют точного разрешённого target; подключённый телефон не считается расходной средой.
• Подпись, права на контент и декларации данных не выводятся из имени проекта.
• Hook — дополнительная проверка, а не доказательство полномочий или готовности.
• Установка plugin и доверие его hooks — отдельные состояния; после обновления проверить новую сессию и не заявлять live validation по fixture-тестам.

Изменение документации

Пользовательские страницы объясняют действие и ожидаемый результат простыми словами. Команды, контракты и диагностика живут в технических разделах и связаны с ними ссылками. Общие факты хранятся в одном источнике, старые URL сохраняются. Незнакомые термины сначала объясняются в словаре.

Источники сайта — docs/; генерируемые страницы шаблона и каталога правятся через исходники template/реестр. При изменении сайта: npm run verify, browser smoke, публикация штатной командой и проверка публичных страниц. Полная процедура и откат описаны в инструкции сайта.