Перейти к содержимому

Как внести вклад

Каталог растёт плагинами. Если вы хотите добавить плагин или поправить существующий, начните с правил разработки: они лежат рядом с кодом и проверяются валидаторами.

  1. Форкните репозиторий и создайте ветку от develop.
  2. Прочитайте устройство того, что правите: skill, агент, команда, мод.
  3. Внесите изменение и синхронизируйте всё, что нужно: Добавить плагин, Версии.
  4. Прогоните проверки.
  5. Откройте Pull Request в develop: Pull Request.

Нормативные тексты лежат в репозитории, а не на этом сайте: сайт их пересказывает и ведёт к первоисточнику.

Документ О чём
CLAUDE.md Как писать плагины, ревьюить и проверять перед коммитом
plugin-changes.md Версии (semver), обязательные синхронизации, гейт перед коммитом
docs-changes.md Правки документации
terminology.md Заведённые имена; значения - в словаре
VALIDATOR_RULES.md Реестр правил валидаторов: что ловит каждое
BRD, конституция Ценность и инварианты каталога

Остальные документы раздела docs/ (корпус, карта процесса разработки, стандарты, конвейеры) перечислены в README репозитория. В установленный плагин они не входят: это правила для авторов, а не рантайм.

Принципы, которые стоит знать до первой правки

Заголовок раздела «Принципы, которые стоит знать до первой правки»
  • Skill - ловушки, а не документация. Если «убрать имена проекта - правило всё ещё читается», оно обобщено верно.
  • Агент описывается фазами-контрактами, а не процедурами: цель, результат, критерий завершения.
  • Один факт - один дом. Правило не копируется, а даётся ссылкой на дом.
  • Тексты артефактов пишутся для модели: сухо и по делу, без пересказа.