Навигация и правила проекта

Проект организован с использованием концепции OKF (Open Knowledge Format). Все файлы представлены в формате Markdown и содержат YAML frontmatter для классификации контента.

1. Структура директорий и файлов

Полная карта файлов и навигация — в index (единый источник, здесь не дублируется).

Назначение ключевых файлов по ролям: - 00_… — паспорт проекта (цели, метрики, текущий фокус). - 02_Решения.md — реестр принятых решений. - 03_Задачи.md — единый файл задач: статус-дашборд по блокам + детали (оркестратор, читается первым). - 05_Логика_проекта.md — бизнес-взаимосвязи системы. - 06_Открытые_вопросы.md — нерешённые вопросы к обсуждению. - 5X_<ИИ>.md — журналы работы ИИ.

2. Правила ведения и актуализации (Maintenance Rules)

КРИТИЧНО ДЛЯ ИИ-АГЕНТОВ И РАЗРАБОТЧИКОВ: В проекте поддерживается два стартовых файла, которые несут разные функции. При внесении изменений в проект необходимо актуализировать их оба: 1. index.md (Навигация) — Любое добавление, удаление или перемещение файлов в корневой директории должно отражаться здесь. 2. 00_Система отчетов и дашбордов для Глеба.md (Паспорт проекта) — Изменения стратегических целей, метрик и глобальных приоритетов. Оперативный статус задач здесь НЕ дублируется — он ведётся только в таблице 03_Задачи.md. 3. 07_Справочники_классификаторы.md (Константы) — Единый источник повторяющихся значений (каналы, цены/скидки, категории, статусы складов, бренды). В прочих файлах значения не дублируются — только ссылка сюда.

2.1 Правила работы с тяжёлыми файлами (xlsx, pdf, zip, pptx, docx)

Тяжёлые файлы никогда не хранятся локально в папке проекта и не коммитятся в git. Классификация — по типу файла, не по размеру.

Алгоритм создания нового файла: 1. Создать файл (скриптом или вручную) 2. Загрузить на GDrive: rclone copyto "<файл>" "gdrive:Project/AGT Аналитика/Система отчетов и дашбордов для Глеба/docs/<файл>" 3. Установить публичный доступ: rclone link "gdrive:Project/AGT Аналитика/Система отчетов и дашбордов для Глеба/docs/<файл>" — сохранить полученную ссылку 4. Создать MD-карточку docs/<то же имя>.md по шаблону из HEAVY_FILES 5. Добавить строку в таблицу HEAVY_FILES 6. Локальный файл удалить

Алгоритм обновления файла: 1. Пересоздать через генератор 2. rclone copyto — перезаписать на GDrive (ссылка и ID остаются теми же) 3. Обновить поле updated в MD-карточке и строку в HEAVY_FILES 4. Локальный файл удалить

Что НЕ нужно: - Загружать MD-карточки на GDrive (они легкие, живут в git) - Хранить xlsx локально даже временно после загрузки

2.2 Правила взаимодействия с пользователем (Дмитрий)

1. Код в чат не пишем без подтверждения. Скрипты создаются/запускаются как действие (файл, генерация Excel), а не печатаются в ответе. Готовый код — по явному запросу.
2. Отвечаем по делу, экономим токены. Без воды, без перечисления отвергнутых вариантов. Готов — говорим прямо.
3. Фиксация по команде. Файлы проекта (02/03) обновляются по команде «зафиксируй», а не на каждую реплику.

3. Правила ведения диалогов для ИИ

1. Хронология строго сверху вниз — новые блоки итераций добавляются в конец своего файла диалога (например, 52_Gemini.md).
2. Блок-заголовок — формат записей: ## Имя ИИ ДД.ММ.ГГГГ ЧЧ:ММ.
3. Изолированность логов — текст других участников (в т.ч. других ИИ) не редактировать никогда. Запрещено писать в чужие файлы диалогов (например, Gemini не трогает файл Claude).
4. Часовой пояс — Санкт-Петербург, UTC+3.
5. Чужие журналы диалогов не читать без явной необходимости. Для восстановления контекста проекта достаточно 00_…, 01_SYSTEM_GUIDE.md, 02_Решения.md, 03_Задачи.md, 05_Логика_проекта.md, 06_Открытые_вопросы.md, 07_Справочники_классификаторы.md. Файлы 5X_<ИИ>.md и История общения/** — черновые логи конкретного агента для его же будущих сессий, а не источник актуального состояния проекта; читать их только по прямому запросу пользователя.

4. Порядок финализации и фиксации результатов

Команды: - «зафиксируй» / «подведи итоги» — промежуточная фиксация. - «зафиксируй и закрываем» — итоговая фиксация сессии. ИИ обязан проанализировать текущий диалог и распределить информацию по файлам проекта строго по протоколу.

Алгоритм фиксации: 1. Проанализировать диалог: что обсуждалось, что решено, что осталось открытым. 2. Обновить 03_Задачи.md — единый файл задач: статус-дашборд по блокам (вверху) + статусы/детали задач ([ ] сделать, [>] в работе, [x] готово). 3. Обновить 02_Решения.md — зафиксировать новые утверждённые решения. Формат: Дата | Кто | Проблема | Решение | Почему. 4. Обновить 06_Открытые_вопросы.md — добавить новые / закрыть решённые вопросы. 5. Обновить 00_… — блок «Текущий фокус» (если применимо). 6. Дописать итоги в свой лог-файл диалога (5X_<ИИ>.md).

🚨 Правило единой структуры: Нумерация и названия блоков/задач — сквозные (Блок N → задачи N.1, N.2 …) и ведутся в одном файле 03_Задачи.md (статус-дашборд + детали). Ссылки на задачи в 02_Решения.md и 05_Логика_проекта.md обязаны использовать те же номера. При добавлении блока/задачи обновляем 03 и синхронизируем ссылки.