Восстановление проекта SKUARO¶

Используйте этот документ после потери AI-чата, смены агента или аккаунта, нового clone или длительного перерыва.

Порядок реконструкции¶

Новый агент обязан:

Прочитать AGENTS.md.
Прочитать docs/PROJECT_POLICY.md.
Прочитать docs/PROJECT_CONTEXT.md.
Прочитать docs/INTEGRATIONS.md.
Прочитать docs/STATUS.md.
Прочитать docs/ARCHITECTURE.md и docs/IMPLEMENTATION_PLAN.md.
Прочитать docs/DOCUMENTATION_STRATEGY.md, если задача затрагивает документацию или релиз.
Прочитать индекс и актуальные решения в docs/decisions/.
Прочитать docs/AGENT_WORKFLOW.md, если восстанавливается межагентная или принятая после проверки задача.
Прочитать docs/AGENT_ROLES.md и проверить project-scoped профили, если используются subagents.
Прочитать docs/AGENT_MEMORY_AND_SKILLS.md и релевантные записи docs/agent-memory/ для повторяемой задачи.
Прочитать последний подходящий session log.
Проверить фактический корень и отсутствие лишней вложенной папки.
Проверить Git status, текущую ветку, последний commit и origin.
Проверить наличие обязательных файлов без раскрытия секретов.
Проверить реестр расширений и не устанавливать необязательные компоненты автоматически.
Составить расширенный отчёт до изменений.

Что агент должен восстановить¶

SKUARO — модульная бизнес-система с открытой функциональной границей; CRM, коммуникационные, AI и другие возможности разрешены по решению 0033.
«Сегодня» — UI-эталон и первый проверяемый сценарий; полный вертикальный backend ждёт результата пяти пользовательских проверок.
Целевой стек: React/TypeScript/Vite, Node.js 24/Fastify, PostgreSQL 18/Drizzle, pg-boss, Docker Compose.
Доменная цепочка: User -> Membership -> Organization -> Client -> Request -> NextAction.
Целевые тестовые домены: DEV dev.skuaro.top, developer docs dev-doc.skuaro.top, STAGE Site/App/user docs skuaro.top, lk.skuaro.top, doc.skuaro.top; production: skuaro.com, lk.skuaro.com, doc.skuaro.com. Фактическую миграцию всегда уточнять в docs/STATUS.md.
Формальная версия YY.MM.DD.NN относится только к продукту на lk.skuaro.com.
Product-репозиторий — webuzateam/SkuAro-DEV; Site и Docs согласованы отдельно, но их фактическое состояние уточняется в docs/STATUS.md.
Обязательные project Skills agent-learning и task-verification хранятся в .agents/skills; остальные расширения определяются реестром.
Шесть project-scoped профилей и лимит трёх subagents хранятся в .codex/; модели наследуются и отдельно не восстанавливаются.
Общая память повторяемого опыта хранится в docs/agent-memory/ и не заменяет канонические решения.
Независимая работа принимается только с доказательствами по docs/AGENT_WORKFLOW.md; сообщение исполнителя само по себе недостаточно.
Секреты восстанавливаются владельцем из [LOCAL_SECRET_STORE].

Отчёт реконструкции¶

Агент сообщает:

цель, аудиторию, границы и текущий этап;
последний завершённый шаг и текущую работу;
принятые и отложенные решения;
фактически реализованные части архитектуры;
риски и блокеры;
Git-состояние и состояние remote;
состояние обязательных расширений;
результат проверки secret-путей без значений;
первый безопасный следующий шаг.

Запрет до реконструкции¶

До готовности отчёта не редактировать файлы, не устанавливать зависимости, не выполнять commit, push, merge, deploy и другие внешние действия.

После отчёта продолжение работы подтверждает владелец проекта.

Секреты¶

AI не получает значения секретов. Владелец восстанавливает их из [LOCAL_SECRET_STORE] по карте docs/SECRETS.md. Агент не просматривает и не перечисляет содержимое внешней папки без отдельной явной задачи.

Проверка восстановления¶

Recovery drill проводится после крупных изменений структуры, стека, миграций или схемы хранения. Drill успешен, если новый агент без старого чата способен объяснить проект, назвать границы и решения, проверить Git, собрать доступные компоненты и предложить корректный следующий шаг, а владелец может восстановить секреты отдельно.

Дата и результат записываются в новый session log. Runtime drill дополнительно должен подтвердить migration и database restore после появления соответствующей инфраструктуры.