Imported from OleynikAleksandr/Project-Web-Pilot (AGENTS.md). Install upstream with npx skills add OleynikAleksandr/Project-Web-Pilot. Copyright stays with the author.

Project Workflow Kit

Общайся по-русски. При старте/возобновлении/compact используй доставленный recovery capsule; если его нет — ./scripts/workflow recover --format text.

Workflow Kit ведёт проекты любого типа. Единственный активный plan — .harness/plans/todo-plan.md. При NONE проект уже существует: используй docs/architecture/OVERVIEW.md, docs/MODULES.md и docs/DOCUMENTATION_INDEX.md и обсуждай с пользователем следующий этап.

Новый запрос сначала сопоставь с существующей частью проекта в docs/MODULES.md; если её нет — сначала создай и согласуй подходящий specification/planning document. Для программного модуля фиксируй facade, входы/выходы, границы и инварианты; внутреннюю реализацию дроби на узкие классы/микроклассы. Todo-plan реализует согласованный контракт.

Каждый рабочий scope обязан сохранять required-ссылки на docs/architecture/OVERVIEW.md, docs/MODULES.md и docs/DOCUMENTATION_INDEX.md и завершаться последней задачей DOCS — «Актуализация всех документов проекта». Только после её commit результат предъявляется пользователю на приёмку; приёмка не является задачей агента.

Machine-managed состояния меняются только командами Workflow Kit. Перед правкой начни task; каждую микрозадачу заверши workflow commit, не обходя hooks. Не удаляй и не откатывай посторонние изменения. Scope архивируется только по прямой команде пользователя; после archive новый NONE сохраняет навигацию проекта и не создаёт следующий рабочий scope.

Большой .harness/kit/WORKFLOW.md — reference manual для редких административных/аварийных случаев; читать его целиком в обычной сессии не требуется. Дополнительные документы бери через текущий plan/spec и docs/DOCUMENTATION_INDEX.md.

В Windows PowerShell/CMD используй ./scripts/workflow.cmd; в Git Bash/macOS — ./scripts/workflow.

Project Web Pilot — границы разработки

• Имя проекта выбрано пользователем: Project Web Pilot. Рабочий корень — /Users/oleksandroliinyk/VSCODE/Project Web Pilot.

• Идея уже обсуждена. Сначала прочитай docs/WORKFLOW_START.md, docs/PRODUCT.md, docs/DECISIONS.md и текущий recovery packet. Не предлагай заново внешний Chrome: пользователь выбрал встроенный Chromium в одном окне со своим левым сайдбаром.

• Документальная подготовка T001–T003 завершена. 11.09.2026 пользователь новой сессии прямо поручил продолжать до сборки первого тестируемого прототипа. Реализация T004 и последующих задач авторизована; не запрашивать её повторно. Текущие статусы читать из плана. При одном восстановлении контекста в будущей сессии не придумывать новый scope.

• Версия 0.1 проверена на WF001. По новому поручению T014–T017 полный контекст передаёт приложение первым сообщением; агент кратко подтверждает восстановление и описывает проект без обязательных recover/ACK вызовов. Контракт обновлён в docs/CONTEXT_DELIVERY.md. Канонический контракт — docs/CONTEXT_DELIVERY.md; архитектура — docs/architecture/ARCHITECTURE.md.

• По поручению T018–T020 workspace хранит список сессий. Двойной клик раскрывает дерево, дочерняя строка открывает конкретный чат; новый чат добавляется без замены прежних. Формат хранения мигрирует с резервной копией.

• Модель работает через веб-аккаунт ChatGPT. Не добавляй модельные API-вызовы и второго кодирующего агента. Транспортный tunnel и локальный MCP — существующая основа.

• Источники для чтения: /Users/oleksandroliinyk/VSCODE/WF001 и /Users/oleksandroliinyk/VSCODE/Codex Local Mac. Точные файлы и SHA — docs/SOURCE_WORKSPACES.md. Пользователь разрешил изменить Codex Local Mac для очистки hook/ACK диагностики и прямой передачи контекста; WF001 не менять; не переносить ключи, browser profiles и runtime-состояние.

• Переключение workspace не меняет cwd уже работающего чата. Все локальные действия привязаны к явной папке. Открытие сессии инициирует доставку полного пакета приложением; не добавлять экспериментальные проверки hooks в пользовательский ответ.

• Успех определяют полный пакет в реальном первом сообщении и короткий ответ агента о выбранном проекте. Сайдбар подтверждает передачу сообщения. Машинный ACK не используется; сборка и HTTP отдельно не являются пользовательской приёмкой.

• Профиль DEVELOPMENT и verification_ids уже настроены управляемо. Реальные проверки: актуальный Node suite и Electron smoke; smoke использует TEST FIXTURE; реальный первый ответ проверяется отдельно. Проверять назначенные команды перед commit; пустые либо не запущенные checks не означают успех.

• После каждого этапа обновлять связанные документы и единственный активный план управляемыми командами. Не создавать параллельный TODO.md. Новые пути сначала включать в план. Сборка и локальные проверки не заменяют пользовательский результат.

• Создание нового workspace и подключение существующего разрешены пользователем и реализованы через встроенный исходный Workflow Kit. Канонический контракт — docs/WORKSPACE_SETUP.md; перед новым изменением этого поведения прочитать его. Исходный WF001 остаётся отдельным проектом только для чтения.

• Архивирование workspace, возврат и удаление локальной папки реализованы в T025–T028 по поручению пользователя. Канонический контракт — docs/PROJECT_ARCHIVE.md. Архив приложения не меняет execution_scope_status. Облачные чаты удалять не разрешено. Физическое удаление реального проекта требует его явного выбора и подтверждения в интерфейсе; автоматические проверки удаляют только собственные временные fixtures.

• В 0.6.20 добавлен автономный Доктор проекта: docs/modules/project-doctor.md. 16.09.2026 пользователь реально запустил его на текущем проекте; .harness/kit-manifest.json успешно reconciled до Workflow Kit 1.3.0. Намеренно возвращать stale-состояние нельзя; дальнейшие сценарии повреждения проверяются только на временных fixtures.