Модель
Видимый каталог в корне равен отдельной ответственности.
Здесь нет приватной карты инфраструктуры. Сайт описывает только назначение инструментов, границы ответственности и безопасные сценарии использования. Детальные пути, секреты, credentials и частные hostnames остаются вне публичной документации.
Каталог
Инструменты, адаптеры и референсы.
Каталог строится из открытого JSON-файла. Если в корне появляется новый видимый каталог, он должен получить понятное имя, бренд и описание.
Загружаю каталог…
Принципы
Порядок важнее количества.
Инструмент должен иметь имя, владельческую границу, понятные входы и проверяемый результат. Если каталог нужен только как пример чужого подхода, он остаётся референсом и не маскируется под наш production tooling.
- 01Корневой каталог обязан объяснять самостоятельную задачу.
- 02Общие ops-файлы живут в delivery, Codex-facing скрипты — в codex.
- 03Разовые gate/artifact каталоги не остаются в корне.
- 04Публичный сайт показывает назначение, но не раскрывает приватную инфраструктуру.
Публикация
Публичная документация остаётся публичной.
Можно
Назначение инструментов, типовые задачи, категории, брендинг, публичные принципы процесса и безопасные общие ограничения.
Нельзя
Секреты, credentials, приватные директории локальных машин, приватные hostnames, персональные данные и внутренние строки подключения.
Нужно
Держать сайт синхронным с корнем репозитория и явно помечать внешние reference-каталоги.
Процесс
Как меняется tools-контур.
Spec фиксирует требование до реализации: что меняется, почему это нужно, где границы и какие проверки доказывают результат.