architect/standards/PROJECT_STANDARD.md

PROJECT_STANDARD — Стандарт файлов любого проекта

Версия: 1.0.0
Дата: 2026-03-06

1. Проект = папка с @

Любой проект — папка начинается с @.
Подпроект — тоже проект, те же правила.

@lideravto/
@pirotehnika/
  @lideravto-it/        ← подпроект = тот же стандарт

2. Три формы любого документа

ФАЙЛ.md              ← ЭТАЛОН. Резюме. Истина проекта.
ФАЙЛ-подтема.md      ← Расширение одной подтемы
ФАЙЛ/                ← Папка: таблицы, схемы, детали, любые файлы

Правила:
- Если есть ФАЙЛ-подтема.md или ФАЙЛ/ — обязан существовать ФАЙЛ.md
- ФАЙЛ.md = резюме и ссылки на детали, всегда актуален
- Если доп. документ стал эталоном — указать это в основном ФАЙЛ.md
- Внутри ФАЙЛ/ — любые файлы без ограничений по именованию

3. Корень любого проекта

Обязательные файлы в корне — всегда, в любом проекте:

@project/
├── INDEX.md         ← навигация: что где лежит
├── AI.md            ← контекст для ИИ (эталон)
├── CLAUDE.md        ← инструкции для Claude (из AI.md)
├── STATUS.md        ← файл исполнения: где стоим, что делаем
├── LOG.md           ← файл лога: история решений
├── [файлы по типу проекта]
└── arh/             ← архив ненужного

INDEX.md

Навигация по проекту. Что есть, где лежит, как читать.

AI.md

Контекст для любого ИИ-инструмента:
- что это за проект (1–2 абзаца)
- текущее состояние
- ключевые решения и ограничения
- важные файлы и пути
- главные термины

CLAUDE.md

Формируется из AI.md + добавляются:
- триггеры и режимы работы
- команды и протоколы
- специфика Claude Code

Если уровень простой → только CLAUDE.md.
Если нужна совместимость с другими ИИ → оба файла.

STATUS.md — файл исполнения

Обновляется при каждом изменении состояния.

LOG.md — файл лога

YYYY-MM-DD — что решили / что изменили / почему

Только пополняется. Никогда не редактируется ранее написанное.

4. Типы проектов и их документы

Тип проекта определяет набор обязательных файлов.

5. Допустимые имена файлов

Файл может называться только именем из этого списка.
Файл с другим именем — не создаётся.

Базовые (все типы):

Имя Тип Что внутри
INDEX.md навигация что где лежит
AI.md ИИ-контекст контекст для любого ИИ
CLAUDE.md ИИ-инструкции инструкции для Claude
STATUS.md исполнение стадия, прогресс, блокеры
LOG.md лог история решений и изменений
GLOSSARY.md термины определения

Типовые (по классу проекта):

Имя Класс Что внутри
BRIEF.md biz, ops, hr, fin, mkt, rd, phys зачем, для кого, контекст
CONCEPT.md biz, mkt что делаем, ценность
REQUIREMENTS.md biz, ops, hr, fin, mkt, phys что должно быть реализовано
STRUCTURE.md org кто, роли, ответственности
PROCESSES.md org, ops регламенты, как работаем
DESIGN.md it, rd архитектура, как устроено
GUIDE.md it, ops, hr, fin, rd, phys как делать
README.md it, module как запустить (для кода)
LAUNCH.md it, phys как задеплоить / сдать
PRODUCT.md biz/product ассортиментная политика
PRICES.md biz/channel, biz/pricing ценообразование, прайс-листы
CHANNELS.md biz/channel каналы продаж и их специфика
ANALYTICS.md biz KPI, метрики, отчёты

Расширения: ИМЯ-подтема.md — допустимо для любого из списка.

6. Правила именования

Ситуация Решение
Нужна подтема DESIGN-catalog.md
Нужны детали, таблицы, схемы папка DESIGN/
Файл не из списка → не создавать, влить в существующий
Нужно сохранить исследование → в папку тематического файла
Файл устарел → arh/

7. Декомпозиция длинных файлов

Файл вырос → добавить ## секции внутри
Секция > 100 строк → вынести в ФАЙЛ-подтема.md
Подтем 3+ → создать папку ФАЙЛ/ с INDEX.md внутри

Термины:
- Секция — ## раздел внутри файла
- Расширение — ФАЙЛ-подтема.md
- Разбивка — папка ФАЙЛ/ вместо файла

8. Жизненный цикл файла

ACTIVE   → актуальный, используется
FROZEN   → завершён, не меняется (пометить # FROZEN вверху)
ARCHIVED → arh/ (хранится 1 стадию проекта)
DELETED  → после 1 стадии в arh/

9. Уровни и ИИ-файлы

Уровень AI.md CLAUDE.md
Workspace — ✅ корневой
Project ✅ ✅
Subproject ✅ по необходимости
Site / Module — —

10. Одно правило на всё

Файл = эталон и резюме темы.
Детали = в папке с тем же именем.
Подтема = ФАЙЛ-подтема.md.
Всё вне стандарта = не создаётся.

Пример: полная структура проекта

@biz-lideravto/                ← BIZ-проект
├── INDEX.md
├── AI.md
├── CLAUDE.md
├── STATUS.md
├── LOG.md
├── BRIEF.md
├── CONCEPT.md
├── REQUIREMENTS.md
│
└── @it-site-lideravto-ru/     ← IT-подпроект (те же правила)
    ├── INDEX.md
    ├── AI.md
    ├── STATUS.md
    ├── DESIGN.md
    ├── DESIGN-catalog.md      ← расширение темы
    ├── DESIGN/                ← детали
    │   ├── schema.png
    │   └── taxonomy.csv
    ├── GUIDE-import.md
    ├── README.md
    ├── LAUNCH.md
    └── arh/

Связи

Обновлено: 2026-03-06