Перейти к содержанию

0001 — Правила и структура проекта SKUARO

  • Дата: 2026-08-18.
  • Статус: Частично заменено; отсрочка архитектуры заменена решением 0004, правило репозиториев уточнено решением 0007, продуктовая граница заменена решением 0033.
  • Ответственный: владелец проекта.

Контекст

Проект SKUARO создан из AI Project Starter Kit. До начала обычной работы требовалось зафиксировать позиционирование, границы, память проекта, языки, автономность AI, Git, безопасность и восстановление без преждевременного выбора технологического стека.

Решение

  • SKUARO развивается как модульный SaaS и контур контроля клиентской работы для владельца малого бизнеса.
  • Исторически продукт не позиционировался как CRM; актуальное решение 0033 снимает это ограничение и разрешает любые необходимые функции.
  • Источники истины находятся в канонических файлах проекта; чат остаётся временным контекстом.
  • Интерфейс MVP и документация ведутся на русском, код и идентификаторы — на английском; английская локализация предусматривается позже.
  • До определения первого модуля, пользовательского сценария и модели данных разрешены исследования, спецификация, UX и независимые прототипы; постоянный production-каркас отложен.
  • Обязательных расширений сейчас нет.
  • Используется приватный репозиторий webuzateam/SkuAro-DEV с ветками DEV, STAGE, PROD.
  • Секреты исключаются из Git, файл от 50 MiB требует решения владельца.
  • закрываем сессию разрешает безопасный commit и push текущей ветки, но не merge, продвижение или deploy.
  • Итоговые отчёты имеют расширенный формат.

Причины

Решение сохраняет узкий фокус MVP, позволяет продолжать продуктовую работу без выдуманной архитектуры и обеспечивает передачу контекста другому агенту. Отдельные разрешения на рискованные действия сохраняют контроль владельца.

Последствия

Положительные:

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

Ограничения:

  • постоянная реализация первого модуля ждёт архитектурного решения;
  • продвижение в STAGE и PROD требует отдельной команды;
  • реальная работа с клиентскими данными требует дополнительной проверки безопасности и правовых требований.

Откат или замена

Правила изменяются командой ИЗМЕНИТЬ ПРАВИЛА ПРОЕКТА. Существенная замена оформляется новым решением, а этот документ получает статус Заменено со ссылкой.

Последующие решения

2026-08-21 решения 0004–0008 зафиксировали целевую архитектуру, доменную модель, среды, репозитории и продуктовый валидационный шлюз. Историческая причина первоначальной отсрочки сохраняется в этом документе, но больше не описывает текущее состояние.